​

Bonnes pratiques et FAQ

​

Bonnes pratiques

• Chaque niveau de performances est fourni avec une certaine quantité de cache. Il est judicieux de calculer l’empreinte quotidienne de vos données 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 à toute personne exécutant des requêtes de savoir quand attendre des performances optimales. Il est également recommandé d’exécuter les visualisations en fonction de ces performances attendues pour obtenir des résultats rapides.
  • Par exemple, un studio a une empreinte de données de 5 Go / jour. Sélectionner une taille de cache de 450+ permet de conserver 90 jours de données en cache. L’exécution de toutes les visualisations sur une fenêtre glissante de 90 jours sera efficace. Les jointures, unions et requêtes avancées seront également efficaces. Une autre option consisterait à concentrer les visualisations en direct principalement sur des fenêtres de 30 jours et à définir une taille de cache allant jusqu’à 90 jours pendant les heures de travail et de 30 jours en dehors de celles-ci. 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 forte charge, ou d’utilisation par de nombreux utilisateurs, il peut être judicieux d’augmenter le niveau de performances vers un niveau autorisant 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’usage le plus courant de la mise à l’échelle planifiée consiste à augmenter les ressources pendant les heures de travail standard et à les réduire en dehors de ces heures et le week-end. Si vous apportez des changements importants au niveau de performances (par exemple, du niveau 3 au niveau 8), il est recommandé de prévoir de rester au niveau de performances supérieur pendant plusieurs heures. Charger et décharger rapidement des téraoctets de données du cache constitue une utilisation inefficace des ressources. Toutes les autres limites sont relevées instantanément ; vous pouvez donc choisir d’effectuer les changements de mise à l’échelle si nécessaire.
• La mise à l’échelle planifiée n’exclut pas la mise à l’échelle manuelle. Si vous avez besoin de davantage de ressources en milieu de journée, vous pouvez effectuer une modification manuelle ; 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. Lorsque vous tentez de réduire le stockage, l’avertissement « Selected retention setting is lower than current setting. Doing so may result in a loss of data. » s’affiche. 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 essentiels 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 faible que les données sources. Cela améliore les performances des requêtes et réduit la nécessité d’un niveau de performances plus élevé.
  • Pour automatiser l’agrégation des données, nous recommandons d’utiliser Azure Data Factory, une option d’automatisation évolutive et peu coûteuse. Pour plus d’informations 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 en une seule fois.

​

FAQ

​

Comment puis-je interroger les données ?

1. Le moyen le plus simple consiste à utiliser notre explorateur de données intégré.
2. La section connectivité détaille d’autres moyens 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 disposez déjà d’un compte PlayFab, vous devez vous déconnecter avant d’accepter une invitation avec une autre méthode d’authentification.

​

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

1. Si vous n’avez pas souscrit à un compte payant, la modification des niveaux de performances, de la rétention, les exportations et certaines commandes de gestion ne seront pas disponibles.
2. Si votre cluster Insights est en cours de changement de niveau de performances, vous devez attendre la fin de la modification.

​

Puis-je passer d’un niveau de performances 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 importer 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 également implémenter votre propre télémétrie via PlayStream ou 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 est nommée [‘events.all’]. Dans cette table, vous trouverez une colonne appelée « EventData » qui contient la charge utile d’informations JSON de chaque événement. Pour obtenir des informations complètes sur la table events.all, consultez À propos de la table events.all.

​

Pourquoi ne puis-je pas écrire de SQL ?

• Pour l’instant, nous ne prenons en charge que 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 plus d’informations sur la conversion de requêtes SQL en requêtes Kusto, consultez Traduction de requêtes SQL en Kusto.

​

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

• Les événements par seconde de votre niveau de performances Insights représentent l’ingestion de données dans votre cluster, quel que soit le moyen utilisé. 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 cloud.

​

Puis-je avoir un niveau de performances supérieur à ceux affichés sur ma page de gestion ?

• Créez un ticket de support et nous vous contacterons pour convenir d’une solution adaptée à 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 lors d’une exportation à l’aide de requêtes personnalisées ?

• La sortie des requêtes personnalisées inclut des détails issus du processus ETL (Extract Transform Load). Certaines colonnes supplémentaires sont incluses. Ces colonnes sont masquées dans l’environnement de requête, car elles ne servent à rien.

​

Que se passe-t-il si je réduis ma durée de rétention à un nombre de jours inférieur au nombre total de jours pour lesquels je dispose de données ?

• Vous êtes averti que la réduction de la rétention peut 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 derniers mois de données sont conservés ; le reste est supprimé.

​

Comment 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 performances. Reportez-vous au tableau de puissance de calcul dans Performances et rétention, sous puissance de calcul.

​

Existe-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, contactez l’équipe de support PlayFab pour obtenir de l’aide. Dans le coin supérieur droit de Game Manager, sélectionnez l’icône en forme 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 renvoyé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 souhaitez extraire uniquement 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 ID unique (par ex. Player ID, Title ID) et exécuter plusieurs requêtes plus petites. Voici un exemple de partitionnement en fonction du 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 Kusto pour plus d’informations.

​

J’ai défini les variables truncationmaxsize et truncationmaxrecords sur une valeur plus élevée, mais j’obtiens toujours une erreur

• PlayFab Insights ne prend actuellement pas en charge la définition de ces variables. Consultez les conseils de formulation de requêtes ci-dessus.

​

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

• Non. Les événements PlayFab continueront d’arriver dans la base de données de votre titre sans
• pénalité de performances.

​

Mes requêtes renvoient une erreur « Partial query failure: Low memory condition »

• Cela signifie que la requête est trop complexe et ne peut pas tenir dans les limites de mémoire de votre niveau de performances. 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 également passer à un niveau de performances supérieur afin d’allouer davantage de mémoire à chaque requête.
• Consultez la documentation Kusto pour plus d’informations.

​

Vais-je perdre des données si mon volume d’événements est supérieur à celui autorisé par mon niveau de performances ?

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

​

Comment choisir mon niveau de performances ?

• Le niveau de performances qui vous convient dépend surtout de l’utilisation de votre titre. En augmentant le niveau de performances, vous accédez à davantage de données en cache et à d’autres ressources de requête, ce qui accélère l’exécution des requêtes. Pour plus d’informations sur les niveaux de performances, consultez Niveaux de performances et rétention.

​

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

• Suivez le guide Rôles d’utilisateur PlayFab pour accéder aux autorisations utilisateur, les créer et les accorder.
• Un utilisateur a besoin des 3 autorisations suivantes pour accéder au 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)