Azure narzędzia serwera MCP dla Azure Monitor i skoroszytów

Serwer Azure Model Context Protocol (MCP) umożliwia zarządzanie zasobami Azure Monitor i skoroszytami przy użyciu monitów języka naturalnego. Możesz wykonywać zapytania dotyczące obszarów roboczych Log Analytics, analizować dane operacyjne, monitorować kondycję zasobów, pobierać metryki wydajności, zarządzać testami internetowymi dostępności, organizować przepływy pracy instrumentacji i zarządzać Azure Monitor skoroszytami.

Azure Monitor pomaga zmaksymalizować dostępność i wydajność aplikacji i usług. Zapewnia kompleksowe rozwiązanie do zbierania, analizowania i działania na podstawie danych telemetrycznych z chmury i środowisk lokalnych.

Skoroszyty udostępniają elastyczną platformę do analizy danych i tworzenia bogatych raportów wizualnych w portalu Azure. Umożliwiają one korzystanie z wielu źródeł danych z różnych części Azure i łączenie ich w ujednolicone interaktywne doświadczenia. Skoroszyty umożliwiają łączenie wielu rodzajów wizualizacji i analiz, dzięki czemu doskonale nadają się do swobodnej eksploracji. Aby uzyskać więcej informacji, zobacz dokumentację Azure Monitor workbooks.

Uwaga / Notatka

parametry Tool: narzędzia Azure MCP Server definiują parametry danych potrzebnych do wykonywania zadań. Niektóre z tych parametrów są specyficzne dla każdego narzędzia i zostały opisane tutaj. Inne parametry są globalne i współużytkowane przez wszystkie narzędzia. Aby uzyskać więcej informacji, zobacz Parametry narzędzia.

Dziennik aktywności: pobieranie dzienników aktywności

Wyświetla listę dzienników aktywności usługi Azure Monitor dla określonego zasobu Azure z ostatnich określonych godzin. To narzędzie ułatwia zrozumienie historii wdrażania zasobów, zmian konfiguracji i wzorców dostępu. Zwraca zdarzenia dziennika aktywności, które obejmują sygnaturę czasową, nazwę operacji, stan i informacje o obiekcie wywołującym. Skorzystaj z wyników, aby zbadać nieudane wdrożenia, nieoczekiwane zmiany lub problemy z dostępem.

Przykładowe monity obejmują:

• "Wyświetl listę dzienników aktywności z ostatnich 720 godzin dla zasobu "webapp-prod".

Parameter	Wymagane lub opcjonalne	Description
Nazwa zasobu	Wymagane	Nazwa zasobu Azure do pobrania dzienników aktywności.
Poziom zdarzenia	Opcjonalnie	Poziom dzienników aktywności do pobrania. Prawidłowe poziomy to: Critical, Error, Informational, Verbose, Warning. Jeśli nie zostanie podane, zwraca wszystkie poziomy.
Hours	Opcjonalnie	Liczba godzin wstecz do pobrania dzienników aktywności.
Typ zasobu	Opcjonalnie	Typ zasobu Azure (na przykład 'Microsoft.Storage/storageAccounts'). Podaj to tylko w razie potrzeby, aby rozróżnić wiele zasobów o tej samej nazwie.
Top	Opcjonalnie	Maksymalna liczba dzienników aktywności do pobrania.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	✅	❌	✅	❌	❌

Testy sieci Web: tworzenie lub aktualizowanie testu internetowego

Część narzędzi protokołu MCP (Model Context Protocol), to narzędzie tworzy lub aktualizuje standardowy test internetowy w Azure Monitor w celu sprawdzenia dostępności punktu końcowego. Określasz ustawienia monitorowania, takie jak adres URL, częstotliwość, lokalizacje i oczekiwane odpowiedzi. Jeśli test nie istnieje, to narzędzie go utworzy; w przeciwnym razie aktualizuje istniejący test przy użyciu nowych ustawień.

Przykładowe monity obejmują:

• Utwórz nowy standardowy test sieci Web z zasobem 'webtest-prod-availability' w grupie zasobów 'rg-prod-monitoring' i skojarz go ze składnikiem AppInsights '/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod'.
• Zaktualizuj istniejący standardowy test sieci Web dla zasobu webtest "webtest-prod-availability" w grupie zasobów "rg-prod-monitoring", aby połączyć go z komponentem AppInsights "/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod".

Parameter	Wymagane lub opcjonalne	Description
Grupa zasobów	Wymagane	Nazwa grupy zasobów Azure.
Zasób testu internetowego	Wymagane	Nazwa zasobu Web Test, na którym należy działać.
Składnik Appinsights	Opcjonalnie	Identyfikator zasobu składnika usługi Application Insights do powiązania z testem internetowym.
Opis	Opcjonalnie	Krótki opis testu internetowego.
Enabled	Opcjonalnie	Czy test internetowy jest włączony.
Oczekiwany kod stanu	Opcjonalnie	Oczekiwany kod stanu HTTP.
Obserwowanie przekierowań	Opcjonalnie	Czy należy postępować zgodnie z przekierowaniami HTTP.
Częstotliwość	Opcjonalnie	Częstotliwość testowania w sekundach. Obsługiwane wartości: 300, 600, 900.
Headers	Opcjonalnie	Nagłówki HTTP do uwzględnienia w żądaniu jako pary KEY=VALUE rozdzielane przecinkami.
Czasownik HTTP	Opcjonalnie	Metoda HTTP do użycia, na przykład get lub post.
Ignoruj kod stanu	Opcjonalnie	Czy ignorować walidację kodu stanu.
Lokalizacja	Opcjonalnie	Lokalizacja, w której jest tworzony zasób testu internetowego. Powinno to być zgodne z lokalizacją składnika usługi Application Insights.
Analizowanie żądań	Opcjonalnie	Czy analizować żądania zależne.
Treść żądania	Opcjonalnie	Ciało do wysłania z żądaniem.
Żądanie adresu URL	Opcjonalnie	Bezwzględny adres URL do przetestowania.
Ponawianie próby włączone	Opcjonalnie	Określa, czy ponowne próby są włączone.
Sprawdzanie protokołu SSL	Opcjonalnie	Czy należy zweryfikować certyfikaty SSL.
Sprawdzanie okresu istnienia protokołu SSL	Opcjonalnie	Liczba dni sprawdzania okresu istnienia certyfikatu SSL.
Limit czasu	Opcjonalnie	Limit czasu oczekiwania na żądanie w sekundach. Obsługiwane wartości: 30, 60, 90, 120.
Nazwa testu sieci Web	Opcjonalnie	Nazwa testu w zasobie testu internetowego.
Lokalizacje testów sieci Web	Opcjonalnie	Rozdzielona przecinkami lista lokalizacji do uruchomienia testu. Lokalizacja oznacza geolokacyjny tag populacyjny dla testów dostępności.
Test sieci Web	Opcjonalnie	Konfiguracja testu sieci Web.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
✅	✅	❌	❌	❌	❌

Testy sieci Web: pobierz test sieci Web

To narzędzie pobiera szczegółowe informacje dotyczące określonego testu internetowego lub wyświetla listę wszystkich testów sieci Web. Po określeniu zasobu Webtest to narzędzie zwraca szczegółowe informacje dotyczące tego testu internetowego. Jeśli nie określisz zasobu Webtest, to narzędzie zwróci listę wszystkich testów sieci Web w subskrypcji i można filtrować listę według grupy zasobów.

Przykładowe monity obejmują:

• Pobierz szczegóły testu sieci Web dla zasobu testu sieci Web „webtest-prod” w ramach mojej subskrypcji w grupie zasobów „rg-monitoring”.
• Wyświetl wszystkie zasoby testów sieci Web w mojej subskrypcji.
• "Wyświetl wszystkie zasoby testu sieci Web w mojej subskrypcji w grupie zasobów "rg-prod".

Parameter	Wymagane lub opcjonalne	Description
Zasób testu internetowego	Opcjonalnie	Nazwa zasobu Web Test, na którym należy działać.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	✅	❌	✅	❌	❌

Log Analytics: Lista obszarów roboczych

To narzędzie wyświetla listę Log Analytics obszarów roboczych w subskrypcji. Pobiera nazwę, identyfikator, lokalizację i inne właściwości poszczególnych obszarów roboczych. Można go użyć do identyfikowania obszarów roboczych przed wykonaniem zapytań dotyczących dzienników lub sprawdzeniem ustawień obszaru roboczego.

Przykładowe monity obejmują:

• "Wymień obszary robocze Log Analytics w mojej subskrypcji"
• Wyświetl moje obszary robocze Log Analytics.
• Uzyskaj dostęp do obszarów roboczych Log Analytics w mojej subskrypcji.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	✅	❌	✅	❌	❌

Log Analytics: Wyświetlanie listy tabel

To narzędzie wyświetla listę wszystkich tabel w obszarze roboczym Log Analytics. Na przykład wyświetl listę tabel w obszarze roboczym "prod-law" w grupie zasobów "rg-monitoring", aby zobaczyć dostępne kolumny i typy danych. Zwraca nazwy tabel i schematy używane do tworzenia zapytań języka Kusto Query Language (KQL). Filtr można filtrować według typu tabeli, na przykład CustomLog lub AzureMetrics.

Przykładowe monity obejmują:

• "Wyświetl listę wszystkich tabel w obszarze roboczym Log Analytics "prod-law" typu tabeli "CustomLog" w grupie zasobów "rg-prod".
• Pokaż tabele typu "AzureMetrics" dla obszaru roboczego "f1b2c3d4-5678-90ab-cdef-1234567890ab" w grupie zasobów "rg-monitoring".

Parameter	Wymagane lub opcjonalne	Description
Grupa zasobów	Wymagane	Nazwa grupy zasobów Azure.
Nazwa obszaru roboczego	Wymagane	Identyfikator lub nazwa obszaru roboczego Log Analytics. Może to być unikatowy identyfikator (GUID) lub nazwa wyświetlana obszaru roboczego.
Typ tabeli	Wymagane	Typ tabeli, według którego należy filtrować.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	✅	❌	✅	❌	❌

Log Analytics: Pobieranie typów tabel

To narzędzie protokołu MCP (Model Context Protocol) zawiera listę dostępnych typów tabel w obszarze roboczym Azure Log Analytics. Zwraca nazwy typów tabel. Te nazwy można używać podczas pisania zapytań względem dzienników Azure Monitor.

Przykładowe monity obejmują:

• Wypisz wszystkie dostępne typy tabel w obszarze roboczym Log Analytics o nazwie "prod-law-01" w grupie zasobów "rg-prod".
• "Jakie typy tabel są dostępne w Log Analytics nazwa obszaru roboczego "analytics-workspace" w grupie zasobów "rg-logs"?"

Parameter	Wymagane lub opcjonalne	Description
Grupa zasobów	Wymagane	Nazwa grupy zasobów Azure.
Nazwa obszaru roboczego	Wymagane	Nazwa lub identyfikator obszaru roboczego Log Analytics. Możesz użyć identyfikatora GUID obszaru roboczego lub nazwy wyświetlanej.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	✅	❌	✅	❌	❌

Log Analytics: Wykonywanie zapytań dotyczących dzienników obszaru roboczego

Przeszukuj dzienniki w całym obszarze roboczym usługi Log Analytics za pomocą języka zapytań Kusto (KQL). To narzędzie uruchamia zapytania w całym obszarze roboczym, które zwracają dzienniki z wszystkich zasobów i tabel w obszarze roboczym. To narzędzie jest częścią narzędzi protokołu MCP (Model Context Protocol). Możesz na przykład zapytać: "pokaż wszystkie błędy w moim obszarze roboczym", "co się stało w moim obszarze roboczym w ciągu ostatnich 24 godzin", "wyświetl żądania, które zakończyły się niepowodzeniem w obszarze roboczym".

Przykładowe monity obejmują:

• Pokaż dzienniki z zapytaniem "errors" z tabeli "Syslog" w obszarze roboczym usługi Log Analytics "my-workspace" w grupie zasobów "rg-prod".

Parameter	Wymagane lub opcjonalne	Description
Zapytanie	Wymagane	Zapytanie w języku zapytań Kusto (KQL) uruchamiane w przestrzeni roboczej Log Analytics. Można użyć wstępnie zdefiniowanych zapytań według nazwy: recent pokazuje najnowsze dzienniki uporządkowane według czasu wygenerowania; errors pokazuje dzienniki o poziomie błędu uporządkowane według czasu wygenerowania. Możesz też podać niestandardowe zapytanie KQL.
Grupa zasobów	Wymagane	Nazwa grupy zasobów Azure.
Nazwa tabeli	Wymagane	Nazwa tabeli do wykonywania zapytań w obszarze roboczym.
Nazwa obszaru roboczego	Wymagane	Identyfikator lub nazwa obszaru roboczego Log Analytics. Możesz podać globalnie unikatowy identyfikator (GUID) lub nazwę wyświetlaną obszaru roboczego.
Hours	Opcjonalnie	Liczba godzin, od której należy cofnąć się w czasie przy wykonaniu zapytania, zaczynając od teraz.
Limit	Opcjonalnie	Maksymalna liczba wyników do zwrócenia.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	✅	❌	✅	❌	❌

Log Analytics: Wykonywanie zapytań dotyczących dzienników zasobów

Wykonywanie zapytań dotyczących dzienników diagnostycznych i dzienników aktywności dla określonego zasobu Azure w obszarze roboczym Log Analytics przy użyciu języka Kusto Query Language (KQL). To narzędzie filtruje wyniki do określonego zasobu i uruchamia podane zapytanie KQL względem wybranej tabeli. Na przykład poproś "Pokaż dzienniki zasobu "app-monitor" w ciągu ostatnich 24 godzin.

Przykładowe monity obejmują:

• Pokaż dzienniki z zapytaniem 'recent' dla identyfikatora zasobu '/subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/rg-prod/providers/Microsoft.Compute/virtualMachines/my-vm' w tabeli 'AzureDiagnostics'.

Parameter	Wymagane lub opcjonalne	Description
Zapytanie	Wymagane	Zapytanie KQL do wykonania w przestrzeni roboczej Log Analytics. Można użyć wstępnie zdefiniowanych zapytań według nazwy: recent pokazuje najnowsze dzienniki uporządkowane według TimeGenerated; errors pokazuje dzienniki o poziomie błędu uporządkowane według TimeGenerated. W przeciwnym razie podaj niestandardowe zapytanie KQL.
identyfikator zasobu	Wymagane	Identyfikator zasobu Azure do odpytania. Przykład: /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.OperationalInsights/workspaces/<ws>.
Nazwa tabeli	Wymagane	Nazwa tabeli do wykonywania zapytań w obszarze roboczym.
Hours	Opcjonalnie	Liczba godzin, od której należy cofnąć się w czasie przy wykonaniu zapytania, zaczynając od teraz.
Limit	Opcjonalnie	Maksymalna liczba wyników do zwrócenia.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	✅	❌	✅	❌	❌

Modele stanu: Lista modeli stanu

Wyświetla listę wszystkich modeli kondycji w zasobie modelu kondycji Azure Monitor. To narzędzie ułatwia odnajdywanie dostępnych modeli kondycji na potrzeby monitorowania kondycji na poziomie aplikacji. Narzędzie Model Context Protocol (MCP) raportuje kondycję na poziomie aplikacji na podstawie niestandardowych modeli kondycji, a nie podstawowej dostępności zasobów. Aby uzyskać podstawową dostępność zasobów, użyj Azure Resource Health. Aby wykonywać zapytania dotyczące dzienników w obszarze roboczym Log Analytics, użyj azmcp_monitor_workspace_log_query. Aby wykonywać zapytania dotyczące dzienników dla określonego zasobu Azure, użyj azmcp_monitor_resource_log_query.

Przykładowe monity obejmują:

• Wyświetl wszystkie modele kondycji w zasobie modeli kondycji „app-health-monitor” w grupie zasobów „rg-prod”.

Przykładowe polecenie CLI

azmcp monitor healthmodels list \
  [--resource-group <resource-group>]

Wskazówki adnotacji narzędzi:

Destruktywne: ❌ | Idempotentne: ✅ | Open World: ❌ | Tylko do odczytu: ✅ | Tajne: ❌ | Wymagane lokalnie: ❌

Modele stanu: Pobierz model stanu

Pobiera model kondycji o określonej nazwie z zasobu modelu kondycji usługi Azure Monitor. To narzędzie zwraca stan kondycji i ostatnie zdarzenia kondycji dla określonego modelu kondycji. Narzędzie Model Context Protocol (MCP) raportuje kondycję na poziomie aplikacji na podstawie niestandardowych modeli kondycji, a nie podstawowej dostępności zasobów. Aby uzyskać podstawową dostępność zasobów, użyj Azure Resource Health. Aby wykonywać zapytania dotyczące dzienników w obszarze roboczym Log Analytics, użyj azmcp_monitor_workspace_log_query. Aby wykonywać zapytania dotyczące dzienników dla określonego zasobu Azure, użyj azmcp_monitor_resource_log_query.

Przykładowe monity obejmują:

• Pobierz model kondycji „order-service-health” z zasobu modelu kondycji „app-health-monitor” w grupie zasobów „rg-prod”.

Parameter	Wymagane lub opcjonalne	Description
Model kondycji	Wymagane	Nazwa modelu kondycji do pobrania.
Grupa zasobów	Wymagane	Nazwa grupy zasobów Azure.

Uwaga / Notatka

Migracja z wersji 3.0.0-beta.24 i starszych: Polecenie monitor healthmodels entity get zostanie usunięte w wersji 3.0.0-beta.25. Użyj monitor healthmodels list, aby wyświetlić listę wszystkich modeli kondycji, lub monitor healthmodels get, aby pobrać określony model kondycji według nazwy.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	✅	❌	✅	❌	❌

Metryki: Metryki zapytań

Pobierz metryki Azure Monitor dla zasobu. To narzędzie zwraca dane szeregów czasowych dla określonych metryk, pomagając analizować wydajność i dostępność zasobów. To narzędzie jest częścią narzędzi protokołu MCP (Model Context Protocol).

Przykładowe monity obejmują:

• Analiza trendów wydajności i czasów odpowiedzi dla zasobu Application Insights "appinsights-prod" przy użyciu metryk "requests/duration" i przestrzeni nazw metryki "microsoft.insights/components".
• Sprawdź miarę dostępności „availabilityResults/availabilityPercentage” dla zasobu Application Insights „appinsights-staging” przy użyciu przestrzeni nazw metryk „microsoft.insights/components”.
• Pobierz metrykę "requests/duration" z agregacją "Średnia" i okresem "PT1M" dla zasobu "appinsights-prod" przy użyciu przestrzeni nazw "microsoft.insights/components".
• Zbadaj współczynniki błędów i nieudane żądania dla zasobu usługi Application Insights „appinsights-prod” przy użyciu metryk „requests/failed,exceptions/count” i przestrzeni nazw metryki „microsoft.insights/components”.
• Wykonaj zapytanie dotyczące metryki "requests/count" dla typu zasobu "Microsoft.Insights/components", zasobu "appinsights-qa" z interwałem "PT5M" i przestrzenią nazw metryki "microsoft.insights/components".
• "Jaka jest szybkość żądań na sekundę przy użyciu metryki "requests/count" z agregacją "Count" dla zasobu usługi Application Insights "appinsights-prod" i przestrzeni nazw metryki "microsoft.insights/components"?"

Parameter	Wymagane lub opcjonalne	Description
Nazwy metryk	Wymagane	Nazwy metryk do wykonywania zapytań, rozdzielane przecinkami.
Przestrzeń Nazw Metryk	Wymagane	Przestrzeń nazw metryki do wykonywania zapytań. Uzyskaj tę wartość z narzędzia azmcp-monitor-metrics-definitions.
Nazwa zasobu	Wymagane	Nazwa zasobu Azure do wykonywania zapytań o metryki.
Agregacja	Opcjonalnie	Typ agregacji do użycia, taki jak Average, Maximum, Minimum, Total lub Count.
Godzina zakończenia	Opcjonalnie	Godzina zakończenia zapytania w formacie ISO (na przykład 2023-01-01T00:00:00Z). Domyślnie ustawione na teraz.
Filtr	Opcjonalnie	Filtr OData, który ma być stosowany do zapytania dotyczącego metryk.
Interval	Opcjonalnie	Przedział czasu dla punktów danych (na przykład PT1H przez 1 godzinę, PT5M przez 5 minut).
Maksymalna liczba zasobników	Opcjonalnie	Maksymalna liczba przedziałów czasu do zwrócenia. Wartość domyślna to 50.
Typ zasobu	Opcjonalnie	Typ zasobu Azure (na przykład Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Jeśli nie zostanie określony, narzędzie próbuje wywnioskować typ z nazwy zasobu.
Godzina rozpoczęcia	Opcjonalnie	Godzina rozpoczęcia zapytania w formacie ISO (na przykład 2023-01-01T00:00:00Z). Domyślnie ustawiane na 24 godziny temu.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	✅	❌	✅	❌	❌

Metryki: Wyświetlanie listy definicji metryk

To narzędzie wyświetla listę definicji metryk dla zasobu Azure. Zwraca metadane dotyczące każdej metryki, w tym przestrzeni nazw, opisów i typów agregacji, dzięki czemu można określić, które metryki zapytania dla danego zasobu.

Przykładowe monity obejmują:

• "Pobierz definicje metryk dla nazwy zasobu "app-insights-prod".
• Wyświetl definicje metryk dla zasobu o nazwie "mystorageacct" z typem zasobu "Microsoft.Storage/storageAccounts" i przestrzeni nazw metryk "Storage".
• "Pokaż definicje metryk dla nazwy zasobu "vm-prod-01" z ciągiem wyszukiwania "cpu" i limitem "20".

Parameter	Wymagane lub opcjonalne	Description
Nazwa zasobu	Wymagane	Nazwa zasobu Azure do wykonywania zapytań o metryki.
Limit	Opcjonalnie	Maksymalna liczba definicji metryk do zwrócenia. Wartość domyślna to 10.
Przestrzeń Nazw Metryk	Opcjonalnie	Przestrzeń nazw metryki do wykonywania zapytań. Uzyskaj tę wartość z narzędzia azmcp-monitor-metrics-definitions.
Typ zasobu	Opcjonalnie	Typ zasobu Azure (na przykład Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Jeśli nie określisz go, narzędzie spróbuje wywnioskować typ zasobu z nazwy zasobu.
Ciąg wyszukiwania	Opcjonalnie	Łańcuch znaków do filtrowania definicji metryk. Filtr wykonuje dopasowanie bez uwzględniania wielkości liter w nazwie i opisie metryki.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	✅	❌	✅	❌	❌

Instrumentacja: Pobierz materiał edukacyjny

To narzędzie wyświetla listę wszystkich dostępnych zasobów szkoleniowych dotyczących instrumentacji Azure Monitor lub pobiera zawartość określonego zasobu według ścieżki. Domyślnie narzędzie zwraca wszystkie ścieżki zasobów. Jeśli określisz ścieżkę, narzędzie zwróci pełną zawartość zasobu. Aby instrumentować aplikację, użyj narzędzia orchestrator-start.

Przykładowe monity obejmują:

• Pobierz zasób szkoleniowy do wprowadzania ze ścieżki "onboarding/get-started.md".
• Pokaż zawartość zasobu szkoleniowego wprowadzania Azure Monitor pod ścieżką "onboarding/quickstart.md".
• Pobierz zawartość pliku zasobów edukacyjnych Azure Monitor pod ścieżką „samples/instrumentation-guide.html”.
• Wymień wszystkie zasoby szkoleniowe dotyczące wdrażania w Azure Monitor.
• "Pokaż mi wszystkie ścieżki zasobów szkoleniowych dla instrumentacji Azure Monitor."
• Które zasoby szkoleniowe są dostępne na potrzeby wdrażania instrumentacji Azure Monitor?

Parameter	Wymagane lub opcjonalne	Description
Path	Opcjonalnie	Ścieżka zasobu szkoleniowego.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	✅	❌	✅	❌	✅

Instrumentacja: Rozpoczynanie orkiestracji

Zacznij tutaj, aby uzyskać narzędzia do pracy z protokołem MCP (Model Context Protocol), które współdziałają z Azure Monitor. To narzędzie analizuje obszar roboczy i zwraca pierwszą akcję do wykonania. Po wykonaniu akcji, wywołaj orchestrator-next, aby kontynuować. Postępuj dokładnie zgodnie z instrukcjami w polu instruction.

Przykładowe monity obejmują:

• Rozpocznij orkiestrację instrumentacji Azure Monitor dla ścieżki obszaru roboczego "/home/dev/workspace-monitoring".
• "Przeanalizuj ścieżkę obszaru roboczego "/src/projects/my-app-workspace" i zwróć pierwszy krok instrumentacji Azure Monitor".
• Rozpocznij rozpoczynanie Azure Monitor w trybie przewodnika dla projektu w ścieżce obszaru roboczego "/workspace/my-app" i podaj krok pierwszy.

Parameter	Wymagane lub opcjonalne	Description
Ścieżka obszaru roboczego	Wymagane	Ścieżka bezwzględna do folderu obszaru roboczego.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	❌	❌	❌	❌	✅

Instrumentacja: kontynuowanie orkiestracji

Pobierz następne działanie związane z instrumentacją po zakończeniu bieżącego działania.

To narzędzie jest częścią pakietu MCP (Model Context Protocol).

Po wykonaniu dokładnie tego samego instruction co w poprzedniej odpowiedzi, uruchom to narzędzie, aby otrzymać kolejne działanie.

Oczekiwany przepływ pracy:

1. Otrzymujesz polecenie z orchestrator-start lub orchestrator-next.
2. Wykonujesz pole instruction dokładnie.
3. To narzędzie jest uruchamiane z użyciem zwięzłej Completion note, aby uzyskać następny krok.

Zwraca: następną akcję do wykonania lub complete status po wykonaniu wszystkich kroków.

Przykładowe monity obejmują:

• "Po ukończeniu poprzedniego kroku instrumentacji Azure Monitor pobierz następną akcję dla identyfikatora sesji "session-abc123" z notatką ukończenia "Added UseAzureMonitor() to Program.cs".
• Pobierz następną akcję wdrażania dla identyfikatora sesji "workspace/session-2026" z adnotacją "ukończono: Ran dotnet add package Microsoft.ApplicationInsights".
• "Po zakończeniu poprzedniego kroku instrumentacji zwróć następny krok dla identyfikatora sesji "session-789xyz" z notą ukończenia "Zaktualizowano appsettings.json, aby włączyć usługę Application Insights".

Parameter	Wymagane lub opcjonalne	Description
Notatka ukończenia	Wymagane	Jedno zdanie opisujące co zostało wykonane, na przykład „Uruchomiono polecenie dotnet add package” lub „Dodano UseAzureMonitor() do Program.cs”.
identyfikator sesji	Wymagane	Ścieżka obszaru roboczego zwrócona jako identyfikator sesji (sessionId) z funkcji orchestrator-start.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	❌	❌	❌	❌	✅

Instrumentacja: Wysyłanie analizy pola brązowego

Wysyła wyniki analizy kodu brownfield po tym, jak orchestrator-start zwróci status analysis_needed. To narzędzie jest częścią przepływu pracy protokołu MCP (Model Context Protocol). Przed wywołaniem tego narzędzia należy przeskanować pliki źródłowe obszaru roboczego i wypełnić szablon analizy. Po pomyślnym wykonaniu tego narzędzia przejdź do orchestrator-next.

Przykładowe monity obejmują:

• Prześlij wyniki analizy kodu brownfield w formacie JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' do sesji instrumentacji Azure Monitor "workspace-7a3b" po zakończeniu żądania analizy.
• Kontynuuj orkiestrację migracji, przesyłając wyniki JSON '{"serviceOptions":{"found":true,"details":"AddApplicationInsightsTelemetry used"},"initializers":[],"processors":[],"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' do sesji 'sess-01234'.
• Wyślij ukończoną analizę telemetrii dla brownfield jako wyniki JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":{"found":true},"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":{"found":true}}' dla sesji wdrożeniowej 'session-9f3b'.

Parameter	Wymagane lub opcjonalne	Description
Wyniki w formacie JSON	Wymagane	Obiekt JSON z wynikami analizy pola brązowego. Wymagane właściwości: serviceOptions (wyniki opcji usługi z analizowania wywołania AddApplicationInsightsTelemetry(), null, jeśli nie znaleziono), inicjalizatory (wyniki inicjatora telemetrii z analizowania implementacji ITelemetryInitializer lub IConfigureOptions<TelemetryConfiguration>, wartość null, jeśli nie znaleziono), procesory (wyniki procesora telemetrii z analizowania implementacji ITelemetryProcessor, wartość null, jeśli nie znaleziono), clientUsage (wyniki użycia TelemetryClient z analizy bezpośredniego użycia TelemetryClient, wartość null, jeśli nie znaleziono), próbkowanie (wyniki niestandardowej konfiguracji próbkowania, wartość null, jeśli nie ma niestandardowego próbkowania), telemetryPipeline (wyniki użycia niestandardowego ITelemetryChannel lub TelemetrySinks, wartość null, jeśli nie znaleziono), rejestrowanie (jawny dostawca rejestratora i wyniki filtru, wartość null, jeśli nie znaleziono). W przypadku sekcji, które nie istnieją w bazie kodu, przekaż pusty obiekt domyślny, na przykład znaleziony: false lub hasCustomSampling: false, zamiast wartości null.
identyfikator sesji	Wymagane	Ścieżka obszaru roboczego zwrócona jako sessionId z orchestrator-start.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	❌	❌	❌	❌	✅

Instrumentacja: wysyłanie wyboru ulepszeń

Prześlij wybrany przez użytkownika element ulepszenia po tym, jak orchestrator-start zwróci status enhancement_available. Prezentuj użytkownikowi opcje ulepszenia, a następnie wywołaj to narzędzie za pomocą wybranych kluczy ulepszeń. Możesz wybrać wiele ulepszeń, przekazując listę rozdzielaną przecinkami, na przykład redis,processors. Po pomyślnym wykonaniu tego narzędzia przejdź do orchestrator-next.

Przykładowe monity obejmują:

• Prześlij klucze ulepszeń „redis,processors” dla sesji instrumentacji Azure Monitor o identyfikatorze 'workspaces/my-app/session-abc123'.
• Kontynuuj przepływ ulepszania instrumentacji, wysyłając klucze rozszerzenia "redis" do identyfikatora sesji "workspaces/prod-app/session-789".
• Wyślij wybrane klucze rozszerzeń 'entityframework,otlp' dla ID sesji wdrażania 'workspaces/onboard/session-456'.

Parameter	Wymagane lub opcjonalne	Description
Klucze rozszerzeń	Wymagane	Co najmniej jeden klucz rozszerzenia rozdzielony przecinkami (na przykład redis, , redis,processorsentityframework,otlp).
identyfikator sesji	Wymagane	Ścieżka obszaru roboczego zwrócona jako sessionId z orchestrator-start.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	❌	❌	❌	❌	✅

Skoroszyty: wyświetlanie listy skoroszytów

Wyszukiwanie skoroszytów Azure przy użyciu usługi Resource Graph na potrzeby szybkich zapytań dotyczących metadanych. To narzędzie ułatwia odnajdywanie, filtrowanie i liczenie skoroszytów w różnych zakresach.

Zwraca metadane skoroszytu, w tym id, name, location, category oraz znaczniki czasu. Domyślnie nie zwraca pełnej zawartości zeszytu (serializedData) — aby to zrobić, użyj narzędzia show lub ustaw Output format na full.

Domyślnie wyszukiwanie dotyczy zeszytów w bieżącym środowisku Azure (dzierżawa/subskrypcja). Możesz użyć Resource group polecenia , aby jawnie określić zakres wyszukiwania. Narzędzie domyślnie zwraca łączną liczbę po stronie serwera. Zwracane maksymalne wyniki to 50, z maksymalnym limitem wynoszącym 1000; dostosuj to za pomocą polecenia Max results. Wybierz Output format jako summary dla minimalnej liczby tokenów lub full dla pełnych danych wyjściowych.

Przykładowe monity obejmują:

• "Pokaż wszystkie skoroszyty w grupie zasobów "monitoring-rg".
• "Wyświetl listę udostępnionych skoroszytów w grupie zasobów "prod-rg".
• "Jakie skoroszyty zostały zmodyfikowane po 2024-01-15 w grupie zasobów 'analytics-rg'?"

Parameter	Wymagane lub opcjonalne	Description
Grupa zasobów	Opcjonalnie	Nazwa grupy zasobów Azure.
Kategoria	Opcjonalnie	Filtruj skoroszyty według kategorii (na przykład workbook, , sentinelTSG). Jeśli nie zostaną określone, zostaną zwrócone wszystkie kategorie.
Uwzględnij łączną liczbę	Opcjonalnie	Uwzględnij łączną liczbę wszystkich pasujących skoroszytów w odpowiedzi (wartość domyślna: true).
Kind	Opcjonalnie	Filtruj skoroszyty według rodzaju (na przykład shared, user). Jeśli nie zostaną określone, zwracane są wszystkie typy.
Maksymalna liczba wyników	Opcjonalnie	Maksymalna liczba zwracanych wyników (wartość domyślna: 50, maksymalna: 1000).
Zmodyfikowane po	Opcjonalnie	Filtruj skoroszyty zmodyfikowane po tej dacie (format ISO 8601, na przykład 2024-01-15).
Nazwa zawiera	Opcjonalnie	Filtruj skoroszyty, w których nazwa wyświetlana zawiera ten tekst (bez uwzględniania wielkości liter).
Format danych wyjściowych	Opcjonalnie	Format danych wyjściowych: summary (tylko identyfikator i nazwa, minimalne tokeny), standard (metadane bez zawartości, wartość domyślna), full (w tym serializedData).
Identyfikator źródła	Opcjonalnie	Filtruj skoroszyty według identyfikatora zasobu źródłowego (na przykład /subscriptions/abc123/resourceGroups/prod/providers/Microsoft.Insights/components/myapp). Jeśli nie zostaną określone, zwracane są wszystkie skoroszyty.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	✅	❌	✅	❌	❌

Skoroszyty: pokaż szczegóły skoroszytu

Pobierz pełne szczegóły skoroszytu za pośrednictwem interfejsu API Azure Resource Manager (ARM), w tym zawartość serializedData. To polecenie pozwala uzyskać pełną definicję skoroszytu, wraz z wizualizacją JSON.

Zwraca pełne właściwości skoroszytu, serializedData tagi i ETag. Można podać wiele Workbook IDs operacji wsadowych. Polecenie zgłasza częściowe błędy dla poszczególnych skoroszytów. Aby uzyskać lepszą wydajność, użyj funkcji listy, aby najpierw odnaleźć skoroszyty, a następnie użyj polecenia "show" dla określonych skoroszytów.

Przykładowe monity obejmują:

• Pokaż szczegóły skoroszytu z identyfikatorem zasobu "/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1".
• Pobierz pełną definicję skoroszytu "/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2".

Parameter	Wymagane lub opcjonalne	Description
Identyfikatory skoroszytów	Wymagane	Identyfikatory zasobów Azure skoroszytów do pobrania. Obsługuje wiele wartości dla operacji wsadowych.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
❌	✅	❌	✅	❌	❌

Skoroszyty: utwórz skoroszyt

Utwórz nowy skoroszyt w określonej grupie zasobów i subskrypcji. Możesz ustawić nazwę wyświetlaną i serializowaną zawartość JSON skoroszytu. To polecenie zwraca informacje o utworzonym skoroszycie po pomyślnym zakończeniu.

Przykładowe monity obejmują:

• Utwórz nowy skoroszyt o nazwie „Pulpit nawigacyjny wydajności” w grupie zasobów „monitoring-rg” z zawartością sekwencyjną dla notatnika podstawowego.
• "Utwórz skoroszyt o nazwie "Przegląd infrastruktury" w grupie zasobów "prod-rg" z zawartością przedstawiającą metryki maszyny wirtualnej.

Parameter	Wymagane lub opcjonalne	Description
Nazwa wyświetlana	Wymagane	Nazwa wyświetlana skoroszytu.
Grupa zasobów	Wymagane	Nazwa grupy zasobów Azure.
Serializowana zawartość	Wymagane	Zserializowana zawartość JSON skoroszytu.
Identyfikator źródła	Opcjonalnie	Identyfikator połączonego zasobu dla skoroszytu. Domyślnie jest to azure monitor.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
✅	❌	❌	❌	❌	❌

Skoroszyty: zaktualizuj skoroszyt

Zaktualizuj właściwości istniejącego skoroszytu Azure, dodając nowe kroki, modyfikując zawartość lub zmieniając nazwę wyświetlaną. Ta akcja zwraca zaktualizowane szczegóły skoroszytu. Potrzebujesz identyfikatora zasobu skoroszytu i możesz określić nową serializowaną zawartość albo nową nazwę wyświetlaną.

Przykładowe monity obejmują:

• Zaktualizuj skoroszyt "/subscriptions/abc123/resourceGroups/monitoring-rg/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1" o nazwie wyświetlanej "Raport miesięczny".
• Zmień serializowaną zawartość skoroszytu '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' w celu uwzględnienia nowego wykresu metryk.

Parameter	Wymagane lub opcjonalne	Description
Identyfikator skoroszytu	Wymagane	Identyfikator zasobu Azure zeszytu roboczego do zaktualizowania.
Nazwa wyświetlana	Opcjonalnie	Nazwa wyświetlana skoroszytu.
Serializowana zawartość	Opcjonalnie	Serializowana zawartość skoroszytu w formacie JSON.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
✅	✅	❌	❌	❌	❌

Skoroszyty: Usuwanie skoroszytów

Usuń co najmniej jeden skoroszyt według identyfikatorów zasobów Azure. To polecenie wykonuje miękkie usuwanie w skoroszytach, zachowując je przez 90 dni. W razie potrzeby można je przywrócić z Kosza za pośrednictwem portalu Azure.

W przypadku operacji wsadowych można podać wiele Workbook IDs wartości. Polecenie raportuje częściowe błędy na skoroszyty, unikając, aby indywidualne błędy wpływały na całą operację wsadową.

Aby dowiedzieć się więcej, zobacz Zarządzanie skoroszytami Azure Monitor.

Przykładowe monity obejmują:

• "Usuń skoroszyt z identyfikatorem zasobu "/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft. Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1e1e1e1"."
• Usuń skoroszyty z identyfikatorami zasobów "/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2" i "/subscriptions/def456/resourceGroups/analytics-rg/providers/Microsoft.Insights/workbooks/c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3a3'".

Parameter	Wymagane lub opcjonalne	Description
Identyfikatory skoroszytów	Wymagane	Identyfikatory zasobów Azure skoroszytów do usunięcia. Obsługuje wiele wartości dla operacji wsadowych.

Wskazówki adnotacji narzędzi:

Destrukcyjny	Idempotentny	Open World	Tylko do odczytu	Secret	Wymagane lokalnie
✅	✅	❌	❌	❌	❌

Treści powiązane

• Czym są narzędzia serwera MCP w Azure?
• Rozpocznij korzystanie z serwera Azure MCP
• Azure Monitor
• Application Insights
• Workbook w Azure Monitor
• Metryki w ramach Azure Monitor