Configurer une source de données Azure Data Explorer

Azure Data Explorer est un service d’exploration de données de données de journaux et de télémétrie. Dans ce guide, vous allez apprendre à ajouter une source de données Azure Data Explorer à Grafana et à configurer Azure Data Explorer à l’aide de chaque option d’authentification disponible pour cette source de données.

Prérequis

• Instance Azure Managed Grafana dans le plan Standard.
• Une base de données Azure Data Explorer

Ajouter une source de données Azure Data Explorer

Ajoutez une source de données Azure Data Explorer à Grafana en suivant les étapes ci-dessous.

1. Ouvrez une instance Azure Managed Grafana dans le Portail Azure.

2. Dans la section Vue d’ensemble, ouvrez l’URL du point de terminaison.

3. Dans le portail Grafana, déployez le menu à gauche et sélectionnez Connecter ions> Connecter données.

   

4. Sélectionnez La source de données Azure Data Explorer dans la liste et ajoutez-la à Grafana en sélectionnant Créer une source de données Azure Data Explorer Data Explorer.

Configurer une source de données Azure Data Explorer

Entrez les paramètres de configuration d’Azure Data Explorer.

1. Sous l’onglet Paramètres, modifiez éventuellement le nom de la source de données.

   

2. Sous Connecter ion Détails, entrez l’URL du cluster de base de données Azure Data Explorer.

3. Sélectionnez votre option d’authentification préférée entre l’identité managée, l’inscription d’application (principal de service) ou l’utilisateur actuel (authentification basée sur l’utilisateur).

   Identité gérée

   Authentifiez-vous avec une identité managée sans utiliser d’informations d’identification explicites.

   Ajouter une nouvelle autorisation

   1. Dans le Portail Azure, ouvrez votre cluster Azure Data Explorer.

   2. Dans la section Vue d’ensemble, sélectionnez la base de données qui contient vos données.

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

      

   4. Dans la zone de recherche, entrez le nom de votre espace de travail Azure Managed Grafana, sélectionnez l’espace de travail, puis sélectionnez Sélectionner. Une notification de réussite s’affiche.

   Configurer la source de données dans Grafana

   1. De retour dans Grafana, sous Méthode d’authentification, sélectionnez Identité managée.
   2. Sélectionnez Enregistrer et tester. La notification « Réussite » affichée indique que Grafana est en mesure d’extraire des données de la base de données.

   Enregistrement d’application

   Authentifiez-vous avec l’inscription d’application à l’aide d’un principal de service Microsoft Entra.

   Configuration initiale

   1. Suivez les étapes dans Inscrire une application auprès de Microsoft Entra ID et créer un principal de service.
   2. Attribuez le rôle Lecteur à l’application à l’étape suivante du guide.
   3. Suivez les trois premières étapes du guide de détails de récupération de l’application pour collecter l’ID d’annuaire (locataire), l’ID d’application (client) et l’ID de secret client requis à l’étape suivante.

   Configurer la source de données dans Grafana

   1. Dans Grafana, sous Méthode d’authentification, sélectionnez Inscription de l’application.

   2. Pour le cloud Azure, sélectionnez votre cloud Azure. Par exemple, Azure.

      

   3. Entrez un ID d’annuaire (locataire), un ID d’application (client) et une clé secrète client

   4. Vous pouvez également modifier les sections Optimisations des requêtes, Paramètres de schéma de base de données et Suivi .

   5. Sélectionnez Enregistrer et tester pour valider la connexion. La notification « Réussite » affichée indique que Grafana est en mesure de se connecter à la base de données.

   Utilisateur actuel

   Utilisez la méthode d’authentification basée sur l’utilisateur, en tirant parti des informations d’identification Microsoft Entra ID de l’utilisateur Grafana actuelles dans la source de données configurée.

   Lorsque vous configurez une source de données Azure Data Explorer avec la méthode d’authentification utilisateur actuelle, Grafana interroge Azure Data Explorer à l’aide des informations d’identification de l’utilisateur.

   Attention

   L’authentification basée sur l’utilisateur dans les sources de données Grafana est expérimentale.

   Attention

   Cette fonctionnalité n’est pas compatible avec les cas d’usage qui nécessitent un accès toujours actif aux données interrogées, notamment les alertes, les rapports, la mise en cache des requêtes et les tableaux de bord publics. La méthode d’authentification de l’utilisateur actuel s’appuie sur un utilisateur connecté, dans une session interactive, pour que Grafana atteigne la base de données. Lorsque l’authentification basée sur l’utilisateur est utilisée et qu’aucun utilisateur n’est connecté, les tâches automatisées ne peuvent pas s’exécuter en arrière-plan. Pour tirer parti des tâches automatisées pour Azure Data Explorer, nous vous recommandons de configurer une autre source de données Azure Data Explorer à l’aide d’une autre méthode d’authentification.

   Ajouter une nouvelle autorisation

   Ajoutez une nouvelle autorisation pour votre compte d’utilisateur pour accéder à la base de données.

   1. Dans le Portail Azure, ouvrez la ressource base de données Azure Data Explorer, puis sélectionnez Autorisations>Ajouter>une visionneuse.

   2. Entrez votre nom ou votre adresse e-mail dans la barre de recherche, sélectionnez votre compte d’utilisateur, puis sélectionnez Sélectionner.

      

   3. Une notification confirme que l’autorisation a été ajoutée à la base de données.

   Configurer la source de données dans Grafana

   1. Dans Grafana, sous Méthode d’authentification, sélectionnez Utilisateur actuel.
   2. Sélectionnez Enregistrer et tester. La notification « Réussite » affichée indique que Grafana est en mesure d’extraire des données de la base de données.

Créer une source de données Azure Data Explorer

Dans Azure CLI, ajoutez et configurez une source de données Azure Data Explorer en exécutant la commande az grafana data-source create . Choisissez votre méthode d’authentification préférée et reportez-vous à l’onglet correspondant ci-dessous pour plus d’informations.

Lors de l’exécution de ces commandes, remplacez tous les espaces réservés par vos propres informations.

Identité gérée

Authentifiez-vous avec une identité managée sans utiliser d’informations d’identification explicites.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "dataConsistency": "strongconsistency",
    "azureCredentials": {
      "authType": "msi"
    }
  }
}'

Enregistrement d’application

Authentifiez-vous avec l’inscription d’application à l’aide d’un principal de service Microsoft Entra.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "azureCredentials": {
      "authType": "clientsecret",
      "azureCloud": "AzureCloud",
      "tenantId": "<tenant-id>",
      "clientId": "<client-id>"
    }
  },
  "secureJsonData": { "azureClientSecret": "verySecret" }
}'

Utilisateur actuel

Authentifiez-vous avec la méthode utilisateur actuelle. Cette méthode tire parti des informations d’identification Microsoft Entra ID de l’utilisateur Grafana actuels dans la source de données configurée.

Lorsque vous configurez une source de données Azure Data Explorer avec la méthode d’authentification utilisateur actuelle, Grafana interroge Azure Data Explorer à l’aide des informations d’identification de l’utilisateur.

Remarque

Le déploiement de l’authentification basée sur l’utilisateur dans Azure Managed Grafana est en cours et sera terminé dans toutes les régions à la fin de 2023.

Attention

L’authentification basée sur l’utilisateur dans les sources de données Grafana est expérimentale.

Attention

Cette fonctionnalité n’est pas compatible avec les cas d’usage qui nécessitent un accès toujours actif aux données interrogées, notamment les alertes, les rapports, la mise en cache des requêtes et les tableaux de bord publics. La méthode d’authentification de l’utilisateur actuel s’appuie sur un utilisateur connecté, dans une session interactive, pour que Grafana atteigne la base de données. Lorsque l’authentification basée sur l’utilisateur est utilisée et qu’aucun utilisateur n’est connecté, les tâches automatisées ne peuvent pas s’exécuter en arrière-plan. Pour tirer parti des tâches automatisées pour Azure Data Explorer, nous vous recommandons de configurer une autre source de données Azure Data Explorer à l’aide d’une autre méthode d’authentification.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "dataConsistency": "strongconsistency",
    "azureCredentials": {
      "authType": "currentuser"
    }
  }
}'

Mettre à jour une source de données Azure Data Explorer

Pour mettre à jour une source de données Azure Data Explorer, suivez les étapes ci-dessous. Lors de l’exécution de ces commandes, remplacez tous les espaces réservés par vos propres informations.

1. Obtenez l’ID de la source de données Azure Data Explorer à mettre à jour avec az grafana data-source list.

   az grafana data-source list --resource-group <azure-managed-grafana-resource-group> --name <azure-managed-grafana-workspace> --query "[?type=='grafana-azure-data-explorer-datasource'].id"
   

2. Exécutez la commande az grafana data-source update pour mettre à jour la source de données.

   Par exemple, mettez à jour le nom et l’URL du cluster de la source de données Azure Data Explorer avec la commande suivante.

   az grafana data-source update --resource-group <azure-managed-grafana-workspace-resource-group> --name <azure-managed-grafana-workspace> --data-source-id <data-source-id> --set name="<new-name>" url="<new-url>
   

Étape suivante

Création d’un tableau de bord