Alat Server MCP Azure untuk Azure Monitor dan Workbook

Server Azure Model Context Protocol (MCP) memungkinkan Anda mengelola sumber daya Azure Monitor dan Buku Kerja dengan perintah bahasa alami. Anda dapat mengkueri ruang kerja Log Analytics, menganalisis data operasional, memantau kesehatan sumber daya, mengambil metrik kinerja, mengelola pengujian ketersediaan web, mengorkestrasi alur kerja instrumentasi, dan mengelola buku kerja Azure Monitor.

Azure Monitor membantu Anda memaksimalkan ketersediaan dan performa aplikasi dan layanan Anda. Ini menyediakan solusi komprehensif untuk mengumpulkan, menganalisis, dan bertindak berdasarkan telemetri dari lingkungan cloud dan lokal Anda.

Buku kerja menyediakan kanvas fleksibel untuk analisis data dan pembuatan laporan visual yang kaya dalam portal Azure. Mereka memungkinkan Anda untuk memanfaatkan beberapa sumber data dari seluruh Azure dan menggabungkannya menjadi pengalaman interaktif terpadu. Workbooks memungkinkan Anda menggabungkan berbagai jenis visualisasi dan analisis, menjadikannya ideal untuk eksplorasi bebas. Untuk informasi selengkapnya, lihat dokumentasi buku kerja Azure Monitor.

Nota

Parameter Alat: Alat Azure MCP Server mendefinisikan parameter untuk data yang mereka butuhkan untuk menyelesaikan tugas. Beberapa parameter ini khusus untuk setiap alat dan didokumentasikan di sini. Parameter lain bersifat global dan dibagikan oleh semua alat. Untuk informasi selengkapnya, lihat Parameter alat.

Log Aktivitas: Dapatkan log aktivitas

Mencantumkan log aktivitas Azure Monitor untuk sumber daya Azure tertentu selama beberapa jam terakhir. Alat ini membantu Anda memahami riwayat penyebaran sumber daya, perubahan konfigurasi, dan pola akses. Ini mengembalikan peristiwa log aktivitas yang mencakup tanda waktu, nama operasi, status, dan informasi pemanggil. Gunakan hasilnya untuk menyelidiki penyebaran yang gagal, perubahan tak terduga, atau masalah akses.

Contoh perintah meliputi:

  • "Cantumkan log aktivitas selama '720' jam terakhir untuk sumber daya 'webapp-prod'."
Pengaturan Diperlukan atau opsional Description
Nama sumber daya Diperlukan Nama sumber daya Azure untuk mengambil log aktivitas.
Tingkat peristiwa Fakultatif Tingkat catatan aktivitas yang akan diambil. Tingkat yang valid adalah: Critical, , ErrorInformational, , VerboseWarning. Jika tidak disediakan, mengembalikan semua tingkatan.
Jam Fakultatif Jumlah jam sebelum sekarang untuk mengambil log aktivitas.
Jenis sumber daya Fakultatif Jenis sumber daya Azure (misalnya, 'Microsoft.Storage/storageAccounts'). Hanya berikan ini jika diperlukan untuk memisahkan antara beberapa sumber daya dengan nama yang sama.
Atas Fakultatif Jumlah maksimum log aktivitas yang akan diambil.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Pengujian Web: Membuat atau memperbarui pengujian web

Bagian dari alat Protokol Konteks Model (MCP), alat ini membuat atau memperbarui pengujian web standar di Azure Monitor untuk memeriksa ketersediaan titik akhir. Anda menentukan pengaturan pemantauan seperti URL, frekuensi, lokasi, dan respons yang diharapkan. Jika pengujian tidak ada, alat ini membuatnya; jika tidak, pengujian yang ada akan diperbarui dengan pengaturan baru.

Contoh perintah meliputi:

  • "Buat Uji Web Standar baru dengan sumber daya webtest 'webtest-prod-availability' di grup sumber daya 'rg-prod-monitoring' dan kaitkan dengan komponen AppInsights '/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod'."
  • Perbarui Tes Web Standar yang ada untuk sumber daya webtest 'webtest-prod-availability' di grup sumber daya 'rg-prod-monitoring' untuk menghubungkannya dengan komponen AppInsights '/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod'.
Pengaturan Diperlukan atau opsional Description
grup Sumber Daya Diperlukan Nama grup sumber daya Azure.
Sumber daya Webtest Diperlukan Nama sumber daya Uji Web yang akan dioperasikan.
Komponen Appinsights Fakultatif ID sumber daya dari komponen Application Insights yang akan dihubungkan dengan pengujian web.
Deskripsi Fakultatif Deskripsi singkat tentang pengujian web.
Enabled Fakultatif Apakah pengujian web diaktifkan.
Kode status yang diharapkan Fakultatif Kode status HTTP yang diharapkan.
Mengikuti pengalihan Fakultatif Apakah akan mengikuti pengalihan HTTP.
Frekuensi Fakultatif Frekuensi pengujian dalam detik. Nilai yang didukung: 300, 600, 900.
Header Fakultatif Header HTTP untuk disertakan dalam permintaan, dalam format pasangan KEY=VALUE yang dipisahkan oleh koma.
Kata kerja HTTP Fakultatif Metode HTTP yang digunakan, misalnya get atau post.
Abaikan kode status Fakultatif Apakah akan mengabaikan validasi kode status.
Tempat Fakultatif Lokasi tempat sumber daya pengujian web dibuat. Ini harus cocok dengan lokasi komponen Application Insights.
Mengurai permintaan Fakultatif Apakah akan mengurai permintaan dependen.
Badan permintaan Fakultatif Badan untuk dikirim dengan permintaan.
URL Permintaan Fakultatif URL absolut untuk diuji.
Fitur ulangi diaktifkan Fakultatif Apakah percobaan ulang diaktifkan.
Pemeriksaan SSL Fakultatif Apakah akan memvalidasi sertifikat SSL.
Pemeriksaan masa pakai SSL Fakultatif Jumlah hari untuk memeriksa masa pakai sertifikat SSL.
Timeout Fakultatif Meminta batas waktu dalam detik. Nilai yang didukung: 30, 60, 90, 120.
Nama pengujian web Fakultatif Nama pengujian dalam sumber daya pengujian web.
Lokasi Webtest Fakultatif Daftar lokasi yang dipisahkan koma untuk menjalankan pengujian. Lokasi mengacu pada tag populasi lokasi geografis untuk Uji Ketersediaan.
Webtest Fakultatif Konfigurasi uji web.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Pengujian Web: Dapatkan pengujian web

Alat ini mendapatkan detail untuk pengujian web tertentu atau mencantumkan semua pengujian web. Saat Anda menentukan sumber daya Webtest, alat ini mengembalikan informasi terperinci untuk pengujian web tersebut. Saat Anda tidak menentukan sumber daya Webtest, alat ini mengembalikan daftar semua pengujian web dalam langganan, dan Anda dapat memfilter daftar menurut grup sumber daya.

Contoh perintah meliputi:

  • "Dapatkan detail Pengujian Web untuk sumber daya webtest 'webtest-prod' di langganan saya di grup sumber daya 'rg-monitoring'."
  • "Cantumkan semua sumber daya Uji Web di langganan saya."
  • "Cantumkan semua sumber daya Uji Web dalam langganan saya di grup sumber daya 'rg-prod'."
Pengaturan Diperlukan atau opsional Description
Sumber daya Webtest Fakultatif Nama sumber daya Uji Web yang akan dioperasikan.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Log Analytics: Mencantumkan ruang kerja

Alat ini mencantumkan ruang kerja Log Analytics dalam langganan. Ini mengambil nama, ID, lokasi, dan properti kunci lainnya dari setiap ruang kerja. Anda dapat menggunakannya untuk mengidentifikasi ruang kerja sebelum mengkueri log mereka atau memeriksa pengaturan ruang kerja.

Contoh perintah meliputi:

  • "Cantumkan ruang kerja Log Analytics di langganan saya."
  • "Tampilkan ruang kerja Log Analytics saya."
  • "Dapatkan ruang kerja Log Analytics di langganan saya."

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Log Analytics: Mencantumkan tabel

Alat ini mencantumkan semua tabel di ruang kerja Log Analytics. Misalnya, cantumkan tabel di ruang kerja 'prod-law' di grup sumber daya 'rg-monitoring' untuk mempratinjau kolom dan jenis data yang tersedia. Ini mengembalikan nama tabel dan skema yang Anda gunakan untuk membangun kueri Kusto Query Language (KQL). Anda dapat memfilter menurut jenis tabel, misalnya CustomLog atau AzureMetrics.

Contoh perintah meliputi:

  • Sebutkan semua tabel di ruang kerja Log Analytics 'prod-law' dengan jenis 'CustomLog' dalam resource group 'rg-prod'.
  • "Tampilkan tabel tipe tabel 'AzureMetrics' untuk ruang kerja 'f1b2c3d4-5678-90ab-cdef-1234567890ab' dalam grup sumber daya 'rg-monitoring'."
Pengaturan Diperlukan atau opsional Description
grup Sumber Daya Diperlukan Nama grup sumber daya Azure.
Nama ruang kerja Diperlukan ID atau nama ruang kerja Log Analytics. Ini dapat berupa pengidentifikasi unik (GUID) atau nama tampilan ruang kerja Anda.
Jenis tabel Diperlukan Jenis tabel yang akan difilter.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Log Analytics: Menampilkan jenis tabel

Alat Model Context Protocol (MCP) ini mencantumkan jenis tabel yang tersedia di ruang kerja Azure Log Analytics. Ini mengembalikan nama jenis tabel. Anda dapat menggunakan nama-nama tersebut saat menulis kueri terhadap Log Azure Monitor.

Contoh perintah meliputi:

  • "Cantumkan semua jenis tabel yang tersedia di Log Analytics nama ruang kerja 'prod-law-01' dalam grup sumber daya 'rg-prod'."
  • Jenis tabel apa yang tersedia di ruang kerja Log Analytics bernama 'analytics-workspace' dalam kelompok sumber daya 'rg-logs'?
Pengaturan Diperlukan atau opsional Description
grup Sumber Daya Diperlukan Nama grup sumber daya Azure.
Nama ruang kerja Diperlukan Nama atau ID ruang kerja Log Analytics. Anda dapat menggunakan GUID ruang kerja atau nama tampilan.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Log Analytics: Menjalankan kueri pada log ruang kerja

Mengeksplorasi log di seluruh ruang kerja Log Analytics dengan menggunakan Kusto Query Language (KQL). Alat ini menjalankan kueri di seluruh ruang kerja yang mengembalikan log dari semua sumber daya dan tabel dalam ruang kerja. Alat ini adalah bagian dari alat Model Context Protocol (MCP). Misalnya, Anda dapat bertanya: 'tampilkan semua kesalahan di ruang kerja saya', 'apa yang terjadi di ruang kerja saya dalam 24 jam terakhir', 'cantumkan permintaan yang gagal di seluruh ruang kerja'.

Contoh perintah meliputi:

  • Tampilkan log dengan kueri 'kesalahan' dari tabel 'Syslog' di ruang kerja Log Analytics 'my-workspace' dalam grup sumber daya 'rg-prod'.
Pengaturan Diperlukan atau opsional Description
Pertanyaan Diperlukan Kueri Kusto Query Language (KQL) untuk dijalankan terhadap ruang kerja Log Analytics. Anda dapat menggunakan kueri yang telah ditentukan sebelumnya berdasarkan nama: recent menunjukkan log terbaru, diurutkan menurut TimeGenerated; errors menampilkan log tingkat kesalahan, diurutkan oleh TimeGenerated. Atau, berikan kueri KQL kustom.
grup Sumber Daya Diperlukan Nama grup sumber daya Azure.
Nama tabel Diperlukan Nama tabel yang akan dikueri dalam ruang kerja.
Nama ruang kerja Diperlukan ID atau nama ruang kerja Log Analytics. Anda dapat memberikan pengidentifikasi unik global (GUID) atau nama tampilan ruang kerja.
Jam Fakultatif Jumlah jam untuk meminta informasi dari sekarang.
Limit Fakultatif Jumlah maksimum hasil yang akan dikembalikan.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Log Analytics: Log sumber daya kueri

Menjalankan kueri diagnostik dan aktivitas untuk sumber daya Azure tertentu di ruang kerja Log Analytics dengan menggunakan Bahasa Kueri Kusto (KQL). Alat ini memfilter hasil ke sumber daya yang ditentukan dan menjalankan kueri KQL yang disediakan terhadap tabel yang dipilih. Misalnya, tanyakan "Tampilkan log untuk sumber daya 'app-monitor' selama 24 jam terakhir."

Contoh perintah meliputi:

  • Tampilkan log dengan kueri 'recent' untuk ID sumber daya '/subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/rg-prod/providers/Microsoft.Compute/virtualMachines/my-vm' dalam tabel 'AzureDiagnostics'.
Pengaturan Diperlukan atau opsional Description
Pertanyaan Diperlukan Kueri KQL untuk dijalankan terhadap lingkup kerja Log Analytics. Anda dapat menggunakan kueri yang telah ditentukan sebelumnya berdasarkan nama: recent memperlihatkan log terbaru yang diurutkan oleh TimeGenerated; errors memperlihatkan log tingkat kesalahan yang diurutkan oleh TimeGenerated. Jika tidak, sediakan kueri KQL kustom.
ID Sumber Daya Diperlukan ID Sumber Daya Azure dari sumber daya yang ingin dikueri. Contoh: /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.OperationalInsights/workspaces/<ws>.
Nama tabel Diperlukan Nama tabel yang akan dikueri dalam ruang kerja.
Jam Fakultatif Jumlah jam untuk meminta informasi dari sekarang.
Limit Fakultatif Jumlah maksimum hasil yang akan dikembalikan.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Model kesehatan: Mencantumkan model kesehatan

Mencantumkan semua model kesehatan dalam sumber daya model kesehatan Azure Monitor. Alat ini membantu Anda menemukan model kesehatan yang tersedia untuk memantau kesehatan tingkat aplikasi. Alat Protokol Konteks Model (MCP) melaporkan kesehatan tingkat aplikasi berdasarkan model kesehatan kustom, bukan ketersediaan sumber daya dasar. Untuk ketersediaan sumber daya dasar, gunakan Azure Resource Health. Untuk mengkueri log di ruang kerja Log Analytics, gunakan azmcp_monitor_workspace_log_query. Untuk mengkueri log untuk sumber daya Azure tertentu, gunakan azmcp_monitor_resource_log_query.

Contoh perintah meliputi:

  • "Cantumkan semua model kesehatan dalam sumber daya model kesehatan 'app-health-monitor' di grup sumber daya 'rg-prod'."

Contoh perintah CLI

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

Petunjuk anotasi alat:

Destruktif: ❌ | Idempoten: ✅ | Dunia Terbuka: ❌ | Baca Saja: ✅ | Rahasia: ❌ | Lokal Diperlukan: ❌

Model kesehatan: Dapatkan model kesehatan

Mengambil model kesehatan tertentu berdasarkan nama dari sumber daya model kesehatan Azure Monitor. Alat ini mengembalikan status kesehatan dan peristiwa kesehatan terbaru untuk model kesehatan tertentu. Alat Protokol Konteks Model (MCP) melaporkan kesehatan tingkat aplikasi berdasarkan model kesehatan kustom, bukan ketersediaan sumber daya dasar. Untuk ketersediaan sumber daya dasar, gunakan Azure Resource Health. Untuk mengkueri log di ruang kerja Log Analytics, gunakan azmcp_monitor_workspace_log_query. Untuk mengkueri log untuk sumber daya Azure tertentu, gunakan azmcp_monitor_resource_log_query.

Contoh perintah meliputi:

  • "Dapatkan model kesehatan 'order-service-health' dari sumber daya model kesehatan 'app-health-monitor' di grup sumber daya 'rg-prod'."
Pengaturan Diperlukan atau opsional Description
Model kesehatan Diperlukan Nama model kesehatan yang akan diambil.
grup Sumber Daya Diperlukan Nama grup sumber daya Azure.

Nota

Migrasi dari 3.0.0-beta.24 dan versi yang lebih lama: Perintah monitor healthmodels entity get telah dihapus pada 3.0.0-beta.25. Gunakan monitor healthmodels list untuk mencantumkan semua model kesehatan, atau monitor healthmodels get untuk mengambil model kesehatan tertentu berdasarkan nama.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Metrik: Metrik kueri

Kueri metrik Azure Monitor pada sebuah sumber daya. Alat ini mengembalikan data rangkaian waktu untuk metrik yang ditentukan, membantu Anda menganalisis performa dan ketersediaan sumber daya. Alat ini adalah bagian dari alat Model Context Protocol (MCP).

Contoh perintah meliputi:

  • "Analisis tren performa dan waktu respons untuk sumber daya Application Insights 'appinsights-prod' dengan metrik 'requests/duration' dan metric namespace 'microsoft.insights/components'."
  • "Periksa metrik ketersediaan 'availabilityResults/availabilityPercentage' untuk sumber daya Application Insights 'appinsights-staging' menggunakan namespace metrik 'microsoft.insights/components'?"
  • Dapatkan metrik 'requests/duration' dengan agregasi 'Rata-rata' dan interval 'PT1M' untuk sumber daya 'appinsights-prod' dengan menggunakan namespace metrik 'microsoft.insights/components'.
  • "Selidiki tingkat kesalahan dan permintaan yang gagal untuk sumber daya Application Insights 'appinsights-prod' menggunakan metrik 'requests/failed,exceptions/count' dan namespace metrik 'microsoft.insights/components'."
  • "Kueri metrik 'requests/count' untuk tipe sumber daya 'Microsoft.Insights/components' sumber daya 'appinsights-qa' dengan namespace metrik 'microsoft.insights/components' dan interval 'PT5M'."
  • Berapa permintaan-permintaan per detik menggunakan metrik 'requests/count' dengan agregasi 'Count' untuk sumber daya Application Insights 'appinsights-prod' dan namespace metrik 'microsoft.insights/components'?
Pengaturan Diperlukan atau opsional Description
Nama metrik Diperlukan Nama metrik yang akan dikueri, dipisahkan koma.
Ruang nama metrik Diperlukan Namespace metrik yang akan dikueri. Dapatkan nilai ini dari alat azmcp-monitor-metrics-definitions.
Nama sumber daya Diperlukan Nama sumber daya Azure untuk melakukan kueri metrik.
Agregasi Fakultatif Jenis agregasi yang akan digunakan, seperti Rata-rata, Maksimum, Minimum, Total, atau Hitungan.
Waktu selesai Fakultatif Waktu akhir untuk kueri dalam format ISO (misalnya, 2023-01-01T00:00:00Z). Mengatur ke waktu sekarang.
Filter Fakultatif Filter OData untuk diterapkan ke kueri metrik.
Interval Fakultatif Interval waktu untuk titik data (misalnya, PT1H selama 1 jam, PT5M selama 5 menit).
Wadah maksimal Fakultatif Jumlah maksimum slot waktu yang akan dikembalikan. Secara default ke 50.
Jenis sumber daya Fakultatif Jenis sumber daya Azure (misalnya, Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Jika tidak ditentukan, alat mencoba menyimpulkan jenis dari nama sumber daya.
Waktu mulai Fakultatif Waktu mulai untuk kueri dalam format ISO (misalnya, 2023-01-01T00:00:00Z). Pengaturan awal diatur ke 24 jam yang lalu.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Metrik: Daftar definisi metrik

Alat ini mencantumkan definisi metrik untuk sumber daya Azure. Ini mengembalikan metadata tentang setiap metrik, termasuk namespace, deskripsi, dan jenis agregasi, sehingga Anda dapat menentukan metrik mana yang akan dikueri untuk sumber daya.

Contoh perintah meliputi:

  • "Dapatkan definisi metrik untuk nama sumber daya 'app-insights-prod'."
  • "Mencantumkan definisi metrik untuk nama sumber daya 'mystorageacct' dengan jenis sumber daya 'Microsoft. Storage/storageAccounts' dan namespace metrik 'Storage'."
  • "Tampilkan definisi metrik untuk nama sumber daya 'vm-prod-01' dengan string pencarian 'cpu' dan batas '20'."
Pengaturan Diperlukan atau opsional Description
Nama sumber daya Diperlukan Nama sumber daya Azure untuk melakukan kueri metrik.
Limit Fakultatif Jumlah maksimum definisi metrik yang akan dikembalikan. Mengatur default ke 10.
Ruang nama metrik Fakultatif Namespace metrik yang akan dikueri. Dapatkan nilai ini dari alat azmcp-monitor-metrics-definitions.
Jenis sumber daya Fakultatif Jenis sumber daya Azure (misalnya, Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Jika Anda tidak menentukannya, alat ini mencoba menyimpulkan jenis sumber daya dari nama sumber daya.
String pencarian Fakultatif String untuk memfilter definisi metrik. Filter melakukan pencocokan yang tidak peka terhadap huruf besar/kecil pada nama dan deskripsi metrik.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Instrumentasi: Mendapatkan sumber daya pembelajaran

Alat ini mencantumkan semua sumber daya pembelajaran yang tersedia untuk instrumentasi Azure Monitor, atau mengambil konten sumber daya tertentu berdasarkan jalur. Secara default, alat mengembalikan semua jalur sumber daya. Jika Anda menentukan jalur, alat mengembalikan konten sumber daya lengkap. Untuk menginstrumentasikan aplikasi, gunakan alat bernama orchestrator-start.

Contoh perintah meliputi:

  • "Dapatkan sumber daya pembelajaran onboarding di jalur 'onboarding/get-started.md'."
  • "Tunjukkan konten sumber daya pembelajaran onboarding Azure Monitor di jalur 'onboarding/quickstart.md'."
  • "Ambil konten file sumber daya pembelajaran Azure Monitor di jalur 'samples/instrumentation-guide.html'."
  • "Cantumkan semua sumber daya pembelajaran onboarding Azure Monitor."
  • "Tunjukkan kepada saya semua jalur sumber daya pembelajaran untuk instrumentasi Azure Monitor."
  • Sumber daya pembelajaran apa yang tersedia untuk pelatihan penggunaan Azure Monitor?
Pengaturan Diperlukan atau opsional Description
Jalur Fakultatif Jalur sumber daya pembelajaran.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Instrumentasi: Memulai orkestrasi

Mulai di sini untuk alat Protokol Konteks Model (MCP) yang dipantau oleh Azure Monitor. Alat ini menganalisis ruang kerja dan mengembalikan tindakan pertama yang akan dijalankan. Setelah Anda menjalankan tindakan, panggil orchestrator-next untuk melanjutkan. Ikuti tindakan di instruction kolom dengan tepat.

Contoh perintah meliputi:

  • "Mulai orkestrasi instrumentasi Azure Monitor untuk jalur ruang kerja '/home/dev/workspace-monitoring'."
  • "Analisislah jalur ruang kerja '/src/projects/my-app-workspace' dan kembalikan langkah pertama instrumentasi Azure Monitor."
  • "Mulailah onboarding Azure Monitor terpandu untuk proyek di jalur ruang kerja '/ruang kerja/aplikasi saya' dan beri saya langkah pertama."
Pengaturan Diperlukan atau opsional Description
Jalur ruang kerja Diperlukan Jalur absolut ke folder ruang kerja.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Instrumentasi: Lanjutkan orkestrasi

Dapatkan tindakan instrumentasi berikut setelah Anda menyelesaikan tindakan tersebut.

Alat ini adalah bagian dari rangkaian Protokol Konteks Model (MCP).

Setelah Anda mengeksekusi instruction yang tepat dari respons sebelumnya, gunakan alat ini untuk menerima langkah selanjutnya.

Alur kerja yang diharapkan:

  1. Anda menerima tindakan dari orchestrator-start atau orchestrator-next.
  2. Anda menjalankan instruction kolom dengan tepat.
  3. Anda menjalankan alat ini dengan ringkas Completion note untuk mendapatkan tindakan berikutnya.

Pengembalian: Tindakan berikutnya untuk dijalankan, atau complete status saat semua langkah dilakukan.

Contoh perintah meliputi:

  • "Setelah menyelesaikan langkah instrumentasi Azure Monitor sebelumnya, dapatkan tindakan berikutnya untuk ID sesi 'session-abc123' dengan catatan penyelesaian 'Added UseAzureMonitor() to Program.cs'."
  • "Dapatkan tindakan onboarding berikutnya untuk ID sesi 'ruang kerja/sesi-2026' dengan catatan penyelesaian 'Ran dotnet tambahkan paket Microsoft. ApplicationInsights'."
  • "Setelah menyelesaikan langkah instrumentasi sebelumnya, kembalikan langkah berikutnya untuk ID sesi 'session-789xyz' dengan catatan penyelesaian 'Update appsettings.json untuk mengaktifkan Application Insights'."
Pengaturan Diperlukan atau opsional Description
Catatan penyelesaian Diperlukan Satu kalimat yang menjelaskan apa yang Anda jalankan, misalnya, 'Ran dotnet add package command' atau 'Added UseAzureMonitor() to Program.cs'.
ID Sesi Diperlukan Jalur ruang kerja dikembalikan sebagai sessionId dari orchestrator-start.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Instrumentasi: Kirim analisis brownfield

Mengirimkan temuan analisis kode brownfield setelah orchestrator-start mengembalikan status analysis_needed. Alat ini adalah bagian dari alur kerja Protokol Konteks Model (MCP). Anda harus memindai file sumber ruang kerja dan mengisi templat analisis sebelum memanggil alat ini. Setelah alat ini berhasil, lanjutkan dengan orchestrator-next.

Contoh perintah meliputi:

  • Kirim temuan analisis kode brownfield JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' ke sesi instrumentasi Azure Monitor 'workspace-7a3b' setelah analisis diminta.
  • "Lanjutkan orkestrasi migrasi dengan mengirimkan temuan JSON '{"serviceOptions":{"found":true,"details":"AddApplicationInsightsTelemetry used"},"initializeers":[],"processors":[],"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' ke sesi 'sess-01234'."
  • "Kirim analisis telemetri brownfield lengkap sebagai temuan JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":{"found":true},"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":{"found":true}}' untuk sesi onboarding 'session-9f3b'."
Pengaturan Diperlukan atau opsional Description
Temuan JSON Diperlukan Objek JSON dengan temuan analisis brownfield. Properti yang diperlukan: serviceOptions (temuan opsi layanan dari menganalisis panggilan AddApplicationInsightsTelemetry(), null jika tidak ditemukan), inisialisasi (temuan inisialisasi telemetri dari menganalisis implementasi ITelemetryInitializer atau IConfigureOptions<TelemetryConfiguration> , null jika tidak ada yang ditemukan), prosesor (temuan prosesor telemetri dari menganalisis implementasi ITelemetryProcessor, null jika tidak ada yang ditemukan), clientUsage (Temuan penggunaan TelemetryClient dari menganalisis langsung Penggunaan TelemetryClient, null jika tidak ditemukan), pengambilan sampel (temuan konfigurasi pengambilan sampel kustom, null jika tidak ada pengambilan sampel kustom), telemetryPipeline (temuan penggunaan ITelemetryChannel atau TelemetrySinks kustom, null jika tidak ditemukan), pengelogan (penyedia pencatat eksplisit dan temuan filter, null jika tidak ditemukan). Untuk bagian yang tidak ada di basis kode, lewati objek default kosong, misalnya ditemukan: false atau hasCustomSampling: false, alih-alih null.
ID Sesi Diperlukan Jalur ruang kerja dikembalikan sebagai sessionId dari orchestrator-start.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Instrumentasi: Kirim pilihan peningkatan

Kirimkan pilihan peningkatan pengguna setelah orchestrator-start mengembalikan status enhancement_available. Sajikan pilihan peningkatan kepada pengguna, lalu panggil alat ini dengan kunci peningkatan yang dipilih. Anda dapat memilih beberapa penyempurnaan dengan meneruskan daftar yang dipisahkan koma, misalnya, redis,processors. Setelah alat ini berhasil, lanjutkan dengan orchestrator-next.

Contoh perintah meliputi:

  • "Kirim kunci penyempurnaan 'redis,processor' untuk Azure Monitor ID sesi instrumentasi 'workspaces/my-app/session-abc123'."
  • "Lanjutkan alur peningkatan instrumentasi dengan mengirim kunci peningkatan 'redis' ke ID sesi 'workspaces/prod-app/session-789'."
  • "Kirim kunci peningkatan yang dipilih 'entityframework,otlp' untuk ID sesi onboarding 'workspaces/onboard/session-456'."
Pengaturan Diperlukan atau opsional Description
Kunci penyempurnaan Diperlukan Satu atau beberapa kunci peningkatan, dipisahkan koma (misalnya, , redisredis,processors, entityframework,otlp).
ID Sesi Diperlukan Jalur ruang kerja dikembalikan sebagai sessionId dari orchestrator-start.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Buku kerja: Daftar buku kerja

Cari buku kerja Azure menggunakan Resource Graph untuk kueri metadata cepat. Alat ini membantu Anda menemukan, memfilter, dan menghitung buku kerja di berbagai cakupan.

Ini mengembalikan metadata buku kerja, termasuk id, name, location, category, dan tanda waktu. Secara bawaan, ini tidak mengembalikan konten buku kerja lengkap (serializedData) — gunakan alat tampilan untuk itu, atau atur Output format ke full.

Secara default, pencarian menargetkan buku kerja dalam konteks Azure Anda saat ini (penyewa/langganan). Anda dapat menggunakan Resource group untuk menentukan cakupan pencarian Anda secara eksplisit. Alat ini mengembalikan jumlah total sisi server secara default. Hasil maksimum yang dikembalikan adalah 50, dengan batas maksimum 1000; sesuaikan ini dengan Max results. Pilih Output format sebagai summary untuk token minimal atau full untuk output lengkap serializedData .

Contoh perintah meliputi:

  • "Perlihatkan saya semua buku kerja dalam grup sumber daya 'monitoring-rg'."
  • "Cantumkan buku kerja bersama dalam grup sumber daya 'prod-rg'."
  • Lembar kerja apa yang dimodifikasi setelah 2024-01-15 pada grup sumber daya 'analytics-rg'?
Pengaturan Diperlukan atau opsional Description
grup Sumber Daya Fakultatif Nama grup sumber daya Azure.
Kategori Fakultatif Filter buku kerja menurut kategori (misalnya, , workbooksentinel, TSG). Jika tidak ditentukan, semua kategori akan ditampilkan.
Sertakan jumlah total Fakultatif Sertakan jumlah total semua buku kerja yang cocok dalam respons (default: true).
Kind Fakultatif Filter buku kerja menurut jenis (misalnya, shared, user). Jika tidak ditentukan, semua jenis dikembalikan.
Hasil maks Fakultatif Jumlah maksimum hasil yang akan dikembalikan (default: 50, maks: 1000).
Diubah setelah Fakultatif Filter buku kerja yang dimodifikasi setelah tanggal ini (format ISO 8601, misalnya, 2024-01-15).
Nama berisi Fakultatif Filter buku kerja di mana nama tampilan berisi teks ini (tidak peka terhadap huruf besar/kecil).
Format output Fakultatif Format output: summary (ID dan nama saja, token minimal), standard (metadata tanpa konten, default), full (termasuk serializedData).
ID Sumber Fakultatif Filter buku kerja menurut ID sumber daya asal (misalnya, /subscriptions/abc123/resourceGroups/prod/providers/Microsoft.Insights/components/myapp). Jika tidak ditentukan, semua buku kerja dikembalikan.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Buku kerja: Perlihatkan detail buku kerja

Ambil detail buku kerja lengkap melalui API Azure Resource Manager (ARM), termasuk konten serializedData. Perintah ini memungkinkan Anda mendapatkan definisi buku kerja lengkap, termasuk visualisasi JSON.

Ini mengembalikan properti buku kerja lengkap, serializedData, tag, dan ETag. Anda dapat menyediakan beberapa Workbook IDs untuk proses batch. Perintah memberikan laporan kegagalan sebagian untuk masing-masing buku kerja. Untuk performa yang lebih baik, gunakan alat daftar untuk menemukan buku kerja terlebih dahulu, lalu gunakan perlihatkan untuk buku kerja tertentu.

Contoh perintah meliputi:

  • Perlihatkan detail buku kerja dengan ID sumber daya '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1'.
  • "Dapatkan definisi lengkap dari workbook '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2'."
Pengaturan Diperlukan atau opsional Description
ID Buku Kerja Diperlukan ID sumber daya Azure dari buku kerja yang akan diambil. Mendukung beberapa nilai untuk operasi batch.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Buku kerja: Membuat buku kerja

Buat buku kerja baru di grup sumber daya dan langganan yang ditentukan. Anda bisa mengatur nama tampilan dan konten JSON yang diserialisasikan untuk buku kerja. Perintah ini mengembalikan informasi buku kerja yang dibuat setelah berhasil diselesaikan.

Contoh perintah meliputi:

  • "Buat buku kerja baru bernama 'Dasbor Performa' di grup sumber daya 'monitoring-rg' dengan konten berseri untuk buku catatan dasar."
  • "Buat buku kerja yang disebut 'Gambaran Umum Infrastruktur' di grup sumber daya 'prod-rg' dengan konten yang memperlihatkan metrik VM."
Pengaturan Diperlukan atau opsional Description
Nama tampilan Diperlukan Nama tampilan buku kerja.
grup Sumber Daya Diperlukan Nama grup sumber daya Azure.
Konten berseri Diperlukan Konten JSON yang diserialisasikan dari buku kerja.
ID Sumber Fakultatif ID sumber daya tertaut untuk buku kerja. Secara default, ini adalah azure monitor.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Buku kerja: Memperbarui buku kerja

Perbarui properti buku kerja Azure yang sudah ada dengan menambahkan langkah baru, mengubah konten, atau mengubah nama tampilan. Tindakan ini mengembalikan detail buku kerja yang telah diperbarui. Anda memerlukan ID sumber daya buku kerja dan dapat menentukan konten berseri baru atau nama tampilan baru.

Contoh perintah meliputi:

  • "Perbarui buku kerja '/subscriptions/abc123/resourceGroups/monitoring-rg/providers/Microsoft. Insights/workbooks/a0a0a0a0-bbbb-cc-dddd-e1e1e1e1e1e1' dengan nama tampilan 'Laporan Bulanan'."
  • "Ubah konten terserialisasi dari buku kerja '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' untuk menyertakan bagan metrik baru."
Pengaturan Diperlukan atau opsional Description
ID Buku Kerja Diperlukan ID sumber daya Azure buku kerja yang akan diperbarui.
Nama tampilan Fakultatif Nama tampilan buku kerja.
Konten berseri Fakultatif Konten yang diserialisasi dalam format JSON dari lembar kerja.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal

Buku kerja: Menghapus buku kerja

Hapus satu atau beberapa buku kerja berdasarkan ID sumber daya Azure mereka. Perintah ini melakukan penghapusan sementara pada buku kerja, mempertahankannya selama 90 hari. Anda dapat memulihkannya dari Keranjang Sampah melalui portal Azure jika diperlukan.

Untuk operasi batch, Anda dapat memberikan beberapa Workbook IDs nilai. Perintah melaporkan kegagalan parsial per buku kerja, memastikan bahwa kegagalan individual tidak memengaruhi seluruh operasi batch.

Untuk mempelajari selengkapnya, lihat Kelola buku kerja Azure Monitor.

Contoh perintah meliputi:

  • Hapus buku kerja dengan ID sumber daya '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1'.
  • "Hapus buku kerja dengan ID sumber daya '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' dan '/subscriptions/def456/resourceGroups/analytics-rg/providers/Microsoft.Insights/workbooks/c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3'."
Pengaturan Diperlukan atau opsional Description
ID Buku Kerja Diperlukan ID sumber daya Azure dari Workbook yang akan dihapus. Mendukung beberapa nilai untuk operasi batch.

Petunjuk anotasi alat:

Destruktif Idempotent Dunia Terbuka Baca Saja Secret Diperlukan Lokal