> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connexion de Grafana à Insights

> Connectez Grafana à l'ancienne version de PlayFab Insights, ajoutez une source de données et créez des tableaux de bord qui exécutent des requêtes Kusto sur la télémétrie de votre jeu pour la surveillance et les alertes.

# 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](/fr/services/playfab/data-analytics/legacy/connectivity).

Dans ce tutoriel, vous allez apprendre à :

<Note>
  \[!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
</Note>

<Note>
  PlayFab Insights Management a été mis hors service le 31/03/2026. Nous vous recommandons d'utiliser les [connexions Azure Data Explorer (ADX)](/fr/services/playfab/data-analytics/export-data/data-connection-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](https://developer.microsoft.com/en-us/games/articles/2026/04/playfab-digest-march-feature-updates/).
</Note>

## 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](/fr/services/playfab/identity/dev-identity/authentication/aad-authentication) 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](https://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](/fr/services/playfab/identity/dev-identity/permissions/playfab-user-roles) 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

* [Créer une application Microsoft Entra ID et la connecter à la base de données de votre titre](/fr/services/playfab/data-analytics/legacy/connectivity/creating-AAD-app-for-insights)

## Configurer Grafana

1. Il existe deux façons d'obtenir Grafana. Vous pouvez [créer un compte gratuit](https://grafana.com/login) 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](https://grafana.com/grafana/plugins/grafana-azure-data-explorer-datasource) 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. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-add-datasource.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=308a78625124cecfa0190ffa2a6d902f" alt="Ajout d'une source de données Grafana" width="1465" height="615" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-add-datasource.png" />
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. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-datasource-configuration.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=7fe6afaa1c39f94ac85d74cddaab1fb3" alt="Configuration de la source de données Grafana" width="1586" height="707" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-datasource-configuration.png" />

## 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**. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-new-dashboard.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=ee1ccd38c312c481a7e6d1e3853814e3" alt="Nouveau tableau de bord Grafana" width="1534" height="333" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-new-dashboard.png" />
2. Dans la boîte de dialogue **New Panel**, sélectionnez **Add Query**. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-new-panel.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=0ce9eb2fe67f337040ec2ec4d003d3c5" alt="Nouveau panneau Grafana" width="829" height="503" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-new-panel.png" />
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**. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-new-query.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=6e1cc311d6f82ec40188249d889ac2f2" alt="Nouvelle requête Grafana" width="1623" height="549" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-new-query.png" />

## 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. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-table-format.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=15b7b1dc9f43ee66429f41189838af0e" alt="Format de table Grafana" width="2200" height="751" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-table-format.png" />
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**. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-table-visualization.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=3de1502c1bf2f8673833c3a2345be6e7" alt="Visualisation sous forme de table Grafana" width="2011" height="672" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-table-visualization.png" />
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`. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-run-query.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=fd1c90e47b834a11c7d7cb4c6e9c0540" alt="Exécution d'une requête Grafana" width="2253" height="1005" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-run-query.png" /> 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`. <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/grafana-run-command.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=8aa9b399068f41b749546d148fead7bc" alt="Exécution d'une commande Grafana" width="2254" height="1057" data-path="images/playfab/data-analytics/legacy/connectivity/grafana-run-command.png" />

## Autres ressources

* [Documentation de Grafana](https://grafana.com/docs/grafana/latest/)
* Pour en savoir plus sur les autres outils à connecter à Insights, consultez  [Connexion d'outils externes à Insights](/fr/services/playfab/data-analytics/legacy/connectivity).


## Related topics

- [Connexion d'outils externes à Insights](/fr/services/playfab/data-analytics/legacy/connectivity/index.md)
- [Connexion de Python à Insights](/fr/services/playfab/data-analytics/legacy/connectivity/connecting-python-to-insights.md)
- [Connexion de Kusto Explorer à Insights](/fr/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-explorer-to-insights.md)
- [Connexion de Power BI à Insights](/fr/services/playfab/data-analytics/legacy/connectivity/connecting-power-bi-to-insights.md)
- [Insights](/fr/services/playfab/data-analytics/legacy/insights/overview.md)
