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 chiffres réels.

Ce tutoriel couvre les connecteurs dans la catégorie Télémétrie . 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 aperçu. 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.
  • Lisez l’accès à la source de télémétrie que 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 la solution complète de l’assistant. 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 Requête des journaux de travail en mode lecture seule
Application Insights Application Insights Identité gérée Requête de 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 et télémétrie indexée
Dynatrace Dynatrace Identifiants de service affichés par le connecteur Requêtes sur les données d’observabilité et les traces
New Relic New Relic Identifiants de service affichés par le connecteur Requête en télémétrie et 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 Requête des données d’observabilité alimentées par 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 de gauche, développez Constructeur, puis sélectionnez Connecteurs.

  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 : Authentifier

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 Log Analytics Workspace, 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.

  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 Permettre 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 activé petit. 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 modèle de manière plus fiable et reste dans le budget de 80 outils.

Étape 4 : Valider par une question

  1. Ouvre un chat avec ton agent.

  2. Posez une question qui nécessite votre télémétrie. Par exemple:

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

  3. Regardez la réponse. Une carte d’outils montre à l’agent sélectionner l’outil de requête du connecteur et exécuter la requête, suivi 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 accès en lecture Accordez à la lecture d’identité un accès à la ressource cible, puis réessayez.
La requête renvoie « non trouvé » Mauvais nom d’espace de travail, cluster, base de données ou table Confirmez le nom exact dans le service. Les noms sont sensibles à la casse.
Le connecteur tiers ne peut pas se connecter URL, jeton ou 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 pour le dernier jour ».
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

  • Last updated on