Visualiser des données Azure Data Explorer dans Grafana

Grafana est une plateforme d’analytique où vous pouvez interroger et visualiser des données, puis créer et partager des tableaux de bord en fonction de vos visualisations. Grafana fournit un plug-in Azure Data Explorer, qui vous permet de vous connecter et de visualiser des données à partir d’Azure Data Explorer. Le plug-in fonctionne avec Azure Managed Grafana et Grafana auto-hébergé.

Dans cet article, vous allez apprendre à configurer votre cluster en tant que source de données pour Grafana et à visualiser des données dans Grafana pour Azure Managed Grafana et Grafana auto-hébergé. Pour suivre les exemples de cet article, ingérer les exemples de données StormEvents. L’exemple de jeu de données StormEvents contient des données météorologiques des Centres nationaux d’information environnementale.

Prérequis

• Pour Azure Managed Grafana, un compte Azure et Azure Managed Grafana instance.
• Pour Grafana auto-hébergé, Grafana version 5.3.0 ou ultérieure pour votre système d’exploitation et le plug-in Azure Data Explorer pour Grafana. Vous avez besoin d’un plug-in version 3.0.5 ou ultérieure pour utiliser le générateur de requêtes Grafana.
• Un cluster et une base de données Azure Data Explorer. Vous pouvez créer un cluster gratuit ou créer un cluster complet. Pour décider qui vous convient le mieux, case activée la comparaison des fonctionnalités.

Configurer la source de données

Pour configurer Azure Data Explorer en tant que source de données, suivez les étapes de votre environnement Grafana.

Grafana géré par Azure

Ajouter l’identité managée au rôle Visionneuse

Managed Grafana crée une identité managée affectée par le système pour chaque nouvel espace de travail, par défaut. Vous pouvez l’utiliser pour accéder à votre cluster Azure Data Explorer.

1. Dans le portail Azure, accédez à votre cluster Azure Data Explorer.

2. Dans la section Vue d’ensemble , sélectionnez la base de données contenant les exemples de données StormEvents .

   

3. Sélectionnez Autorisations>Ajouter une>visionneuse.

   

4. Dans la zone de recherche, entrez le nom de votre espace de travail Managed Grafana.

5. Dans les résultats de la recherche, sélectionnez le résultat qui correspond au nom de votre espace de travail, puis sélectionnez Sélectionner.

   

Configurer Azure Data Explorer en tant que source de données Grafana

Les espaces de travail Grafana managés sont fournis avec le plug-in Azure Data Explorer préinstallé.

1. Dans le Portail Azure, accédez à votre espace de travail Grafana managé.

2. Sous Vue d’ensemble, sélectionnez le lien Point de terminaison pour ouvrir l’interface utilisateur Grafana.

3. Dans Grafana, dans le menu de gauche, sélectionnez l’icône d’engrenage. Sélectionnez ensuite Sources de données.

   

4. Sélectionnez Source de données Azure Data Explorer.

   

5. Dans Détails de connexion, entrez l’URL de votre cluster Azure Data Explorer.

   

6. Sélectionnez Enregistrer et tester.

Grafana auto-hébergé

Créer un principal du service

Vous pouvez créer le principal de service dans le Portail Azure ou à l’aide de l’expérience de ligne de commande Azure CLI. Après avoir créé le principal de service, vous obtenez les valeurs de quatre propriétés de connexion que vous utiliserez dans les étapes ultérieures.

Portail Azure

1. Suivez les instructions de la documentation Portail Azure. Utilisez ces informations spécifiques :

   1. Dans la section Affecter l’application à un rôle, affectez le type de rôle Lecteur à votre cluster Azure Data Explorer.

   2. Dans la section Obtenir des valeurs pour la connexion, copiez les valeurs des trois propriétés couvertes dans les étapes suivantes : ID de répertoire (ID de locataire), ID d’application et Mot de passe.

2. Dans le portail Azure, sélectionnez Abonnements. Copiez ensuite l’ID de l’abonnement dans lequel vous avez créé le principal de service.

   

Azure CLI

1. Utilisez la commande suivante pour créer un principal de service. Définissez une étendue appropriée et le type de rôle reader.

   az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                            --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
   

   Pour plus d’informations, consultez Créer un principal de service Azure avec Azure CLI.

2. La commande retourne un jeu de résultats comme dans l’exemple suivant. Copiez les valeurs des appIdpropriétés , passwordet tenant .

   {
     "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "displayName": "{UrlToYourDashboard}:{PortNumber}",
     "name": "https://{UrlToYourDashboard}:{PortNumber}",
     "password": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
   }
   

3. Obtenez la liste de vos abonnements :

   az account list --output table
   

   Copiez l’ID d’abonnement approprié.

   

Ajouter le principal de service au rôle Visionneuse

Maintenant que vous disposez d’un principal de service, vous l’ajoutez au rôle Visionneuse dans la base de données Azure Data Explorer. Vous pouvez effectuer cette tâche sous Autorisations dans le portail Azure ou sous Requête en utilisant une commande de gestion.

Portail Azure : Autorisations

1. Dans le portail Azure, accédez à votre cluster Azure Data Explorer.

2. Dans la section Vue d’ensemble , sélectionnez la base de données contenant les exemples de données StormEvents.

   

3. Sélectionnez Autorisations>Ajouter.

   

4. Sous Ajouter des autorisations de base de données, sélectionnez le rôle Visionneuse , puis sélectionnez Sélectionner des principaux.

   

5. Recherchez le principal de service que vous avez créé. Sélectionnez le principal, puis sélectionnez Sélectionner.

   

6. Sélectionnez Enregistrer.

   

Commande de gestion : requête

1. Dans le Portail Azure, accédez à votre cluster Azure Data Explorer, puis sélectionnez Requête.

   

2. Exécutez la commande suivante dans la fenêtre de requête. Utilisez l’ID d’application et l’ID de locataire de l’Portail Azure ou d’Azure CLI.

   .add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
   

   La commande retourne un jeu de résultats. Dans l’exemple suivant, la première ligne concerne un utilisateur existant dans la base de données. La deuxième ligne concerne le principal de service que vous venez d’ajouter.

   

Spécifier des propriétés et tester la connexion

Avec le principal de service affecté au rôle Visionneuse, vous spécifiez maintenant des propriétés dans votre instance de Grafana et testez la connexion à Azure Data Explorer.

1. Dans Grafana, dans le menu de gauche, sélectionnez l’icône d’engrenage. Sélectionnez ensuite Sources de données.

   

2. Sélectionnez Ajouter une source de données.

3. Dans la page Sources de données/Nouvelle, entrez un nom pour la source de données, puis sélectionnez le type Azure Data Explorer Datasource.

   

4. Dans Paramètres>Détails de connexion, entrez le nom de votre cluster au format https://{ClusterName}.{Region}.kusto.windows.net. Entrez les autres valeurs du Portail Azure ou d’Azure CLI. Utilisez les informations de mappage suivantes comme guide.

   Interface utilisateur de Grafana	Portail Azure	Azure CLI
   ID d’abonnement	ID D’ABONNEMENT	SubscriptionId
   ID de locataire	ID du répertoire	tenant
   ID de client	ID d’application	appId
   Clé secrète client	Mot de passe	password

   

5. Sélectionnez Enregistrer et tester.

   Si le test est réussi, passez à la section suivante. Si vous rencontrez des problèmes, case activée les valeurs que vous avez spécifiées dans Grafana et passez en revue les étapes précédentes.

Optimiser les requêtes

Vous pouvez utiliser deux fonctionnalités pour l’optimisation des requêtes :

• Optimiser les performances de rendu des requêtes de tableau de bord
• Activer une cohérence faible

Pour effectuer l’optimisation, dans Sources de données>Paramètres>Optimisations de requêtes, apportez les modifications nécessaires.

Optimiser les performances de rendu des requêtes de tableau de bord

Lorsqu’un tableau de bord ou un visuel est rendu plusieurs fois par un ou plusieurs utilisateurs, Grafana envoie au moins une requête à Azure Data Explorer par défaut. Activez la mise en cache des résultats de requête pour améliorer les performances de rendu du tableau de bord et réduire la charge sur le cluster Azure Data Explorer.

Pendant l’intervalle de temps spécifié, Azure Data Explorer utilise le cache des résultats pour récupérer les résultats précédents et n’exécute pas une requête inutile. Cette fonctionnalité est particulièrement efficace pour réduire la charge sur les ressources et améliorer les performances lorsque plusieurs utilisateurs emploient le même tableau de bord.

Pour activer le rendu du cache des résultats, procédez comme suit dans le volet Optimisations des requêtes :

1. Désactivez Utiliser la mise en cache dynamique.
2. Dans Âge maximum du cache, entrez le nombre de minutes pendant lesquelles vous souhaitez utiliser les résultats mis en cache.

Activer une cohérence faible

Les clusters sont configurés avec une cohérence forte. Cette configuration par défaut garantit que les résultats de la requête sont à jour avec toutes les modifications apportées au cluster.

Lorsque vous activez la cohérence faible, les résultats de la requête peuvent avoir un décalage de 1 à 2 minutes après les modifications de cluster. Toutefois, une cohérence faible peut augmenter le temps de rendu visuel. Si la cohérence immédiate n’est pas critique et que les performances sont marginales, activez une cohérence faible pour améliorer les performances. Pour plus d’informations, consultez Cohérence des requêtes.

Pour activer la cohérence faible, dans le volet Optimisations des requêtes, sélectionnez Cohérence> des donnéesFaible.

Visualiser les données

Vous avez terminé la configuration d’Azure Data Explorer en tant que source de données pour Grafana. Il est maintenant temps de visualiser les données.

L’exemple de base suivant utilise à la fois le mode générateur de requêtes et le mode brut de l’éditeur de requête. Nous vous recommandons d’afficher les requêtes en écriture pour Azure Data Explorer pour obtenir des exemples d’autres requêtes à exécuter sur le jeu de données.

1. Dans Grafana, dans le menu de gauche, sélectionnez l’icône plus. Sélectionnez ensuite Tableau de bord.

   

2. Sous l’onglet Ajouter, sélectionnez Graphe.

   

3. Dans le volet graphique, sélectionnezModifier le titre> du panneau.

   

4. En bas du volet, sélectionnez Source de données, puis sélectionnez la source de données que vous avez configurée.

   

Mode générateur de requêtes

Utilisez le mode générateur de requêtes pour définir votre requête.

1. Sous la source de données, sélectionnez Base de données et choisissez votre base de données dans la liste déroulante.

2. Sélectionnez À partir de et choisissez votre table dans la liste déroulante.

   

3. Maintenant que la table est définie, filtrez les données :

   1. Sélectionnez + à droite de Where (filtre) pour sélectionner une ou plusieurs colonnes dans votre table.
   2. Pour chaque filtre, définissez les valeurs à l’aide de l’opérateur applicable. Cette sélection est similaire à l’utilisation de l’opérateur where dans Langage de requête Kusto.

4. Sélectionnez les valeurs à présenter dans la table :

   1. Sélectionnez + à droite de Colonnes de valeur pour sélectionner les colonnes de valeur qui apparaîtront dans le volet.

   2. Pour chaque colonne de valeur, définissez le type d’agrégation.

      Vous pouvez définir une ou plusieurs colonnes de valeur. Cette sélection s’apparente à l’utilisation de l’opérateur summarize.

5. Sélectionnez + à droite de Regrouper par (résumer) pour sélectionner une ou plusieurs colonnes qui seront utilisées pour organiser les valeurs en groupes. Cette sélection est équivalente à l’expression de groupe dans l’opérateur summarize .

6. Sélectionnez Run Query (Exécuter la requête).

   

   Conseil

   Pendant que vous finalisez les paramètres dans le générateur de requêtes, une requête Langage de requête Kusto est créée. Cette requête montre la logique que vous avez construite à l’aide de l’éditeur de requête graphique.

7. Sélectionnez Modifier KQL pour passer en mode brut. Modifiez votre requête en utilisant la flexibilité et la puissance du Langage de requête Kusto.

Mode brut

Utilisez le mode RAW pour modifier votre requête.

1. Dans le volet de requête, collez la requête suivante, puis sélectionnez Exécuter. La requête compartimente le nombre d’événements par jour pour l’exemple de jeu de données.

   StormEvents
   | summarize event_count=count() by bin(StartTime, 1d)
   

   

2. Le graphique n’affiche aucun résultat, car il est limité (par défaut) aux données des six dernières heures. Dans le menu supérieur, sélectionnez 6 dernières heures.

   

3. Spécifiez une plage personnalisée qui couvre 2007, l’année incluse dans l’exemple de jeu de données StormEvents. Ensuite, sélectionnez Appliquer.

   

   Le graphe montre maintenant les données de 2007, compartimentées par jour.

   

4. Dans le menu supérieur, sélectionnez l’icône d’enregistrement : .

Pour basculer en mode générateur de requêtes, sélectionnez Switch to builder. Grafana convertit la requête en logique disponible dans le générateur de requêtes. La logique du générateur de requêtes étant limitée, vous risquez de perdre les modifications manuelles que vous avez apportées à la requête.

Créez des alertes

1. Dans Le tableau de bord d’accueil, sélectionnez Canaux de notification d’alerte> pour créer un canal de notification.

   

2. Entrez un nom et tapez sous Nouveau canal de notification, puis sélectionnez Enregistrer.

   

3. Dans le tableau de bord, sélectionnez Modifier dans la liste déroulante.

   

4. Sélectionnez l’icône représentant une cloche d’alerte pour ouvrir le volet Alerte. Sélectionnez Créer une alerte, puis complétez les propriétés de l’alerte.

   

5. Sélectionnez le bouton Enregistrer le tableau de bord pour enregistrer vos modifications.

Contenu connexe

• Écrire des requêtes pour l’Explorateur de données Azure