Freigeben über

Azure MCP-Servertools für Azure Monitor und Arbeitsmappen

Mit dem Azure Model Context Protocol (MCP)-Server können Sie Azure Monitor- und Workbooks-Ressourcen mit Aufforderungen in natürlicher Sprache verwalten. Sie können Log Analytics Arbeitsbereiche abfragen, Betriebsdaten analysieren, ressourcenintegrität überwachen, Leistungsmetriken abrufen und Azure Monitor Arbeitsmappen verwalten.

Azure Monitor hilft Ihnen, die Verfügbarkeit und Leistung Ihrer Anwendungen und Dienste zu maximieren. Es bietet eine umfassende Lösung zum Sammeln, Analysieren und Handeln von Telemetrie aus Ihrer Cloud und lokalen Umgebungen.

Arbeitsmappen bieten eine flexible Canvas für Datenanalysen und die Erstellung umfangreicher visueller Berichte im Azure-Portal. Sie ermöglichen es Ihnen, aus Azure mehrere Datenquellen zu nutzen und sie in einheitliche interaktive Umgebungen zu kombinieren. Mithilfe von Arbeitsmappen können Sie mehrere Arten von Visualisierungen und Analysen miteinander kombinieren, wodurch sie sich hervorragend für die Freiform-Suche eignen. Weitere Informationen finden Sie in der Dokumentation zu Azure Monitor Arbeitsmappen.

Hinweis

Tool-Parameter: Die Azure MCP-Servertools definieren Parameter für Daten, die sie zum Ausführen von Aufgaben benötigen. Einige dieser Parameter sind für jedes Tool spezifisch und werden unten dokumentiert. Andere Parameter sind global und werden von allen Tools gemeinsam genutzt. Weitere Informationen finden Sie unter Toolparameter.

Aktivitätsprotokoll: Protokolle abrufen

Listet Azure Monitor Aktivitätsprotokolle für eine angegebene Azure Ressource für eine bestimmte Anzahl vergangener Stunden auf. Dieses Tool hilft Ihnen, den Verlauf der Ressourcenbereitstellung, Konfigurationsänderungen und Zugriffsmuster zu verstehen. Es gibt Aktivitätsprotokollereignisse zurück, die Zeitstempel, Vorgangsname, Status und Aufruferinformationen enthalten. Verwenden Sie die Ergebnisse, um fehlerhafte Bereitstellungen, unerwartete Änderungen oder Zugriffsprobleme zu untersuchen.

Beispiele für Prompts:

  • "Listet die Aktivitätsprotokolle für die letzten '720' Stunden für die Ressource 'webapp-prod' auf."
Parameter Erforderlich oder optional Description
Ressourcenname Erforderlich Der Name der Azure Ressource, für die Aktivitätsprotokolle abgerufen werden sollen.
Ereignisebene Wahlfrei Die Ebene der abzurufenden Aktivitätsprotokolle. Gültige Ebenen sind: Critical, Error, Informational, Verbose, . Warning Wenn nicht angegeben, werden alle Ebenen zurückgegeben.
Hours Wahlfrei Die Anzahl der Stunden vor jetzt, für die Aktivitätsprotokolle abgerufen werden sollen.
Ressourcentyp Wahlfrei Der Typ der Azure Ressource (z. B. 'Microsoft.Storage/storageAccounts'). Geben Sie dies nur bei Bedarf an, um zwischen mehreren Ressourcen mit demselben Namen zu unterscheiden.
Top Wahlfrei Die maximale Anzahl der abzurufenden Aktivitätsprotokolle.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Vertraulich: ❌ | Lokal erforderlich: ❌

Webtests: Erstellen oder Aktualisieren von Webtests

Teil des MCP-Tools (Model Context Protocol) erstellt oder aktualisiert dieses Tool einen Standardwebtest in Azure Monitor, um die Verfügbarkeit von Endpunkten zu überprüfen. Sie geben Überwachungseinstellungen wie URL, Häufigkeit, Speicherorte und erwartete Antworten an. Wenn der Test nicht vorhanden ist, erstellt es dieses Tool. andernfalls wird der vorhandene Test mit den neuen Einstellungen aktualisiert.

Beispiele für Prompts:

  • "Erstellen Sie einen neuen Standardwebtest mit webtest-ressource 'webtest-prod-availability' in der Ressourcengruppe 'rg-prod-monitoring', und ordnen Sie ihn der AppInsights-Komponente '/subscriptions/12345678-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod' zu."
  • Aktualisieren Sie einen vorhandenen Standard-Webtest für die Webtest-Resource 'webtest-prod-availability' in der Ressourcengruppe 'rg-prod-monitoring', um ihn mit der AppInsights-Komponente '/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod' zu verknüpfen.
Parameter Erforderlich oder optional Description
Ressourcengruppe Erforderlich Der Name der Azure Ressourcengruppe.
Webtest-Ressource Erforderlich Der Name der WebTest-Ressource, die bearbeitet werden soll.
Appinsights-Komponente Wahlfrei Die Ressourcen-ID der Application Insights-Komponente, die dem Webtest zugeordnet werden soll.
Beschreibung Wahlfrei Eine kurze Beschreibung des Webtests.
Aktiviert Wahlfrei Gibt an, ob der Webtest aktiviert ist.
Statuscode erwartet Wahlfrei Erwarteter HTTP-Statuscode.
Umleitungen folgen Wahlfrei Gibt an, ob HTTP-Umleitungen befolgt werden sollen.
Frequenz Wahlfrei Testhäufigkeit in Sekunden. Unterstützte Werte: 300, 600, 900.
Headers Wahlfrei HTTP-Header, die in die Anforderung eingeschlossen werden sollen, als kommagetrennte KEY=WERT-Paare.
HTTP-Verb Wahlfrei HTTP-Methode, die verwendet werden soll, z. B. Abrufen oder Posten.
Statuscode ignorieren Wahlfrei Gibt an, ob die Statuscodeüberprüfung ignoriert werden soll.
Ort Wahlfrei Der Speicherort, an dem die Webtestressource erstellt wird. Dies sollte mit dem Speicherort der Application Insights-Komponente übereinstimmen.
Analysieren von Anforderungen Wahlfrei Gibt an, ob abhängige Anforderungen analysiert werden sollen.
Anforderungstext Wahlfrei Der Inhalt, der mit der Anforderung gesendet werden soll.
Anforderungs-URL Wahlfrei Die zu testde absolute URL.
Wiederholungsversuche aktiviert Wahlfrei Gibt an, ob Wiederholungen aktiviert sind.
SSL-Überprüfung Wahlfrei Gibt an, ob SSL-Zertifikate überprüft werden sollen.
SSL-Lebensdauerüberprüfung Wahlfrei Anzahl der Tage, die die SSL-Zertifikatlebensdauer überprüfen sollen.
Timeout Wahlfrei Anforderungstimeout in Sekunden. Unterstützte Werte: 30, 60, 90, 120.
Webtestname Wahlfrei Der Name des Tests innerhalb der Webtestressource.
Webtest-Standorte Wahlfrei Durch Trennzeichen getrennte Liste der Speicherorte, von denen der Test ausgeführt werden soll. "Standort" bezieht sich auf das geografische Standort-Populations-Tag für Verfügbarkeitstests.

Werkzeugannotation Hinweise:

Destruktiv: ✅ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ❌ | Vertraulich: ❌ | Lokal erforderlich: ❌

Webtests: Webtest abrufen

Dieses Tool ruft Details zu einem bestimmten Webtest ab oder listet alle Webtests auf. Wenn Sie die Webtest-Ressource angeben, gibt dieses Tool detaillierte Informationen für diesen Webtest zurück. Wenn Sie die Webtest-Ressource nicht angeben, gibt dieses Tool eine Liste aller Webtests im Abonnement zurück, und Sie können die Liste nach Ressourcengruppe filtern.

Beispiele für Prompts:

  • "Webtestdetails für webtest-Ressource 'webtest-prod' in meinem Abonnement in der Ressourcengruppe 'rg-monitoring' abrufen."
  • "Alle Webtestressourcen in meinem Abonnement auflisten."
  • "Alle Webtestressourcen in meinem Abonnement in der Ressourcengruppe 'rg-prod' auflisten."
Parameter Erforderlich oder optional Description
Webtest-Ressource Wahlfrei Der Name der WebTest-Ressource, die bearbeitet werden soll.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Vertraulich: ❌ | Lokal erforderlich: ❌

Log Analytics: Arbeitsbereiche auflisten

Dieses Tool listet Log Analytics Arbeitsbereiche in einem Abonnement auf. Er ruft den Namen, die ID, den Standort und andere Schlüsseleigenschaften jedes Arbeitsbereichs ab. Sie können sie verwenden, um Arbeitsbereiche zu identifizieren, bevor Sie deren Protokolle abfragen oder Arbeitsbereichseinstellungen überprüfen.

Beispiele für Prompts:

  • "Log Analytics Arbeitsbereiche in meinem Abonnement auflisten."
  • "Meine Log Analytics Arbeitsbereiche anzeigen."
  • Abrufen der Log Analytics-Arbeitsbereiche in meinem Abonnement.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Vertraulich: ❌ | Lokal erforderlich: ❌

Log Analytics: Listentabellen

Dieses Tool listet alle Tabellen in einem Log Analytics Arbeitsbereich auf. Um eine Vorschau der verfügbaren Spalten und Datentypen anzuzeigen, listen Sie beispielsweise Tabellen im Arbeitsbereich "prod-law" der Ressourcengruppe "rg-monitoring" auf. Sie gibt Tabellennamen und Schemas zurück, die Sie zum Erstellen von Kusto Query Language (KQL)-Abfragen verwenden. Sie können nach Tabellentyp filtern, zum Beispiel CustomLog oder AzureMetrics.

Beispiele für Prompts:

  • "Alle Tabellen in Log Analytics Arbeitsbereich 'prod-law' des Tabellentyps 'CustomLog' in der Ressourcengruppe 'rg-prod' auflisten."
  • Zeigen Sie mir Tabellen des Tabellentyps 'AzureMetrics' für den Arbeitsbereich 'f1b2c3d4-5678-90ab-cdef-1234567890ab' in der Ressourcengruppe 'rg-monitoring'.
Parameter Erforderlich oder optional Description
Name des Arbeitsbereichs Wahlfrei Die Log Analytics Arbeitsbereichs-ID oder der Name. Dies kann entweder der eindeutige Bezeichner (GUID) oder der Anzeigename Ihres Arbeitsbereichs sein.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Vertraulich: ❌ | Lokal erforderlich: ❌

Log Analytics: Abrufen von Tabellentypen

Dieses MCP-Tool (Model Context Protocol) listet die verfügbaren Tabellentypen in einem Azure Log Analytics Arbeitsbereich auf. Sie gibt die Namen der Tabellentypen zurück. Sie können diese Namen verwenden, wenn Sie Abfragen für Azure Monitor Protokolle schreiben.

Beispiele für Prompts:

  • Alle verfügbaren Tabellentypen im Log-Analytics-Arbeitsbereich 'prod-law-01' innerhalb der Ressourcengruppe 'rg-prod' auflisten.
  • "Welche Tabellentypen sind in Log Analytics Arbeitsbereichsnamen 'Analysearbeitsbereich' in der Ressourcengruppe 'rg-logs' verfügbar?"
Parameter Erforderlich oder optional Description
Ressourcengruppe Erforderlich Der Name der Azure Ressourcengruppe, die den Arbeitsbereich enthält.
Name des Arbeitsbereichs Erforderlich Der Name oder die ID des Log Analytics Arbeitsbereichs. Sie können die Arbeitsbereichs-GUID oder den Anzeigenamen verwenden.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Vertraulich: ❌ | Lokal erforderlich: ❌

Log Analytics: Protokolle im Arbeitsbereich abfragen

Abfrageprotokolle in einem gesamten Log Analytics-Arbeitsbereich mithilfe der Kusto-Abfragesprache (KQL). Dieses Tool führt arbeitsbereichweite Abfragen aus, die Protokolle für alle Ressourcen und Tabellen im Arbeitsbereich zurückgeben. Dieses Tool ist Teil der MCP-Tools (Model Context Protocol). Sie können beispielsweise fragen: "Zeige alle Fehler in meinem Arbeitsbereich an", "Was ist in den letzten 24 Stunden in meinem Arbeitsbereich passiert?", "Fehlgeschlagene Anforderungen im gesamten Arbeitsbereich auflisten".

Beispiele für Prompts:

  • "Protokolle mit Abfragefehlern aus der Tabelle 'Syslog' in Log Analytics Arbeitsbereich 'my-workspace' in der Ressourcengruppe 'rg-prod' anzeigen."
Parameter Erforderlich oder optional Description
Abfrage Erforderlich Die KQL-Abfrage (Kusto Query Language), die für den Log Analytics Arbeitsbereich ausgeführt werden soll. Sie können vordefinierte Abfragen nach Namen verwenden: recent zeigt die neuesten Protokolle an, sortiert nach TimeGenerated; errors zeigt Protokolle auf Fehlerebene an, sortiert nach TimeGenerated. Oder stellen Sie eine benutzerdefinierte KQL-Abfrage bereit.
Ressourcengruppe Erforderlich Der Name der Azure Ressourcengruppe, die den Arbeitsbereich enthält.
Tabellenname Erforderlich Der Name der Tabelle, die innerhalb des Arbeitsbereichs abfragt werden soll.
Name des Arbeitsbereichs Erforderlich Die Log Analytics Arbeitsbereichs-ID oder der Name. Sie können entweder die GUID (Globally Unique Identifier) oder den Anzeigenamen des Arbeitsbereichs angeben.
Hours Wahlfrei Die Anzahl der Stunden, die ab jetzt abgerufen werden sollen.
Begrenzung Wahlfrei Die maximale Anzahl der zurückzugebenden Ergebnisse.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Vertraulich: ❌ | Lokal erforderlich: ❌

Log Analytics: Abfrage von Ressourcenprotokollen

Abfragen von Diagnose- und Aktivitätsprotokollen für eine bestimmte Azure Ressource in einem Log Analytics Arbeitsbereich mithilfe der Kusto Query Language (KQL). Dieses Tool filtert Ergebnisse in die angegebene Ressource und führt die bereitgestellte KQL-Abfrage für die ausgewählte Tabelle aus. Zum Beispiel: „Zeigen Sie die Protokolle der Ressource 'app-monitor' für die letzten 24 Stunden an.“

Beispiele für Prompts:

  • Protokolle mit der Abfrage 'aktuell' für die Ressourcen-ID '/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg-prod/providers/Microsoft.Compute/virtualMachines/my-vm' in der Tabelle 'AzureDiagnostics' anzeigen.
Parameter Erforderlich oder optional Description
Abfrage Erforderlich Die KQL-Abfrage, die für den Log Analytics Arbeitsbereich ausgeführt werden soll. Sie können vordefinierte Abfragen nach Name verwenden: recent Zeigt die neuesten Protokolle an, die nach TimeGenerated sortiert sind. errors Zeigt Protokolle auf Fehlerebene an, die nach TimeGenerated sortiert sind. Stellen Sie andernfalls eine benutzerdefinierte KQL-Abfrage bereit.
Ressourcen-ID Erforderlich Die Azure Ressourcen-ID der abzufragenden Ressource. Beispiel: /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.OperationalInsights/workspaces/<ws>.
Tabellenname Erforderlich Der Name der Tabelle, die innerhalb des Arbeitsbereichs abfragt werden soll.
Hours Wahlfrei Die Anzahl der Stunden, die ab jetzt abgerufen werden sollen.
Begrenzung Wahlfrei Die maximale Anzahl der zurückzugebenden Ergebnisse.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Vertraulich: ❌ | Lokal erforderlich: ❌

Gesundheit: Abrufen der Entitätsgesundheit

Dieses Tool ruft den Integritätsstatus und aktuelle Integritätsereignisse für eine bestimmte Entität in einem Azure Monitor Integritätsmodell ab. Das MCP-Tool (Model Context Protocol) meldet den Gesundheitszustand auf Anwendungsebene basierend auf benutzerdefinierten Gesundheitsmodellen, nicht auf der grundlegenden Ressourcenverfügbarkeit. Verwenden Sie für die grundlegende Ressourcenverfügbarkeit Azure Resource Health oder das Tool azmcp_resourcehealth_availability-status_get. Verwenden Sie azmcp_monitor_workspace_log_query, um Protokolle in einem Log Analytics Arbeitsbereich abzufragen. Verwenden Sie azmcp_monitor_resource_log_query, um Protokolle für eine bestimmte Azure Ressource abzufragen.

Beispiele für Prompts:

  • Zeige mir den Gesundheitsstatus der Entität 'order-service' mithilfe des Gesundheitsmodells 'app-health-v1' in der Ressourcengruppe 'rg-prod'.
Parameter Erforderlich oder optional Description
Name der Entität Erforderlich Die Entität, für die die Gesundheit ermittelt werden soll.
Gesundheitsmodell Erforderlich Der Name des Gesundheitsmodells, für das die Gesundheit abgerufen werden soll.
Ressourcengruppe Erforderlich Der Name der Azure Ressourcengruppe. Diese Ressourcengruppe ist ein logischer Container für Azure Ressourcen.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Vertraulich: ❌ | Lokal erforderlich: ❌

Metriken: Abfragemetriken

Abfragen Azure Monitor Metriken für eine Ressource. Dieses Tool gibt Zeitreihendaten für die angegebenen Metriken zurück, wodurch Sie die Ressourcenleistung und -verfügbarkeit analysieren können. Dieses Tool ist Teil der MCP-Tools (Model Context Protocol).

Beispiele für Prompts:

  • "Analysieren Sie Leistungstrends und Reaktionszeiten für die Application Insights-Ressource "appinsights-prod" mit Metriken "Anforderungen/Dauer" und dem Metriknamespace "microsoft.insights/components".
  • "Überprüfen Sie die Verfügbarkeitsmetrik "availabilityResults/availabilityPercentage" für die Application Insights-Ressource "appinsights-staging" mit dem metrischen Namespace "microsoft.insights/components"?"
  • "Rufen Sie die Metrik 'Anforderungen/Dauer' mit Aggregation 'Mittelwert' und Intervall 'PT1M' für die Ressource 'appinsights-prod' mithilfe des metrischen Namespace 'microsoft.insights/components' ab."
  • Untersuchen Sie Fehlerraten und fehlgeschlagene Anforderungen für die Application Insights-Ressource 'appinsights-prod' mithilfe der Metriken 'Anforderungen/Fehlgeschlagen', 'Ausnahmen/Anzahl' und dem Metrik-Namespace 'microsoft.insights/components'.
  • Abfrage der Metrik 'requests/count' für den Ressourcentyp 'Microsoft.Insights/components', Ressource 'appinsights-qa', mit Metrik-Namespace 'microsoft.insights/components' und Intervall 'PT5M'.
  • Was ist die Rate der Anfragen pro Sekunde mit der Metrik 'requests/count' und der Aggregation 'Count' für die Application Insights-Ressource 'appinsights-prod' und den metrischen Namespace 'microsoft.insights/components'?
Parameter Erforderlich oder optional Description
Metriknamen Erforderlich Die Namen von Metriken, die abgefragt werden sollen, durch Trennzeichen getrennt.
Metrischer Namespace Erforderlich Der Namespace der Metrik, die abgefragt werden soll. Rufen Sie diesen Wert aus dem Azmcp-monitor-metrics-definitions-Tool ab.
Ressourcenname Erforderlich Der Name der Azure Ressource zum Abfragen von Metriken.
Zusammenfassung Wahlfrei Der zu verwendende Aggregationstyp, z. B. Mittelwert, Maximum, Minimum, Total oder Count.
Endzeit Wahlfrei Die Endzeit für die Abfrage im ISO-Format (z. B 2023-01-01T00:00:00Z. ). Wird standardmäßig auf jetzt gesetzt.
Filter Wahlfrei Der OData-Filter, der auf die Metrikabfrage angewendet werden soll.
Interval Wahlfrei Das Zeitintervall für Datenpunkte (z. B. PT1H für 1 Stunde, PT5M für 5 Minuten).
Max. Buckets Wahlfrei Die maximale Anzahl von Zeit-Buckets, die zurückgegeben werden sollen. Der Standardwert beträgt 50.
Ressourcentyp Wahlfrei Der Azure Ressourcentyp (z. B. Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Wenn nicht angegeben, versucht das Tool, den Typ vom Ressourcennamen abzuleiten.
Startzeit Wahlfrei Die Startzeit für die Abfrage im ISO-Format (z. B 2023-01-01T00:00:00Z. ). Standardmäßig wird der Zeitpunkt auf vor 24 Stunden festgelegt.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Vertraulich: ❌ | Lokal erforderlich: ❌

Metriken: Metrikdefinitionen auflisten

Dieses Tool listet Metrikdefinitionen für eine Azure Ressource auf. Es gibt Metadaten zu jeder Metrik zurück, einschließlich Namespaces, Beschreibungen und Aggregationstypen, sodass Sie bestimmen können, welche Metriken nach einer Ressource gesucht werden sollen.

Beispiele für Prompts:

  • "Abrufen von Metrikdefinitionen für den Ressourcennamen "app-insights-prod".
  • Listen Sie die Metrikdefinitionen für den Ressourcennamen 'mystorageacct' mit dem Ressourcentyp 'Microsoft.Storage/storageAccounts' und dem Metrik-Namespace 'Storage' auf.
  • "Anzeigen von Metrikdefinitionen für den Ressourcennamen 'vm-prod-01' mit suchzeichenfolge 'cpu' und Grenzwert '20'."
Parameter Erforderlich oder optional Description
Ressourcenname Erforderlich Der Name der Azure Ressource zum Abfragen von Metriken.
Begrenzung Wahlfrei Die maximale Anzahl der zurückzugebenden Metrikdefinitionen. Der Standardwert ist 10.
Metrischer Namespace Wahlfrei Der Metriknamespace, der abgefragt werden soll. Rufen Sie diesen Wert aus dem Azmcp-monitor-metrics-definitions-Tool ab.
Ressourcentyp Wahlfrei Der Azure Ressourcentyp (z. B. Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Wenn Sie ihn nicht angeben, versucht das Tool, den Ressourcentyp vom Ressourcennamen abzuleiten.
Suchabfrage Wahlfrei Eine Zeichenfolge zum Filtern der Metrikdefinitionen. Der Filter führt eine case-insensitive Übereinstimmung von Metrikname und -beschreibung durch.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Vertraulich: ❌ | Lokal erforderlich: ❌

Instrumentierung: Lernressource abrufen

Dieses Tool listet alle verfügbaren Lernressourcen für Azure Monitor Instrumentation auf oder ruft den Inhalt einer bestimmten Ressource anhand des Pfads ab. Standardmäßig gibt das Tool alle Ressourcenpfade zurück. Wenn Sie einen Pfad angeben, gibt das Tool den vollständigen Ressourceninhalt zurück. Verwenden Sie das Orchestrator-Starttool, um eine Anwendung zu instrumentieren.

Beispiele für Prompts:

  • "Holen Sie sich die Onboarding-Lernressource unter Pfad "Onboarding/get-started.md".
  • Zeigen Sie mir den Inhalt der Azure Monitor Onboarding-Lernressource im Pfad 'onboarding/quickstart.md'.
  • Rufen Sie den Inhalt der Azure Monitor Lernressourcen-Datei unter dem Pfad 'samples/instrumentation-guide.html' ab.
  • "Alle Azure Monitor Onboarding-Lernressourcen auflisten."
  • "Alle Lernressourcenpfade für Azure Monitor Instrumentierung anzeigen."
  • "Welche Lernressourcen stehen für Azure Monitor Instrumentierungs-Onboarding zur Verfügung?"
Parameter Erforderlich oder optional Description
Pfad Wahlfrei Lernressourcenpfad.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Vertraulich: ❌ | Lokal erforderlich: ✅

Instrumentierung: Initialisierung der Orchestrierung

Beginnen Sie hier mit den MCP-Tools (Model Context Protocol), die Azure Monitor instrumentieren. Dieses Tool analysiert den Arbeitsbereich und gibt die erste auszuführende Aktion zurück. Nachdem Sie die Aktion ausgeführt haben, rufen Sie orchestrator-next auf, um fortzufahren. Folgen Sie der Aktion im instruction Feld genau.

Beispiele für Prompts:

  • Starten Sie die Azure Monitor Instrumentierungsorchestrierung für den Arbeitsbereichspfad "/home/dev/workspace-monitoring".
  • Analysieren Sie den Arbeitsbereichspfad '/src/projects/my-app-workspace' und geben Sie den ersten Schritt der Instrumentierung für Azure Monitor zurück.
  • Beginnen Sie mit der geführten Azure Monitor-Einführung für das Projekt im Arbeitsbereichspfad "/workspace/my-app", und nennen Sie mir Schritt Eins.
Parameter Erforderlich oder optional Description
Arbeitsbereichspfad Erforderlich Absoluter Pfad zum Projektordner.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ❌ | Offene Welt: ❌ | Schreibgeschützt: ❌ | Vertraulich: ❌ | Lokal erforderlich: ✅

Instrumentierung: Fortsetzung der Orchestrierung

Rufen Sie die nächste Instrumentierungsaktion ab, nachdem Sie die aktuelle Aktion abgeschlossen haben.

Dieses Tool ist Teil der Model Context Protocol (MCP)-Suite.

Nachdem Sie die genaue instruction Ausführung aus der vorherigen Antwort ausgeführt haben, führen Sie dieses Tool aus, um die nächste Aktion zu erhalten.

Erwarteter Workflow:

  1. Sie erhalten eine Aktion von orchestrator-start oder orchestrator-next.
  2. Sie führen das instruction Feld genau aus.
  3. Sie führen dieses Tool mit einem knappen Completion note aus, um die nächste Aktion zu erhalten.

Gibt zurück: Die nächste auszuführende Aktion oder complete-Status, wenn alle Schritte abgeschlossen sind.

Beispiele für Prompts:

  • Nach Abschluss des vorherigen Azure Monitor Instrumentierungsschritts rufen Sie die nächste Aktion für die Sitzungs-ID 'session-abc123' mit der Abschlussnotiz 'UseAzureMonitor() zu Program.cs hinzugefügt' ab.
  • Rufen Sie die nächste Onboarding-Aktion für die Sitzungs-ID "workspace/session-2026" mit der Abschlussnotiz 'dotnet add package Microsoft.ApplicationInsights ausgeführt' ab.
  • Nachdem der vorherige Instrumentierungsschritt abgeschlossen wurde, geben Sie den nächsten Schritt für die Sitzungs-ID „session-789xyz“ mit der Abschlussnotiz „Aktualisierte appsettings.json zum Aktivieren von Application Insights“ zurück.
Parameter Erforderlich oder optional Description
Vervollständigungsnotiz Erforderlich Ein Satz, der beschreibt, was Sie ausgeführt haben, z. B. "Ran dotnet add package command" oder "Added UseAzureMonitor() to Program.cs".
Sitzungs-ID Erforderlich Der Arbeitsbereichspfad wird von orchestrator-start als sessionId zurückgegeben.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ❌ | Offene Welt: ❌ | Schreibgeschützt: ❌ | Vertraulich: ❌ | Lokal erforderlich: ✅

Instrumentierung: Brownfield-Analyse senden

Sendet die Ergebnisse der Brownfield-Codeanalyse, nachdem orchestrator-start den Status analysis_needed zurückgegeben hat. Dieses Tool ist Teil des MCP-Workflows (Model Context Protocol). Sie müssen die Quelldateien des Arbeitsbereichs überprüfen und die Analysevorlage ausfüllen, bevor Sie dieses Tool aufrufen. Nachdem dieses Tool erfolgreich abgeschlossen wurde, fahren Sie mit orchestrator-next fort.

Beispiele für Prompts:

  • Senden Sie die Ergebnisse der Brownfield-Codeanalyse JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' an die Azure Monitor Instrumentierungssitzung 'workspace-7a3b', nachdem die Analyse angefordert wurde.
  • Die Migrations-Orchestrierung wird fortgesetzt, indem die Ergebnisse JSON '{"serviceOptions":{"found":true,"details":"AddApplicationInsightsTelemetry used"},"initializers":[],"Prozessoren":[],"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' zur Sitzung 'sess-01234' übermittelt werden.
  • Senden Sie die abgeschlossene Brownfield-Telemetrieanalyse als Findings JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":{"found":true},"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":{"found":true}}' für die Onboarding-Session 'session-9f3b'.
Parameter Erforderlich oder optional Description
Json der Ergebnisse Erforderlich JSON-Objekt mit Brownfield-Analyseergebnissen. Erforderliche Eigenschaften: serviceOptions (Ergebnisse der Dienstoptionen aus der Analyse des AddApplicationInsightsTelemetry()-Aufrufs, null, wenn nicht gefunden), Initialisierer (Telemetrieinitialisierungsergebnisse aus der Analyse von ITelemetryInitializer- oder IConfigureOptions<TelemetryConfiguration>-Implementierungen, null, wenn keine gefunden wurde), Prozessoren (Telemetrieprozessorergebnisse aus der Analyse von ITelemetryProcessor-Implementierungen, null, wenn keine gefunden wurden), clientUsage (TelemetryClient-Verwendungsergebnisse aus der Analyse direkter TelemetryClient-Verwendung, null, wenn nicht gefunden), Sampling (Ergebnisse der benutzerdefinierten Samplingkonfiguration, null, wenn kein benutzerdefiniertes Sampling), TelemetryPipeline (benutzerdefinierte ITelemetryChannel- oder TelemetrySinks-Verwendungsergebnisse, null, wenn nicht gefunden), Protokollierung (expliziter Logger-Anbieter und Filterergebnisse, null, wenn nicht gefunden). Übergeben Sie für Abschnitte, die nicht in der Codebasis vorhanden sind, ein leeres Standardobjekt, z. B. gefunden: false oder hasCustomSampling: false, anstelle von NULL.
Sitzungs-ID Erforderlich Der Arbeitsbereichspfad wird als sessionId von orchestrator-start zurückgegeben.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ❌ | Offene Welt: ❌ | Schreibgeschützt: ❌ | Vertraulich: ❌ | Lokal erforderlich: ✅

Instrumentierung: Auswahl zur Verbesserung senden

Senden Sie die Auswahl des Benutzers für Erweiterungen, nachdem orchestrator-start den Status enhancement_available zurückgegeben hat. Präsentieren Sie dem Benutzer die Auswahlmöglichkeiten für die Erweiterung, und rufen Sie dieses Tool mit den ausgewählten Erweiterungsschlüsseln auf. Sie können mehrere Verbesserungen auswählen, indem Sie eine kommagetrennte Liste übergeben, beispielsweise redis,processors. Nachdem dieses Tool erfolgreich abgeschlossen wurde, fahren Sie mit orchestrator-next fort.

Beispiele für Prompts:

  • "Übermitteln Sie Verbesserungsschlüssel 'redis,Prozessoren' für Azure Monitor Instrumentation Sitzungs-ID 'Workspaces/my-app/session-abc123'."
  • "Setzen Sie den Verbesserungsfluss der Instrumentierung fort, indem Sie Erweiterungsschlüssel "redis" an die Sitzungs-ID "workspaces/prod-app/session-789" senden."
  • "Ausgewählte Erweiterungsschlüssel 'entityframework,otlp' für die Onboarding-Sitzungs-ID 'arbeitsbereiche/onboard/session-456' senden."
Parameter Erforderlich oder optional Description
Verbesserungsschlüssel Erforderlich Mindestens ein Erweiterungsschlüssel, kommagetrennt (z.B. redis, redis,processors, entityframework,otlp).
Sitzungs-ID Erforderlich Der Arbeitsbereichspfad wird als sessionId von orchestrator-start zurückgegeben.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ❌ | Offene Welt: ❌ | Schreibgeschützt: ❌ | Vertraulich: ❌ | Lokal erforderlich: ✅

Arbeitsmappen: Arbeitsmappen anzeigen

Führen Sie mit Resource Graph schnelle Metadatenabfragen in Azure Workbooks durch. Mit diesem Tool können Sie Arbeitsmappen in verschiedenen Bereichen ermitteln, filtern und zählen.

Es gibt Arbeitsmappenmetadaten zurück, einschließlich id, name, location, category und Zeitstempeln. Standardmäßig wird der vollständige Arbeitsmappeninhalt nicht zurückgegeben (serializedData) – verwenden Sie dafür das Anzeigetool oder setzen Sie Output format auf full.

Standardmäßig zielt die Suche auf Arbeitsmappen in Ihrem aktuellen Azure Kontext (Mandant/Abonnement) ab. Sie können den Resource group Suchbereich explizit angeben. Das Tool gibt standardmäßig die serverseitige Gesamtanzahl zurück. Die maximale Anzahl an zurückgegebenen Ergebnissen liegt bei 50, mit einem oberen Limit von 1000; dies können Sie mit Max results anpassen. Wählen Sie Output format als summary für minimale Token oder full für die vollständige serializedData Ausgabe.

Beispiele für Prompts:

  • "Alle Arbeitsmappen in der Ressourcengruppe 'monitoring-rg' anzeigen."
  • Liste die freigegebenen Arbeitsmappen in der Ressourcengruppe „prod-rg“ auf.
  • "Welche Arbeitsmappen wurden nach 2024-01-15 in der Ressourcengruppe 'analytics-rg' geändert?"
Parameter Erforderlich oder optional Description
Ressourcengruppe Wahlfrei Der Name der Azure Ressourcengruppe, um den Suchbereich zu beschränken.
Kategorie Wahlfrei Filtern von Arbeitsmappen nach Kategorie (z. B workbook. , sentinel, TSG). Wenn nicht angegeben, werden alle Kategorien zurückgegeben.
Gesamtanzahl einschließen Wahlfrei Schließen Sie die Gesamtanzahl aller übereinstimmenden Arbeitsmappen in die Antwort ein (Standard: true).
Kind Wahlfrei ** Arbeitsmappen nach Art filtern (z. B. shared, user). Wenn nicht angegeben, werden alle Arten zurückgegeben.
Max. Ergebnisse Wahlfrei Maximale Anzahl der zurückzugebenden Ergebnisse (Standard: 50, max: 1000).
Geändert am Wahlfrei Arbeitsmappen filtern, die nach diesem Datum geändert wurden (z. B 2024-01-15. ISO 8601-Format).
Name enthält Wahlfrei Filtert Arbeitsmappen, in denen der Anzeigename diesen Text enthält (Groß-/Kleinschreibung wird nicht beachtet).
Ausgabeformat Wahlfrei Ausgabeformat: summary (NUR ID und Name, minimale Token), standard (Metadaten ohne Inhalt, Standard), full (einschließlich serializedData).
Quell-ID Wahlfrei Filtern von Arbeitsmappen nach Quellressourcen-ID (z. B. /subscriptions/abc123/resourceGroups/prod/providers/Microsoft.Insights/components/myapp). Wenn nicht angegeben, werden alle Arbeitsmappen zurückgegeben.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Vertraulich: ❌ | Lokal erforderlich: ❌

Arbeitsmappen: Anzeigen von Arbeitsmappendetails

Rufen Sie vollständige Arbeitsmappendetails über die Azure Resource Manager-API (ARM) ab, einschließlich des Inhalts serializedData. Mit diesem Befehl können Sie die vollständige Arbeitsmappendefinition einschließlich der Visualisierungs-JSON abrufen.

Es liefert vollständige Arbeitsmappeneigenschaften, serializedData, Tags und ETag. Sie können mehrere Workbook IDs für Stapelvorgänge bereitstellen. Der Befehl meldet Teilfehler für einzelne Arbeitsmappen. Um eine bessere Leistung zu erzielen, verwenden Sie zuerst das Listentool, um Arbeitsmappen zu ermitteln, und verwenden Sie dann die Anzeige für bestimmte Arbeitsmappen.

Beispiele für Prompts:

  • Zeigen Sie mir die Details der Arbeitsmappe mit der Ressourcen-ID '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1'.
  • Erhalte die vollständige Definition der Arbeitsmappe "/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2".
Parameter Erforderlich oder optional Description
Arbeitsmappen-IDs Erforderlich Die Azure-Ressourcen-IDs der abzurufenden Arbeitsmappen. Unterstützt mehrere Werte für Batchvorgänge.

Werkzeugannotation Hinweise:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Vertraulich: ❌ | Lokal erforderlich: ❌

Arbeitsmappen: Arbeitsmappe erstellen

Erstellen Sie eine neue Arbeitsmappe in der angegebenen Ressourcengruppe und dem angegebenen Abonnement. Sie können den Anzeigenamen und den serialisierten JSON-Inhalt für die Arbeitsmappe festlegen. Dieser Befehl gibt die erstellten Arbeitsmappeninformationen nach erfolgreichem Abschluss zurück.

Beispiele für Prompts:

  • "Erstellen Sie eine neue Arbeitsmappe mit dem Namen 'Performance Dashboard' in der Ressourcengruppe 'monitoring-rg' mit dem serialisierten Inhalt für ein einfaches Notizbuch."
  • "Erstellen Sie eine Arbeitsmappe namens "Infrastrukturübersicht" in der Ressourcengruppe "prod-rg" mit Inhalten, die VM-Metriken anzeigen."
Parameter Erforderlich oder optional Description
Anzeigename Erforderlich Der Anzeigename der Arbeitsmappe.
Ressourcengruppe Erforderlich Der Name der Azure Ressourcengruppe, die die Arbeitsmappe enthält.
Serialisierte Inhalte Erforderlich Der serialisierte JSON-Inhalt der Arbeitsmappe.
Quell-ID Wahlfrei Die verknüpfte Ressourcen-ID für die Arbeitsmappe. Standardmäßig ist dies azure monitor.

Werkzeugannotation Hinweise:

Destruktiv: ✅ | Idempotent: ❌ | Offene Welt: ❌ | Schreibgeschützt: ❌ | Vertraulich: ❌ | Lokal erforderlich: ❌

Arbeitsmappen: Arbeitsmappe aktualisieren

Aktualisieren Sie die Eigenschaften einer vorhandenen Azure Arbeitsmappe, indem Sie neue Schritte hinzufügen, Inhalte ändern oder den Anzeigenamen ändern. Diese Aktion gibt die aktualisierten Arbeitsmappendetails zurück. Sie benötigen die Ressourcen-ID der Arbeitsmappe und können entweder neuen serialisierten Inhalt oder einen neuen Anzeigenamen angeben.

Beispiele für Prompts:

  • Aktualisieren Sie die Arbeitsmappe „/subscriptions/abc123/resourceGroups/monitoring-rg/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1“ mit dem Anzeigenamen „Monatlicher Bericht“.
  • Ändern des serialisierten Inhalts der Arbeitsmappe '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2', um ein neues Metrikdiagramm einzuschließen.
Parameter Erforderlich oder optional Description
Arbeitsmappen-ID Erforderlich Die Azure Ressourcen-ID der zu aktualisierenden Arbeitsmappe.
Anzeigename Wahlfrei Der Anzeigename der Arbeitsmappe.
Serialisierte Inhalte Wahlfrei Der serialisierte JSON-Inhalt der Arbeitsmappe.

Werkzeugannotation Hinweise:

Destruktiv: ✅ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ❌ | Vertraulich: ❌ | Lokal erforderlich: ❌

Arbeitsmappen: Arbeitsmappen löschen

Löschen Sie eine oder mehrere Arbeitsmappen anhand ihrer Azure Ressourcen-IDs. Mit diesem Befehl wird für Arbeitsmappen eine Soft-Löschung ausgeführt und sie werden für 90 Tage aufbewahrt. Sie können sie bei Bedarf aus dem Papierkorb über das Azure Portal wiederherstellen.

Für Batchvorgänge können Sie mehrere Workbook IDs Werte bereitstellen. Der Befehl meldet Teilfehler pro Arbeitsmappe und stellt sicher, dass sich einzelne Fehler nicht auf den gesamten Batchvorgang auswirken.

Weitere Informationen finden Sie unter Manage Azure Monitor Arbeitsmappen.

Beispiele für Prompts:

  • "Löschen Sie die Arbeitsmappe mit der Ressourcen-ID '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft. Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1'."
  • "Entfernen Sie die Arbeitsmappen mit Ressourcen-IDs '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' und '/subscriptions/def456/resourceGroups/analytics-rg/providers/Microsoft.Insights/workbooks/c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3'."
Parameter Erforderlich oder optional Description
Arbeitsmappen-IDs Erforderlich Die Azure Ressourcen-IDs der zu löschenden Arbeitsmappen. Unterstützt mehrere Werte für Batchvorgänge.

Werkzeugannotation Hinweise:

Destruktiv: ✅ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ❌ | Vertraulich: ❌ | Lokal erforderlich: ❌

Verwandte Inhalte

  • Last updated on