Passer au contenu principal

​
Tutoriel : Connexion de Grafana à Insights

Ce guide vous aide à commencer à utiliser Grafana avec Insights. Une fois la connexion établie, vous pouvez utiliser Grafana pour exécuter des systèmes d’analytique et de surveillance sur les données de votre jeu issues d’Insights. Pour en savoir plus sur les autres outils auxquels vous pouvez connecter Insights, consultez Connexion d’outils externes à Insights. Dans ce tutoriel, vous allez apprendre à :
[!div class=“checklist”] * Configurer Grafana pour Insights * Créer une source de données dans Grafana * Créer un tableau de bord dans Grafana * Exécuter des requêtes et des commandes Kusto à l’aide du tableau de bord
PlayFab Insights Management a été mis hors service le 31/03/2026. Nous vous recommandons d’utiliser les connexions Azure Data Explorer (ADX) pour gérer vos performances et vos coûts à l’avenir. Si votre titre utilise toujours Insights, continuez à consulter cet article pour les détails d’implémentation. Pour plus d’informations, consultez PlayFab Digest: March feature updates.

​
Prérequis

​
Compte PlayFab authentifié avec Microsoft Entra ID

Vous avez besoin d’un compte ou d’un utilisateur PlayFab dont le fournisseur d’authentification est défini sur Microsoft. Le fournisseur d’authentification Microsoft utilise Microsoft Entra ID (anciennement Azure Active Directory (AAD)) pour l’authentification, ce qui est nécessaire pour utiliser les services Azure. Consultez Authentification Azure Active Directory pour Game Manager pour obtenir des instructions sur la création d’un compte ou d’un utilisateur authentifié par Microsoft Entra ID. Pour vérifier que le compte, ou l’utilisateur, est configuré pour utiliser le fournisseur d’authentification Microsoft :
  • Rendez-vous sur developer.playfab.com.
  • Sélectionnez Sign in with Microsoft pour accéder à votre compte PlayFab.
Si vous parvenez à vous connecter, le compte est configuré pour utiliser le fournisseur d’authentification Microsoft.

​
Autorisations Game Manager pour Insights

Vous devez attribuer à votre compte un rôle d’utilisateur avec les autorisations Game Manager suivantes activées :
  • Statut d’administrateur.
  • Accès à l’onglet Explorer et aux données associées.
  • Accès en lecture et en écriture aux données Analytics.
Vous pouvez créer un nouveau rôle d’utilisateur ou ajouter ces autorisations à un rôle existant.

​
Autres prérequis

​
Configurer Grafana

  1. Il existe deux façons d’obtenir Grafana. Vous pouvez créer un compte gratuit et télécharger Grafana pour l’exécuter sur votre ordinateur. Ou, si vous disposez d’un abonnement payant à Grafana Cloud, vous pouvez utiliser votre instance hébergée en ligne.
  2. Installez le plug-in Azure Data Explorer pour Grafana.

​
Créer une source de données dans Grafana

Maintenant que la base de données de votre titre est liée à une application Azure, vous pouvez utiliser cette application pour vous connecter à Grafana. Pour créer une source de données :
  1. Connectez-vous à Grafana.
  2. Sur la page Welcome to Grafana, sélectionnez Add data source.
  3. Sur la page Add Datasource, sélectionnez Azure Data Explorer Datasource. Vous pouvez la rechercher à l’aide de la barre de recherche ou la trouver dans la section Others. Si l’option Azure Data Explorer Datasource n’apparaît pas, vous devez installer le plug-in Azure Data Explorer Datasource For Grafana. Ajout d'une source de données Grafana
  4. Sur la page de configuration Azure Data Explorer Datasource :
    • Pour Cluster URL, entrez le point de terminaison de l’API PlayFab, qui est https://insights.playfab.com.
    • Entrez le Tenant Id, le Client Id et le Client secret de votre application Microsoft Entra ID dans les champs correspondants.
    • Sélectionnez Save & Test. Un message de retour Connection Successful doit s’afficher.
    • Dans Default Database, sélectionnez votre ID de titre ou le nom de votre base de données. Ce champ est automatiquement renseigné une fois que vous avez enregistré et testé la source de données avec succès. S’il n’apparaît pas après une connexion réussie, essayez de quitter puis de rouvrir la page de configuration. Configuration de la source de données Grafana

​
Créer un tableau de bord

À partir de la page d’accueil de Grafana, nous allons créer un nouveau tableau de bord. Pour créer un tableau de bord :
  1. Sélectionnez New dashboard. Nouveau tableau de bord Grafana
  2. Dans la boîte de dialogue New Panel, sélectionnez Add Query. Nouveau panneau Grafana
  3. Dans le panneau Query, à côté de Database, sélectionnez votre base de données dans le menu déroulant. Dans cet exemple, le nom de la base de données est Unicorn Battle. Nouvelle requête Grafana

​
Exécuter des requêtes et des commandes Kusto

Vous allez maintenant utiliser votre tableau de bord nouvellement créé pour exécuter des requêtes et des commandes Kusto sur votre base de données. Pour exécuter une requête :
  1. Dans le panneau Query, à côté de Format As, sélectionnez Table dans le menu déroulant. Format de table Grafana
  2. Utilisez les icônes de gauche pour basculer vers le panneau Visualization. Sélectionnez le menu déroulant à droite de Visualization, puis sélectionnez l’option Table. Visualisation sous forme de table Grafana
  3. Revenez à l’onglet Query. Entrez une requête et sélectionnez Run. Les résultats apparaissent dans la table au-dessus de l’onglet Query. Dans cet exemple, nous avons exécuté la requête ['events.all'] | limit 100. Exécution d'une requête Grafana L’exécution d’une commande Kusto suit le même processus. Entrez votre commande dans l’onglet Query et sélectionnez Run. Les résultats s’affichent au-dessus. Dans cet exemple, nous avons exécuté la commande .show tables. Exécution d'une commande Grafana

​
Autres ressources

Dernière modification le 6 octobre 2026

Sujets connexes

Connexion d'outils externes à InsightsConnexion de Python à InsightsConnexion de Kusto Explorer à InsightsConnexion de Power BI à InsightsInsights