​

Pratiques exemplaires et FAQ

​

Pratiques exemplaires

• Chaque niveau de performance comprend une certaine quantité de cache. Il est judicieux de calculer l’empreinte de données quotidienne et de décider combien de jours de données vous souhaitez conserver en cache. Une petite marge ou une empreinte de données bien connue permet à quiconque exécute des requêtes de savoir quand s’attendre à des performances optimales. Il est également recommandé d’exécuter les visualisations en fonction de ces performances prévues pour obtenir des résultats rapides.
  • Par exemple, un studio a une empreinte de données de 5 Go par jour. Sélectionner une taille de cache de 450+ permet de conserver 90 jours de données en cache. Exécuter toutes les visualisations sur une fenêtre glissante de 90 jours sera efficace. Les jointures, les unions et les requêtes avancées seront aussi efficaces. Une autre option serait de concentrer les visualisations en direct principalement sur des fenêtres de 30 jours et de régler la taille du cache à 90 jours pendant les heures de travail et à 30 jours en dehors des heures de travail. Cela permet de réaliser d’importantes économies. N’oubliez pas non plus que les données sont compressées dans le cache.
• Les plateformes de visualisation de données comme Power BI exécutent souvent plusieurs requêtes pour une seule visualisation. Il est recommandé de mettre à jour les visualisations en série. En cas de charge importante, ou si de nombreux utilisateurs s’en servent, il peut être judicieux d’augmenter le niveau de performance à un niveau qui autorise davantage de requêtes simultanées afin de libérer des requêtes simultanées pour les outils externes et les analystes.
• Le cas d’utilisation le plus courant de la mise à l’échelle planifiée consiste à augmenter les ressources pendant les heures de travail normales et à les réduire après les heures de travail et la fin de semaine. Si vous effectuez des changements importants de niveau de performance (par exemple, du niveau 3 au niveau 8), il est recommandé de prévoir de rester au niveau de performance supérieur pendant plusieurs heures. Charger et décharger rapidement des téraoctets de données du cache est une utilisation inefficace des ressources. Toutes les autres limites sont augmentées instantanément, vous pouvez donc choisir d’effectuer les changements de mise à l’échelle au besoin.
• La mise à l’échelle planifiée n’est pas incompatible avec la mise à l’échelle manuelle. Si vous constatez que vous avez besoin de plus de ressources au milieu de la journée, vous pouvez effectuer un changement manuel; la mise à l’échelle planifiée se poursuit comme prévu.
• La réduction du stockage des données peut entraîner une perte de données. Vous serez averti par le message « Selected retention setting is lower than current setting. Doing so may result in a loss of data. » lorsque vous tenterez de réduire le stockage. En raison du faible coût du stockage, une rétention à long terme est recommandée.
• Les commandes de gestion d’Insights permettent de créer et de mettre à jour des tables personnalisées. Pour les rapports principaux et les tables souvent utilisées, il est utile de créer des tables d’agrégation personnalisées. Les tables d’agrégation ont généralement une empreinte de données plus petite que les données sources. Cela améliore les performances des requêtes et réduit le besoin d’un niveau de performance plus élevé.
  • Pour automatiser l’agrégation des données, nous recommandons d’utiliser Azure Data Factory, une option d’automatisation peu coûteuse et évolutive. Pour plus d’information sur l’utilisation d’Azure Data Factory, consultez la section connectivité.
• Limiter les requêtes à l’aide de l’horodatage est une bonne pratique de gestion des données. Vous n’extrayez pas toutes les données des derniers jours d’un seul coup.

​

FAQ

​

Comment puis-je interroger les données?

1. La façon la plus simple est d’utiliser notre explorateur de données intégré.
2. La section connectivité présente d’autres façons d’accéder aux données.

​

J’ai envoyé un lien d’authentification Microsoft (avec Azure Active Directory) et cela n’a pas fonctionné. Que s’est-il passé?

• Si vous avez déjà un compte PlayFab, vous devez vous déconnecter avant d’accepter une invitation avec une méthode d’authentification différente.

​

Pourquoi est-ce que j’obtiens une erreur lorsque j’essaie de changer mon niveau de performance ou ma rétention des données?

1. Si vous n’êtes pas inscrit à un compte payant, la modification des niveaux de performance, de la rétention, des exportations et de certaines commandes de gestion ne sera pas disponible.
2. Si votre cluster Insights est en train de changer de niveau de performance, vous devez attendre la fin du changement.

​

Puis-je passer d’un niveau de performance gratuit à un niveau payant et inversement?

• Bien sûr! Vous pouvez revenir au niveau gratuit si vous n’avez actuellement besoin d’aucune des fonctionnalités payantes.

​

Comment puis-je faire entrer des données dans mon cluster Insights?

1. La plupart des services PlayFab génèrent automatiquement des données pour vous.
2. Vous pouvez aussi implémenter votre propre télémétrie par l’intermédiaire de PlayStream ou de notre système Telemetry.
3. Vous pouvez utiliser les commandes de gestion pour ingérer des jeux de données personnalisés.

​

Quel est le schéma de données standard des événements PlayFab?

• Dans PlayFab Insights, nous chargeons toutes les données de tous les événements dans une seule table. Cette table se nomme [‘events.all’]. Dans cette table, vous verrez une colonne appelée « EventData » qui contient la charge utile d’information JSON de chaque événement. Pour obtenir de l’information complète sur la table events.all, consultez À propos de la table events.all.

​

Pourquoi ne puis-je pas écrire du SQL?

• Pour le moment, nous prenons uniquement en charge les requêtes KQL (Kusto Query Language) dans la plupart des scénarios. Nous étudions activement l’ajout de la prise en charge de SQL. Bien que KQL demande un temps d’adaptation, nous pensons que vous l’apprécierez une fois habitué. Pour de l’information sur la conversion de requêtes SQL en requêtes Kusto, consultez SQL to Kusto query translation.

​

Quelle est la différence entre les événements par seconde de mon niveau de performance Insights et les coûts d’envoi des événements PlayStream?

• Les événements par seconde de votre niveau de performance Insights représentent l’ingestion de données dans votre cluster par quelque moyen que ce soit. Les événements d’écriture PlayStream et les événements de télémétrie d’écriture sont facturés séparément et représentent le coût d’écriture dans le nuage.

​

Puis-je avoir un niveau de performance plus élevé que ce que je vois sur ma page de gestion?

• Soumettez-nous un ticket de support et nous communiquerons avec vous pour convenir d’une solution qui répond à vos besoins.

​

Quelle est la technologie sous-jacente de PlayFab Insights?

• PlayFab Insights utilise une variante spécialisée d’Azure Data Explorer (Kusto).

​

Pourquoi mon schéma de données est-il différent lorsque j’exporte à l’aide de requêtes personnalisées?

• La sortie des requêtes personnalisées comprend des détails du processus ETL (extraction, transformation, chargement). Quelques colonnes supplémentaires sont incluses. Ces colonnes sont masquées dans l’environnement de requête, car elles n’y ont aucune utilité.

​

Que se passe-t-il si je réduis mon paramètre de rétention à un nombre de jours inférieur au nombre total de jours pour lesquels j’ai des données?

• Vous êtes averti que la réduction de votre rétention pourrait supprimer des données. Par exemple, si vous êtes en activité depuis un an et que vous réduisez la rétention à six mois, seuls les six mois de données les plus récents sont conservés; le reste est supprimé.

​

Comment puis-je augmenter le délai d’expiration de mes requêtes?

• Les limites de délai d’expiration des requêtes dépendent de la puissance de calcul définie par votre niveau de performance. Consultez le tableau de puissance de calcul dans Performances et rétention, sous puissance de calcul.

​

Y a-t-il une limite à la quantité de télémétrie que je peux envoyer?

• Les limites suivantes s’appliquent à l’appel d’API WriteTelemetryEvents :

  Nom de la limite	Valeur de la limite	Remarques
  Événements par requête	200 événements par requête	Le dépassement de cette limite entraîne une erreur BadRequest.
  Événements par entité	8 000 par seconde	Le dépassement de cette limite entraîne une erreur PerEntityEventRateLimitExceeded. Une entité représente le plus souvent un joueur individuel, mais peut aussi être un groupe de joueurs ou un titre.
  Taille maximale de la charge utile	10 240 octets (10 Ko)
  Si vous atteignez l’une de ces limites, communiquez avec l’équipe de support PlayFab pour obtenir de l’aide. Dans le coin supérieur droit de Game Manager, sélectionnez l’icône de point d’interrogation, puis sélectionnez Contact Us.

​

J’obtiens l’erreur « Query execution has exceeded the allowed limits » lorsque j’essaie d’exécuter une requête

• Cette erreur se produit lorsque la taille du jeu de résultats ou le nombre de lignes du jeu de résultats dépasse la limite autorisée. Essayez de limiter la quantité de données retournées en restreignant la requête aux données pertinentes à l’aide des opérateurs where, limit ou summarize
• Pour exporter toutes vos données, accédez à l’onglet Event Export sous Data dans la page Title Overview de PlayFab Game Manager.
• Si vous voulez extraire seulement des segments de données ou si vous atteignez toujours la limite de requête, vous pouvez partitionner les données par période ou par identifiant unique (p. ex. Player ID, Title ID) et exécuter plusieurs requêtes plus petites. Voici un exemple de partitionnement basé sur le temps :

let start = datetime(2020-08-03);
let end = datetime(2020-08-07);
['events.all'] | where Timestamp between(start .. end)

['events.all'] | limit 1000

['events.all'] | summarize count() by FullName_Name, bin(Timestamp, 1d)

• Consultez la documentation de Kusto pour plus d’information.

​

J’ai réglé les variables truncationmaxsize et truncationmaxrecords à une valeur plus grande, mais j’obtiens toujours une erreur

• PlayFab Insights ne prend actuellement pas en charge le réglage de ces variables. Consultez la section ci-dessus pour des conseils sur la formulation des requêtes.

​

L’interrogation des données Insights empêchera-t-elle l’ingestion des événements?

• Non. Les événements PlayFab seront acheminés vers la base de données de votre titre sans
• pénalité de performance.

​

Mes requêtes retournent l’erreur « Partial query failure: Low memory condition »

• Cela signifie que la requête est trop complexe et ne peut pas respecter les limites de mémoire de votre niveau de performance. Essayez de simplifier votre requête. Par exemple, un appel summarize peut comporter trop de groupes, ou vous essayez peut-être de traiter trop de lignes à la fois. Vous pouvez aussi passer à un niveau de performance supérieur pour permettre d’allouer davantage de mémoire à chaque requête.
• Consultez la documentation de Kusto pour plus d’information.

​

Est-ce que je perdrai des données si mon volume d’événements est supérieur à ce que permet mon niveau de performance?

• Non, mais les dépassements vous seront facturés. Les dépassements sont mesurés en nombre de crédits Insights consommés. Les prix des crédits Insights se trouvent sur PlayFab.com/Pricing.

​

Comment choisir mon niveau de performance?

• Le niveau de performance qui vous convient est déterminé par l’utilisation de votre titre. En augmentant le niveau de performance, vous aurez accès à plus de données en cache et à d’autres ressources de requête, ce qui accélérera l’exécution des requêtes. Pour plus d’information sur les niveaux de performance, consultez Niveaux de performance et rétention.

​

Comment accorder à un utilisateur des autorisations sur la page Data > Explorer pour un titre particulier?

• Suivez le guide Rôles d’utilisateur PlayFab pour accéder aux autorisations d’utilisateur, les créer et les accorder.
• Un utilisateur a besoin des 3 autorisations suivantes pour accéder à Data Explorer :
  • Explorer data & tab (autorisations de lecture et d’écriture)
  • Analytics data read access (autorisations de lecture)
  • Analytics data write access (autorisations d’écriture)