Connecter une source de télémétrie

Connectez une source de télémétrie pour ancrer les réponses de votre agent sur vos propres signaux, pas sur les connaissances générales. Après avoir installé un connecteur de télémétrie, posez une question d’enquête en langage clair. L’agent lance la requête et répond avec des nombres réels.

Ce tutoriel couvre les connecteurs dans la catégorie Telemetry. Azure Data Explorer utilise le chemin Azure MCP Kusto. Les connecteurs de télémétrie tiers apparaissent également dans l’onglet Télémétrie , même lorsqu’ils utilisent MCP en coulisses. La configuration utilise le même assistant que tous les connecteurs gérés, donc cet article se concentre sur les détails de la télémétrie : comment les sources s’authentifient, quelles opérations activer, et comment valider par requête.

Important

Les connecteurs gérés sont en préversion. La disponibilité, les champs et les opérations des connecteurs peuvent changer.

Prerequisites

  • Un agent SRE en cours de fonctionnement et un accès à sre.azure.com.
  • Permission de configurer les connecteurs sur l’agent.
  • Accès en lecture à la source de télémétrie à laquelle vous vous connectez. Pour une source Azure, l’identité qui autorise la connexion a besoin au moins d’un accès en lecture à la ressource ciblée.

Si vous n’avez jamais configuré de connecteur auparavant, commencez par Configurez un connecteur géré pour une procédure guidée complète. Cet article ne mentionne que les différences de source de télémétrie.

Connecteurs de télémétrie

Connecteur Service Authentication Utilisation classique
Azure Data Explorer (via Azure MCP) Azure Data Explorer (Kusto) Identité gérée Exécuter des requêtes KQL sur des clusters ADX
Espace de travail Log Analytics Log Analytics Identité gérée Consulter les journaux de l’espace de travail en mode lecture seule
Application Insights Application Insights Identité gérée Interrogez la télémétrie de l’application en mode lecture seule
Datadog Datadog Identifiants de service affichés par le connecteur Requêtes, métriques, journaux et moniteurs
Elasticsearch Elasticsearch Identifiants de service affichés par le connecteur journaux de recherche/search logs et télémétrie indexée
Dynatrace Dynatrace Identifiants de service affichés par le connecteur Interroger les données d’observabilité et les traces
New Relic New Relic Identifiants de service affichés par le connecteur Interroger la télémétrie et les incidents
Splunk Splunk Identifiants de service affichés par le connecteur Recherchez les journaux et événements de Splunk
Hawkeye (NeuBird) Hawkeye par NeuBird Identifiants de service affichés par le connecteur Interroger les données d’observabilité basées sur l’IA

Les connecteurs de télémétrie tiers incluent une URL par défaut, une authentification et des indices d’en-tête pour vous aider à configurer la connexion.

Vous pouvez aussi ajouter une autre source de télémétrie via un connecteur fourni par l’utilisateur. Utilisez cette option lorsque votre équipe dispose d’un outil personnalisé ou d’une source qui n’est pas listée dans le sélecteur de connecteurs.

Étape 1 : Ajouter le connecteur

  1. Accédez à sre.azure.com et sélectionnez votre agent.

  2. Dans la barre latérale gauche, sélectionnez Build + setup>Extensions>.

  3. Sélectionnez Ajouter un connecteur.

  4. Sélectionnez l’onglet Télémétrie , puis choisissez votre source de télémétrie. Pour Azure Data Explorer, sélectionnez Azure Data Explorer, qui utilise le chemin Azure MCP Kusto.

Étape 2 : Authentification

Pour les connecteurs de télémétrie Azure :

  1. Complétez les champs affichés par le connecteur.

    • Pour Azure Data Explorer, nommez le connecteur, sélectionnez l’identité gérée que l’agent utilise pour interroger Kusto, puis ajoutez un ou plusieurs groupes de cluster avec des URL de cluster.
    • Pour Espace de travail Log Analytics, sélectionnez un espace de travail depuis le sélecteur d’espace de travail, ou entrez manuellement l’identifiant de ressource ARM de l’espace de travail.
    • Pour Application Insights, sélectionnez une ressource Application Insights depuis le sélectionneur de ressources, ou entrez manuellement l’identifiant de ressource ARM de la ressource.

  2. Sélectionnez une identité gérée lorsque le connecteur en demande une.

  3. Continuez à l’étape de révision, de cluster ou de sélection d’outils indiquée par l’assistant.

L’identité gérée doit avoir un accès en lecture à la ressource cible. Si les requêtes échouent ultérieurement avec une erreur de permission, accordez l’accès en lecture à cette identité et réessayez la requête.

Étape 3 : Configurez des outils de requête

À l’étape de configuration des outils , activez les opérations qui lisent la télémétrie. Les opérations de requête sont le cœur d’un connecteur de télémétrie, donc sélectionnez les opérations « run-query » ou « search ». Laissez les opérations administratives désactivées sauf si vous en avez besoin.

Réglez chaque opération de lecture sur Autoriser afin que l’agent puisse répondre aux questions sans pause. Si vous activez une opération qui modifie des données, réglez-la sur Demander.

Pour Azure Data Explorer via Azure MCP, l’assistant inclut une étape de groupe de cluster et une étape de révision avec test de connexion. Configurez les groupes de cluster, testez la connectivité et enregistrez le connecteur. L’ensemble d’outils Kusto est géré par le chemin Kusto MCP d’Azure.

Conseil

Gardez l’ensemble des éléments activés réduit. Un connecteur de télémétrie nécessite généralement uniquement ses opérations de requête. Moins d’outils signifie que l’agent choisit le bon outil de manière plus fiable et reste dans le budget de 80 outils.

Étape 4 : Valider à l’aide d’une question

  1. Ouvrez une discussion avec votre agent.

  2. Posez une question qui nécessite l’accès à vos données de télémétrie. Par exemple:

    How many errors were logged in the last hour, grouped by service?

  3. Consultez la réponse. Une carte d’outils montre l’agent en train de sélectionner l’outil de requête du connecteur et d’exécuter la requête, suivie d’une réponse ancrée dans votre télémétrie.

Quand vous voyez un vrai décompte provenant de votre propre source au lieu d’une explication générale, le connecteur fonctionne de bout en bout.

Résolution des problèmes

Problème Cause Réparer
La requête retourne « Non autorisé » ou « Interdit » L’identité de connexion n’a pas les droits de lecture Accordez à l’identité un accès en lecture à la ressource cible, puis réessayez.
La requête renvoie « non trouvé » Nom d’espace de travail, de cluster, de base de données ou de table incorrect Confirmez le nom exact dans le service concerné. Les noms sont sensibles à la casse.
Le connecteur tiers ne parvient pas à se connecter L’URL, le jeton ou la valeur d’en-tête est incorrecte Confirmez les valeurs avec votre administrateur d’observabilité et mettez à jour le connecteur.
La réponse est générique et aucune carte d’outils n’apparaît La question ne nécessitait pas votre télémétrie Reformulez pour que la question ait besoin de votre télémétrie, par exemple « compter les requêtes échouées dans le service X au cours des dernières 24 heures ».
Connecteur sauvegardé mais aucune télémétrie renvoyée Résultat vide ou filtré Élargissez la plage temporelle de votre question, ou confirmez que la source a une télémétrie récente.

Contenu connexe

  • Dernière mise à jour :