Configurer une source de données Azure Data Explorer
Article
Azure Data Explorer est un service d’exploration de données de télémétrie et de journaux. 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.
Ajoutez une source de données Azure Data Explorer à Grafana en suivant les étapes ci-dessous.
Ouvrez une instance d’Azure Managed Grafana dans le portail Azure.
Dans la section Vue d’ensemble, ouvrez l’URL du point de terminaison.
Dans le portail Grafana, accédez à Connections>Data sources>Add new data source, puis recherchez et sélectionnez Azure Data Explorer Datasource.
Configurer une source de données Azure Data Explorer
Entrez les paramètres de configuration d’Azure Data Explorer.
Sous l’onglet Settings, modifiez éventuellement le nom de la source de données.
Sous Connection Details, entrez l’URL du cluster de base de données Azure Data Explorer.
Sélectionnez votre option d’authentification préférée parmi Managed Identity, App Registration (principal de service) ou Current User (authentification basée sur l’utilisateur).
Dans la zone de recherche, entrez le nom de votre espace de travail Azure Managed Grafana, sélectionnez l’espace de travail, puis choisissez Sélectionner. Une notification de réussite s’affiche.
Configurer la source de données dans Grafana
De retour dans Grafana, sous Authentication Method, sélectionnez Managed Identity.
Sélectionnez Save & test. La notification de réussite qui s’affiche indique que Grafana est en mesure d’extraire des données de la base de données.
Effectue l’authentification avec inscription d’application à l’aide d’un principal de service Microsoft Entra.
Suivez les trois premières étapes du guide Récupérer les détails 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
Dans Grafana, sous Authentication Method, sélectionnez App Registration.
Pour Azure Cloud, sélectionnez votre cloud Azure. Par exemple, Azure.
Entrez un ID d’annuaire (locataire), un ID d’application (client) et une clé secrète client.
Vous pouvez également modifier les sections Query Optimizations, Database schema settings, et Tracking.
Sélectionnez Save & test pour valider la connexion. La notification de réussite qui s’affiche indique que Grafana est en mesure de se connecter à la base de données.
Utilise la méthode d’authentification basée sur l’utilisateur, en tirant parti des informations d’identification Microsoft Entra ID de l’utilisateur Grafana actuel 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 Current User, 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’utilisation qui nécessitent un accès toujours actif de la machine 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 Current User s’appuie sur le fait qu’un utilisateur soit connecté, dans une session interactive, pour que Grafana puisse joindre 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 afin de permettre à votre compte d’utilisateur d’accéder à la base de données.
Dans le portail Azure, ouvrez la ressource Base de données Azure Data Explorer, puis sélectionnez Autorisations>Ajouter>Visionneuse.
Entrez votre nom ou votre adresse e-mail dans la barre de recherche, sélectionnez votre compte d’utilisateur, puis Sélectionner.
Une notification confirme que l’autorisation a été ajoutée à la base de données.
Configurer la source de données dans Grafana
Dans Grafana, sous Authentication Method, sélectionnez Current User.
Sélectionnez Save & test. La notification de réussite qui s’affiche 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.
S’authentifier avec la méthode Current User. Cette méthode tire parti des informations d’identification Microsoft Entra ID de l’utilisateur Grafana actuel 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 Current User, 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 fin 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’utilisation qui nécessitent un accès toujours actif de la machine 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 Current User s’appuie sur le fait qu’un utilisateur soit connecté, dans une session interactive, pour que Grafana puisse joindre 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.
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.
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"