Outils Azure MCP Server pour Azure Monitor et les cahiers

Le serveur Azure Model Context Protocol (MCP) vous permet de gérer les ressources Azure Monitor et les carnets de notes à l'aide de requêtes en langage naturel. Vous pouvez interroger Log Analytics espaces de travail, analyser les données opérationnelles, surveiller l’intégrité des ressources, récupérer les métriques de performances, gérer les tests web de disponibilité, orchestrer les workflows d’instrumentation et gérer les classeurs Azure Monitor.

Azure Monitor vous permet d’optimiser la disponibilité et les performances de vos applications et services. Il fournit une solution complète pour collecter, analyser et agir sur les données de télémétrie à partir de vos environnements cloud et locaux.

Les classeurs fournissent un canevas flexible pour l’analyse des données et la création de rapports visuels enrichis dans le portail Azure. Ils vous permettent d’exploiter plusieurs sources de données à partir de Azure et de les combiner en expériences interactives unifiées. Les classeurs vous permettent de combiner plusieurs types de visualisations et d’analyses, ce qui les rend très utiles pour ce type d’exploration sous forme libre. Pour plus d'informations, consultez la documentation sur les classeurs d'Azure Monitor.

Note

paramètres Tool : les outils Azure MCP Server définissent des paramètres pour les données dont ils ont besoin pour effectuer des tâches. Certains de ces paramètres sont spécifiques à chaque outil et sont documentés ci-dessous. D’autres paramètres sont globaux et partagés par tous les outils. Pour plus d’informations, consultez Paramètres de l’outil.

Journal d’activité : Obtenir les journaux d’activité

Répertorie les journaux d'activité d’Azure Monitor pour une ressource Azure spécifiée pour un nombre précis d’heures passées. Cet outil vous aide à comprendre l’historique du déploiement des ressources, les modifications de configuration et les modèles d’accès. Elle retourne les événements du journal d’activité qui incluent l’horodatage, le nom de l’opération, l’état et les informations de l’appelant. Utilisez les résultats pour examiner les déploiements ayant échoué, les modifications inattendues ou les problèmes d’accès.

Voici quelques exemples d’invites :

  • Listez les journaux d’activité des 720 dernières heures pour la ressource "webapp-prod".
Paramètre Obligatoire ou facultatif Descriptif
Nom de la ressource Obligatoire Nom de la ressource Azure pour laquelle récupérer les journaux d’activité.
Niveau d’événement Optional Niveau des journaux d’activité à récupérer. Les niveaux valides sont : Critical, , ErrorInformational, Verbose, Warning. S’il n’est pas fourni, retourne tous les niveaux.
Hours Optional Nombre d’heures écoulées avant maintenant pour récupérer les journaux d’activité.
Type de ressource Optional Type de la ressource Azure (par exemple, 'Microsoft.Storage/storageAccounts'). Indiquez cela uniquement si nécessaire pour lever l’ambiguïté entre plusieurs ressources portant le même nom.
Top Optional Nombre maximal de journaux d’activité à récupérer.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Tests web : Créer ou mettre à jour un test web

Dans le cadre de l’outil MCP (Model Context Protocol), cet outil crée ou met à jour un test web standard dans Azure Monitor pour vérifier la disponibilité des points de terminaison. Vous spécifiez des paramètres de surveillance tels que l’URL, la fréquence, les emplacements et les réponses attendues. Si le test n’existe pas, cet outil le crée ; sinon, il met à jour le test existant avec les nouveaux paramètres.

Voici quelques exemples d’invites :

  • « Créer un test web standard avec la ressource webtest « webtest-prod-availability » dans le groupe de ressources « rg-prod-monitoring » et l’associer au composant AppInsights '/subscriptions/12345678-1 1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod'. »
  • « Mettre à jour un test web standard existant pour la ressource webtest « webtest-prod-availability » dans le groupe de ressources « rg-prod-monitoring » pour le lier au composant AppInsights '/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod'. »
Paramètre Obligatoire ou facultatif Descriptif
Groupe de ressources Obligatoire Nom du groupe de ressources Azure.
Ressource Webtest Obligatoire Nom de la ressource de test web sur laquelle opérer.
Composant Appinsights Optional ID de ressource du composant Application Insights à associer au test web.
Description Optional Brève description du test web.
Activé Optional Indique si le test web est activé.
Code d’état attendu Optional Code d’état HTTP attendu.
Suivre les redirections Optional Indique s’il faut suivre les redirections HTTP.
Fréquence Optional Fréquence de test en secondes. Valeurs prises en charge : 300, 600, 900.
Headers Optional En-têtes HTTP à inclure dans la requête, sous forme de paires KEY=VALUE séparées par des virgules.
Verbe HTTP Optional Méthode HTTP à utiliser, par exemple obtenir ou publier.
Ignorer le code d’état Optional Indique s’il faut ignorer la validation du code d’état.
Lieu Optional Emplacement où la ressource de test web est créée. Cela doit correspondre à l’emplacement du composant Application Insights.
Analyser les demandes Optional Indique s’il faut analyser les demandes dépendantes.
Corps de la demande Optional Corps à envoyer avec la demande.
URL de requête Optional URL absolue à tester.
Nouvelle tentative activée Optional Indique si les nouvelles tentatives sont activées.
Vérification SSL Optional Indique s’il faut valider des certificats SSL.
Vérification de la durée de vie SSL Optional Nombre de jours pour vérifier la durée de vie du certificat SSL.
Délai d'expiration Optional Délai d’expiration de la demande en secondes. Valeurs prises en charge : 30, 60, 90, 120.
Nom du test web Optional Nom du test dans la ressource de test web.
Emplacements de tests web Optional Liste séparée par des virgules des emplacements à partir duquel exécuter le test. L'emplacement fait référence à la balise de géolocalisation de la population pour les tests de disponibilité.

Indicateurs d’annotation d’outil :

Destructeur : ✅ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ❌ | Secret : ❌ | Local requis : ❌

Tests web : Obtenir un test web

Cet outil obtient des détails pour un test web spécifique ou répertorie tous les tests web. Lorsque vous spécifiez la ressource Webtest, cet outil retourne des informations détaillées pour ce test web. Lorsque vous ne spécifiez pas la ressource Webtest, cet outil retourne une liste de tous les tests web de l’abonnement, et vous pouvez filtrer la liste par groupe de ressources.

Voici quelques exemples d’invites :

  • « Obtenir les détails du test web pour la ressource webtest « webtest-prod » dans mon abonnement dans le groupe de ressources « rg-monitoring ».
  • « Répertorier toutes les ressources de test web dans mon abonnement ».
  • « Répertorier toutes les ressources de test web dans mon abonnement dans le groupe de ressources « rg-prod ».
Paramètre Obligatoire ou facultatif Descriptif
Ressource Webtest Optional Nom de la ressource de test web sur laquelle opérer.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Log Analytics : répertorier les espaces de travail

Cet outil répertorie les espaces de travail Log Analytics dans un abonnement. Il récupère le nom, l’ID, l’emplacement et d’autres propriétés de clé de chaque espace de travail. Vous pouvez l’utiliser pour identifier les espaces de travail avant d’interroger leurs journaux ou d’examiner les paramètres de l’espace de travail.

Voici quelques exemples d’invites :

  • « Lister les espaces de travail Log Analytics dans mon abonnement ».
  • « Afficher mes espaces de travail Log Analytics ».
  • « Accéder aux espaces de travail Log Analytics dans mon abonnement ».

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Log Analytics : Répertorier les tables

Cet outil répertorie toutes les tables d’un espace de travail Log Analytics. Par exemple, énumérez les tables de l’espace de travail « prod-law » dans le groupe de ressources « rg-monitoring » pour avoir un aperçu des colonnes et des types de données disponibles. Elle retourne des noms de tables et des schémas que vous utilisez pour générer des requêtes KQL (Kusto Query Language). Vous pouvez filtrer par type de table, par exemple CustomLog ou AzureMetrics.

Voici quelques exemples d’invites :

  • Répertorier l'ensemble des tables de type « CustomLog » dans l'espace de travail Log Analytics « prod-law » du groupe de ressources « rg-prod ».
  • « Afficher les tables de type de table « AzureMetrics » pour l’espace de travail « f1b2c3d4-5678-90ab-cdef-1234567890ab » dans le groupe de ressources « rg-monitoring ».
Paramètre Obligatoire ou facultatif Descriptif
Nom de l’espace de travail Optional ID ou nom de l’espace de travail Log Analytics. Il peut s’agir de l’identificateur unique (GUID) ou du nom complet de votre espace de travail.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Log Analytics : Obtenir des types de tables

Cet outil MCP (Model Context Protocol) répertorie les types de tables disponibles dans un espace de travail Azure Log Analytics. Elle retourne les noms des types de tables. Vous pouvez utiliser ces noms lorsque vous écrivez des requêtes sur Azure Monitor journaux d’activité.

Voici quelques exemples d’invites :

  • « Répertorier tous les types de tables disponibles dans Log Analytics nom d'espace de travail « prod-law-01 » dans le groupe de ressources « rg-prod ».
  • « Quels types de tables sont disponibles dans Log Analytics nom d'espace de travail « analytics-workspace » dans le groupe de ressources « rg-logs » ?
Paramètre Obligatoire ou facultatif Descriptif
Groupe de ressources Obligatoire Nom du groupe de ressources Azure qui contient l’espace de travail.
Nom de l’espace de travail Obligatoire Nom ou ID de l’espace de travail Log Analytics. Vous pouvez utiliser GUID de l’espace de travail ou le nom d'affichage.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Log Analytics : Consulter les fichiers log de l'espace de travail

Consulter les journaux dans tout l'espace de travail Log Analytics à l'aide du langage de requête Kusto (KQL). Cet outil exécute des requêtes à l’échelle de l’espace de travail qui retournent des journaux sur toutes les ressources et tables de l’espace de travail. Cet outil fait partie des outils MCP (Model Context Protocol). Par exemple, vous pouvez demander : « Afficher toutes les erreurs dans mon espace de travail », « ce qui s’est passé dans mon espace de travail au cours des 24 dernières heures », « lister les demandes ayant échoué dans l’espace de travail ».

Voici quelques exemples d’invites :

  • « Afficher les journaux avec la requête « erreurs » de la table « Syslog » dans l'espace de travail Log Analytics « my-workspace » dans le groupe de ressources « rg-prod ». »
Paramètre Obligatoire ou facultatif Descriptif
Requête Obligatoire Requête Kusto (KQL) à exécuter sur l’espace de travail Log Analytics. Vous pouvez utiliser des requêtes prédéfinies par nom : recent affiche les logs les plus récents, classés par TimeGenerated ; errors affiche les logs de niveau erreur, classés par TimeGenerated. Vous pouvez également fournir une requête KQL personnalisée.
Groupe de ressources Obligatoire Nom du groupe de ressources Azure qui contient l’espace de travail.
Nom de la table Obligatoire Nom de la table à interroger dans l’espace de travail.
Nom de l’espace de travail Obligatoire ID ou nom de l’espace de travail Log Analytics. Vous pouvez fournir l’identificateur global unique (GUID) ou le nom complet de l’espace de travail.
Hours Optional Nombre d’heures à interroger à partir de maintenant.
Limite Optional Le nombre maximal de résultats à renvoyer.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Log Analytics : Interroger les journaux des ressources

Interroger les journaux de diagnostic et d’activité d’une ressource Azure spécifique dans un espace de travail Log Analytics à l’aide du langage de requête Kusto (KQL). Cet outil filtre les résultats sur la ressource spécifiée et exécute la requête KQL fournie sur la table choisie. Par exemple, demandez « Afficher les journaux d’activité pour la ressource « app-monitor » pour les 24 dernières heures.

Voici quelques exemples d’invites :

  • « Afficher les journaux avec la requête « récent » pour l'ID de ressource '/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg-prod/providers/Microsoft.Compute/virtualMachines/my-vm' dans la table « AzureDiagnostics ».»
Paramètre Obligatoire ou facultatif Descriptif
Requête Obligatoire Requête KQL à exécuter sur l’espace de travail Log Analytics. Vous pouvez utiliser des requêtes prédéfinies par nom : recent affiche les journaux les plus récents classés par TimeGenerated ; errors affiche les journaux de niveau d'erreur classés par TimeGenerated. Sinon, fournissez une requête KQL personnalisée.
ID de ressource Obligatoire ID de ressource Azure de la ressource à interroger. Exemple : /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.OperationalInsights/workspaces/<ws>.
Nom de la table Obligatoire Nom de la table à interroger dans l’espace de travail.
Hours Optional Nombre d’heures à interroger à partir de maintenant.
Limite Optional Le nombre maximal de résultats à renvoyer.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Santé : Obtenir l'état de santé de l'entité

Cet outil récupère l’état d’intégrité et les événements d’intégrité récents d’une entité spécifique dans un modèle d’intégrité Azure Monitor. L’outil MCP (Model Context Protocol) signale l’intégrité au niveau de l’application en fonction des modèles d’intégrité personnalisés, et non de la disponibilité des ressources de base. Pour la disponibilité des ressources de base, utilisez Azure Resource Health ou l’outil azmcp_resourcehealth_availability-status_get. Pour interroger les journaux d’activité dans un espace de travail Log Analytics, utilisez azmcp_monitor_workspace_log_query. Pour interroger les journaux d’activité d’une ressource Azure spécifique, utilisez azmcp_monitor_resource_log_query.

Voici quelques exemples d’invites :

  • « Affichez-moi l’état d’intégrité de l’entité « order-service » à l’aide du modèle d’intégrité « app-health-v1 » dans le groupe de ressources « rg-prod ».
Paramètre Obligatoire ou facultatif Descriptif
Nom de l’entité Obligatoire Entité pour laquelle obtenir la santé.
Modèle de santé Obligatoire Nom du modèle de santé pour lequel obtenir la santé.
Groupe de ressources Obligatoire Nom du groupe de ressources Azure. Ce groupe de ressources est un conteneur logique pour les ressources Azure.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Métriques : Métriques de requête

Interrogez les métriques Azure Monitor d’une ressource. Cet outil retourne des données de série chronologique pour les métriques spécifiées, ce qui vous aide à analyser les performances et la disponibilité des ressources. Cet outil fait partie des outils MCP (Model Context Protocol).

Voici quelques exemples d’invites :

  • « Analysez les tendances de performances et les temps de réponse pour la ressource Application Insights « appinsights-prod » avec les métriques « demandes/durée » et l’espace de noms de métrique « microsoft.insights/components ».
  • « Vérifiez la métrique de disponibilité « availabilityResults/availabilityPercentage » pour la ressource Application Insights « appinsights-staging » en utilisant l’espace de noms de métrique « microsoft.insights/components » ? »
  • « Obtenez la métrique « demandes/durée » avec l’agrégation « Moyenne » et l’intervalle « PT1M » pour la ressource « appinsights-prod » à l’aide de l’espace de noms de métrique « microsoft.insights/components ».
  • « Examinez les taux d’erreur et les demandes ayant échoué pour la ressource Application Insights « appinsights-prod » à l’aide des métriques « requests/failed, exceptions/count » et de l’espace de noms de métriques « microsoft.insights/components ».
  • Interrogez la métrique « requests/count » pour le type de ressource « Microsoft.Insights/components » ressource « appinsights-qa » avec l'espace de noms de métrique « microsoft.insights/components » et l'intervalle « PT5M ».
  • « Quelles sont les requêtes par seconde à l’aide de la métrique « demandes/nombre » avec l’agrégation « Count » pour la ressource Application Insights « appinsights-prod » et l’espace de noms de métrique « microsoft.insights/components » ?
Paramètre Obligatoire ou facultatif Descriptif
Noms de métriques Obligatoire Noms des métriques à interroger, séparés par des virgules.
Espace de noms métrique Obligatoire Espace de noms de métrique à interroger. Obtenez cette valeur à partir de l’outil azmcp-monitor-metrics-definitions.
Nom de la ressource Obligatoire Nom de la ressource Azure pour laquelle interroger les métriques.
Agrégation Optional Type d’agrégation à utiliser, tel que Average, Maximum, Minimum, Total ou Count.
Heure de fin Optional Heure de fin de la requête au format ISO (par exemple, 2023-01-01T00:00:00Z). La valeur par défaut est définie sur maintenant.
Filter Optional Filtre OData à appliquer à la requête de métriques.
Interval Optional Intervalle de temps pour les points de données (par exemple, PT1H pendant 1 heure, PT5M pendant 5 minutes).
Nombre maximal de compartiments Optional Nombre maximal de compartiments de temps à retourner. La valeur par défaut est 50.
Type de ressource Optional Type de ressource Azure (par exemple, Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). S’il n’est pas spécifié, l’outil tente de déduire le type du nom de la ressource.
Heure de début Optional Heure de début de la requête au format ISO (par exemple, 2023-01-01T00:00:00Z). Par défaut, il est réglé sur il y a 24 heures.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Métriques : répertorier les définitions de métriques

Cet outil répertorie les définitions de métriques d’une ressource Azure. Elle retourne des métadonnées sur chaque métrique, y compris les espaces de noms, les descriptions et les types d’agrégation. Vous pouvez donc déterminer les métriques à interroger pour une ressource.

Voici quelques exemples d’invites :

  • « Obtenir des définitions de métriques pour le nom de ressource « app-insights-prod ».
  • « Répertorier les définitions de métriques pour le nom de ressource « mystorageacct » avec le type de ressource « Microsoft.Storage/storageAccounts » et l'espace de noms des métriques « Storage ». »
  • « Afficher les définitions de métriques pour le nom de ressource « vm-prod-01 » avec la chaîne de recherche « cpu » et la limite « 20 ».
Paramètre Obligatoire ou facultatif Descriptif
Nom de la ressource Obligatoire Nom de la ressource Azure pour laquelle interroger les métriques.
Limite Optional Nombre maximal de définitions de métriques à retourner. La valeur par défaut est 10.
Espace de noms métrique Optional Espace de noms de métrique à interroger. Obtenez cette valeur à partir de l’outil azmcp-monitor-metrics-definitions.
Type de ressource Optional Type de ressource Azure (par exemple, Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Si vous ne le spécifiez pas, l’outil tente de déduire le type de ressource à partir du nom de la ressource.
Chaîne de recherche Optional Chaîne permettant de filtrer les définitions de métriques. Le filtre effectue une correspondance sans respect de la casse sur le nom et la description de la métrique.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Instrumentation : Obtenir une ressource d’apprentissage

Cet outil répertorie toutes les ressources d’apprentissage disponibles pour l’instrumentation Azure Monitor, ou récupère le contenu d’une ressource spécifique par chemin d’accès. Par défaut, l’outil retourne tous les chemins d’accès aux ressources. Si vous spécifiez un chemin d’accès, l’outil retourne le contenu complet des ressources. Pour instrumenter une application, utilisez l’outil orchestrator-start.

Voici quelques exemples d’invites :

  • Obtenez la ressource d’apprentissage d'introduction au chemin 'onboarding/get-started.md'.
  • « Montrez-moi le contenu de la ressource d'apprentissage d'intégration Azure Monitor au chemin « onboarding/quickstart.md ».
  • « Récupérez le contenu du fichier de ressources d'apprentissage Azure Monitor au chemin « samples/instrumentation-guide.html».
  • « Répertorier toutes les ressources d’apprentissage pour l’intégration à Azure Monitor. »
  • « Montrez-moi tous les parcours de ressources d’apprentissage pour l’instrumentation Azure Monitor. »
  • « Quelles ressources d’apprentissage sont disponibles pour l’intégration d’instrumentation Azure Monitor ? »
Paramètre Obligatoire ou facultatif Descriptif
Chemin d’accès Optional Parcours de ressources d'apprentissage.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ✅

Instrumentation : Démarrer l’orchestration

Commencez ici pour les outils MCP (Model Context Protocol) qui instrumentent Azure Monitor. Cet outil analyse l’espace de travail et retourne la première action à exécuter. Après avoir exécuté l’action, appelez orchestrator-next pour continuer. Suivez l’action dans le instruction champ exactement.

Voici quelques exemples d’invites :

  • Démarrez l'orchestration d'instrumentation d'Azure Monitor pour le chemin d'accès de l'espace de travail "/home/dev/workspace-monitoring".
  • Analyser le chemin d'accès de l'espace de travail '/src/projects/my-app-workspace' et retourner la première étape d'instrumentation de Azure Monitor.
  • Commencez l'intégration guidée d'Azure Monitor pour le projet sur le chemin de l'espace de travail « /workspace/my-app » et donnez-moi l'étape une.
Paramètre Obligatoire ou facultatif Descriptif
Chemin de l’espace de travail Obligatoire Chemin absolu du dossier de l’espace de travail.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ❌ | Monde Ouvert : ❌ | Lecture seule : ❌ | Secret : ❌ | Local requis : ✅

Instrumentation : Poursuivre l’orchestration

Obtenez l’action d’instrumentation suivante après avoir terminé l’action en cours.

Cet outil fait partie de la suite MCP (Model Context Protocol).

Après avoir exécuté précisément instruction de la réponse précédente, lancez cet outil pour connaître l’action suivante.

Flux de travail attendu :

  1. Vous recevez une action de orchestrator-start ou orchestrator-next.
  2. Vous exécutez précisément le instruction champ.
  3. Vous exécutez cet outil avec un Completion note concis pour obtenir l'action suivante.

Retourne : l'action suivante à exécuter, ou l'état complete lorsque toutes les étapes sont effectuées.

Voici quelques exemples d’invites :

  • « Après avoir terminé l'étape d'instrumentation Azure Monitor précédente, obtenez l'action suivante pour l'ID de session « session-abc123 » avec la note de fin « Ajout d'UseAzureMonitor() à Program.cs ».
  • « Obtenez la prochaine action d'intégration pour l'ID de session « workspace/session-2026 » avec la note d'achèvement « Ran dotnet add package Microsoft.ApplicationInsights'. »
  • Après avoir terminé l'étape d'instrumentation précédente, passez à l'étape suivante pour l'ID de session « session-789xyz » avec la note de finalisation « Mise à jour de appsettings.json pour activer Application Insights ».
Paramètre Obligatoire ou facultatif Descriptif
Note d’achèvement Obligatoire Une phrase décrivant ce que vous avez exécuté, par exemple « Ran dotnet add package command » ou « Added UseAzureMonitor() to Program.cs ».
ID de session Obligatoire Chemin d’accès de l’espace de travail renvoyé sous forme de sessionId depuis Orchestrator-start.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ❌ | Monde Ouvert : ❌ | Lecture seule : ❌ | Secret : ❌ | Local requis : ✅

Instrumentation : Envoyer une analyse brownfield

Envoie les résultats de l’analyse du code brownfield après que orchestrator-start retourne l’état analysis_needed. Cet outil fait partie du flux de travail MCP (Model Context Protocol). Vous devez analyser les fichiers sources de l’espace de travail et remplir le modèle d’analyse avant d’appeler cet outil. Une fois cet outil réussi, continuez avec orchestrator-next.

Voici quelques exemples d’invites :

  • Envoyez les résultats de l'analyse de code brownfield sous la forme du JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' à la session d'instrumentation d'Azure Monitor 'workspace-7a3b' après que l'analyse a été demandée.
  • Poursuivre l’orchestration de la migration en soumettant les résultats au format JSON « {"serviceOptions": {"found": true, "details": "AddApplicationInsightsTelemetry used"}, "initializers": [], "processors": [], "clientUsage": null, "sampling": {"found": false, "hasCustomSampling": false}, "telemetryPipeline": null, "logging": null} » à la session 'sess-01234'.
  • « Envoyer l’analyse de télémétrie brownfield terminée en tant que résultats JSON '{"serviceOptions » :null,"initializers » :null,"processors » :null,"clientUsage » :{"found » :true},"sampling » :{{"found » :false,"hasCustomSampling » :false},"telemetryPipeline » :null,"logging » :{"found » :true}}' pour l’intégration de la session 'session-9f3b'.
Paramètre Obligatoire ou facultatif Descriptif
Résultats JSON Obligatoire Objet JSON avec les résultats d'analyse de friche industrielle. Propriétés requises : serviceOptions (résultats des options de service lors de l’analyse de l’appel AddApplicationInsightsTelemetry(), null si pas trouvé), initialiseurs (résultats d'initialiseurs de télémétrie à partir de l’analyse des implémentations ITelemetryInitializer ou IConfigureOptions<TelemetryConfiguration>, null si aucun trouvé), processeurs (résultats des processeurs de télémétrie à partir de l’analyse des implémentations ITelemetryProcessor, null si aucun trouvé), clientUsage (résultats de l’utilisation de TelemetryClient à partir de l’analyse directe de TelemetryClient, null si pas trouvé), échantillonnage (résultats de configuration d’échantillonnage personnalisé, null si aucun échantillonnage personnalisé), telemetryPipeline (résultats d’utilisation personnalisée d’ITelemetryChannel ou de TelemetrySinks, null si pas trouvé), journalisation (fournisseur d’enregistreurs d’événements explicites et résultats de filtre, null si pas trouvé). Pour les sections qui n’existent pas dans le codebase, transmettez un objet par défaut vide, par exemple trouvé : false ou hasCustomSampling : false, au lieu de null.
ID de session Obligatoire Le chemin d’accès de l’espace de travail est retourné sous forme de sessionId depuis orchestrator-start.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ❌ | Monde Ouvert : ❌ | Lecture seule : ❌ | Secret : ❌ | Local requis : ✅

Instrumentation : Envoyer une sélection d’amélioration

Envoyez la sélection d'amélioration de l'utilisateur après que orchestrator-start ait renvoyé le statut enhancement_available. Présentez les choix d’amélioration à l’utilisateur, puis appelez cet outil avec les clés d’amélioration choisies. Vous pouvez sélectionner plusieurs améliorations en passant une liste séparée par des virgules, par exemple redis,processors. Une fois cet outil réussi, continuez avec orchestrator-next.

Voici quelques exemples d’invites :

  • « Envoyez des clés d'amélioration « redis, processeurs » pour Azure Monitor ID de session d'instrumentation « workspaces/my-app/session-abc123 ».
  • « Poursuivez le flux d’amélioration de l’instrumentation en envoyant des clés d’amélioration « redis » à l’ID de session « workspaces/prod-app/session-789 ».
  • Envoyez les clés d'amélioration choisies « entityframework, otlp » pour l'identifiant de session d'embarquement « workspaces/onboard/session-456 ».
Paramètre Obligatoire ou facultatif Descriptif
Touches d’amélioration Obligatoire Une ou plusieurs clés d’amélioration, séparées par des virgules (par exemple, redis, redis,processors, entityframework,otlp).
ID de session Obligatoire Le chemin d’accès de l’espace de travail est retourné sous forme de sessionId depuis orchestrator-start.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ❌ | Monde Ouvert : ❌ | Lecture seule : ❌ | Secret : ❌ | Local requis : ✅

Classeurs : Répertorier les classeurs

Recherchez des classeurs Azure à l’aide de Resource Graph pour des requêtes de métadonnées rapides. Cet outil vous aide à découvrir, filtrer et compter des classeurs dans différentes étendues.

Elle retourne les métadonnées du classeur, notamment id, name, location, category et les horodatages. Par défaut, il ne retourne pas le contenu complet du classeur (serializedData) : utilisez l’outil Show pour cela ou définissez Output format sur full.

Par défaut, la recherche cible les classeurs dans votre contexte de Azure actuel (locataire/abonnement). Vous pouvez utiliser Resource group pour spécifier explicitement votre étendue de recherche. L’outil retourne le nombre total côté serveur par défaut. Les résultats maximum retournés sont 50, avec une limite maximale de 1 000 ; ajustez-le avec Max results. Choisissez Output format comme summary pour les jetons minimaux ou full pour la sortie complète serializedData .

Voici quelques exemples d’invites :

  • « Afficher tous les classeurs du groupe de ressources « monitoring-rg ».
  • « Répertorier les classeurs partagés dans le groupe de ressources « prod-rg ».
  • « Quels classeurs ont été modifiés après 2024-01-15 dans le groupe de ressources « analytics-rg » ?
Paramètre Obligatoire ou facultatif Descriptif
Groupe de ressources Optional Nom du groupe de ressources Azure pour étendre la recherche.
Catégorie Optional Filtrer les classeurs par catégorie (par exemple, workbook, sentinel, TSG). S’il n’est pas spécifié, toutes les catégories sont retournées.
Inclure le nombre total Optional Incluez le nombre total de tous les classeurs correspondants dans la réponse (valeur par défaut : true).
Kind Optional Filtrer les classeurs par type (par exemple, shared, user). Si ce n’est pas spécifié, tous les types sont retournés.
Résultats max. Optional Nombre maximal de résultats à retourner (valeur par défaut : 50, max : 1000).
Modifié après Optional Filtrez les classeurs modifiés après cette date (format ISO 8601, par exemple). 2024-01-15
Nom contient Optional Filtrez les classeurs dans lesquels le nom d’affichage contient ce texte (sans distinction de casse).
Format de sortie Optional Format de sortie : summary (ID et nom uniquement, jetons minimaux), standard (métadonnées sans contenu, valeur par défaut) full (inclut serializedData).
ID source Optional Filtrez les classeurs par ID de ressource source (par exemple, /subscriptions/abc123/resourceGroups/prod/providers/Microsoft.Insights/components/myapp). S’il n’est pas spécifié, tous les classeurs sont retournés.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Classeurs : Afficher les détails des classeurs

Récupérez les détails complets du carnet via l'API Azure Resource Manager (ARM), y compris le contenu serializedData. Cette commande vous permet d’obtenir la définition complète du classeur, y compris la visualisation JSON.

Il renvoie les propriétés complètes du classeur, les serializedData balises et ETag. Vous pouvez fournir plusieurs Workbook IDs, pour les opérations par lots. La commande signale des échecs partiels pour chaque classeur. Pour de meilleures performances, utilisez d’abord l’outil de liste pour découvrir les classeurs, puis utilisez l’affichage pour des classeurs spécifiques.

Voici quelques exemples d’invites :

  • Montrez-moi les détails du classeur avec l'ID de ressource "/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1".
  • Récupérez la définition complète du classeur '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2f2'.
Paramètre Obligatoire ou facultatif Descriptif
Identifiants de classeurs Obligatoire Les identifiants de ressource Azure des carnets à récupérer. Prend en charge plusieurs valeurs pour les opérations de traitement par lots.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Classeurs : Créer un classeur

Créez un nouveau classeur dans le groupe de ressources et l’abonnement spécifiés. Vous pouvez définir le nom d'affichage et le contenu JSON sérialisé pour le classeur. Cette commande retourne les informations de classeur créées une fois l’opération terminée.

Voici quelques exemples d’invites :

  • « Créez un classeur nommé « Tableau de bord des performances » dans le groupe de ressources « monitoring-rg » avec le contenu sérialisé pour un bloc-notes de base. »
  • « Créez un classeur appelé « Vue d’ensemble de l’infrastructure » dans le groupe de ressources « prod-rg » avec du contenu montrant les métriques de machine virtuelle. »
Paramètre Obligatoire ou facultatif Descriptif
Nom d'affichage Obligatoire Nom d'affichage du classeur.
Groupe de ressources Obligatoire Nom du groupe de ressources Azure contenant le classeur.
Contenu sérialisé Obligatoire Le contenu JSON sérialisé du classeur.
ID source Optional ID de ressource associé pour le classeur. (azure monitor par défaut).

Indicateurs d’annotation d’outil :

Destructeur : ✅ | Idempotent : ❌ | Monde Ouvert : ❌ | Lecture seule : ❌ | Secret : ❌ | Local requis : ❌

Cahiers : Actualiser le cahier

Mettez à jour les propriétés d’un classeur Azure existant en ajoutant de nouvelles étapes, en modifiant le contenu ou en modifiant le nom complet. Cette action renvoie les détails du classeur mis à jour. Vous avez besoin de l’ID de ressource du classeur et pouvez spécifier un nouveau contenu sérialisé ou un nouveau nom d'affichage.

Voici quelques exemples d’invites :

  • Mettez à jour le classeur '/subscriptions/abc123/resourceGroups/monitoring-rg/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1' avec le nom d'affichage « Rapport mensuel ».
  • « Modifiez le contenu sérialisé du classeur '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' pour inclure un nouveau graphique de métriques. »
Paramètre Obligatoire ou facultatif Descriptif
ID du classeur Obligatoire ID de ressource Azure du classeur à mettre à jour.
Nom d'affichage Optional Nom d'affichage du classeur.
Contenu sérialisé Optional Le contenu JSON sérialisé du classeur.

Indicateurs d’annotation d’outil :

Destructeur : ✅ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ❌ | Secret : ❌ | Local requis : ❌

Classeurs : Supprimer des classeurs

Supprimez un ou plusieurs classeurs à l'aide de leurs ID de ressource Azure. Cette commande effectue une suppression temporaire sur les classeurs, en les gardant pendant 90 jours. Vous pouvez les restaurer à partir de la Corbeille via le portail Azure si nécessaire.

Pour les opérations par lots, vous pouvez fournir plusieurs Workbook IDs valeurs. La commande signale des échecs partiels par classeur, ce qui garantit que les échecs individuels n’affectent pas toute l’opération de traitement par lots.

Pour plus d’informations, consultez Gérer les carnets Azure Monitor.

Voici quelques exemples d’invites :

  • Supprimez le classeur avec l'ID de ressource '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1'.
  • « Supprimez les classeurs avec des ID de ressource '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' et '/subscriptions/def456/resourceGroups/analytics-rg/providers/Microsoft.Insights/workbooks/c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3'. »
Paramètre Obligatoire ou facultatif Descriptif
Identifiants de classeurs Obligatoire Les identifiants de ressource Azure des classeurs à supprimer. Prend en charge plusieurs valeurs pour les opérations de traitement par lots.

Indicateurs d’annotation d’outil :

Destructeur : ✅ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ❌ | Secret : ❌ | Local requis : ❌