Azure İzleyici ve Çalışma Kitapları için Azure MCP Sunucu araçları

Azure Model Bağlam Protokolü (MCP) Sunucusu, Azure İzleyici ve Çalışma Kitapları kaynaklarını doğal dil istemleriyle yönetmenize olanak tanır. Log Analytics çalışma alanlarını sorgulayabilir, operasyonel verileri analiz edebilir, kaynak durumunu izleyebilir, performans ölçümlerini alabilir, kullanılabilirlik web testlerini yönetebilir, izleme iş akışlarını düzenleyebilir ve Azure İzleyici çalışma kitaplarını yönetebilirsiniz.

Azure İzleyici uygulamalarınızın ve hizmetlerinizin kullanılabilirliğini ve performansını en üst düzeye çıkarmanıza yardımcı olur. Bulut ve şirket içi ortamlarınızdan telemetri verilerini toplamak, analiz etmek ve üzerinde işlem gerçekleştirmek için kapsamlı bir çözüm sağlar.

Çalışma kitapları, Azure portalında veri analizi ve zengin görsel raporlar oluşturmak için esnek bir tuval sağlar. Bunlar, Azure genelinden birden çok veri kaynağına bağlanmanıza ve bunları birleşik etkileşimli deneyimlerde birleştirmenize olanak sağlar. Çalışma kitapları, birden çok görselleştirme ve analiz türünü birleştirmenizi sağlayarak serbest biçimli keşifler için harika bir seçim haline getirir. Daha fazla bilgi için bkz. Azure İzleyici çalışma kitapları belgeleri.

Uyarı

Tool parametreleri: Azure MCP Sunucusu araçları, görevleri tamamlamak için ihtiyaç duydukları verilerin parametrelerini tanımlar. Bu parametrelerden bazıları her araci özeldir ve burada belgelenmiştir. Diğer parametreler geneldir ve tüm araçlar tarafından paylaşılır. Daha fazla bilgi için bkz . Araç parametreleri.

Etkinlik Günlüğü: Etkinlik günlüklerini alma

Belirtilen Azure kaynağı için belirli sayıda geçmiş saat için Azure İzleyici etkinlik günlüklerini listeler. Bu araç kaynak dağıtım geçmişini, yapılandırma değişikliklerini ve erişim desenlerini anlamanıza yardımcı olur. Zaman damgası, işlem adı, durum ve çağıran bilgilerini içeren etkinlik günlüğü olaylarını döndürür. Başarısız dağıtımları, beklenmeyen değişiklikleri veya erişim sorunlarını araştırmak için sonuçları kullanın.

Örnek istemler şunlardır:

  • "'webapp-prod' kaynağının son '720' saatinin etkinlik günlüklerini listeleyin."
Parametre Gerekli veya isteğe bağlı Description
Kaynak adı Gerekli Etkinlik günlüklerini almak için Azure kaynağının adı.
Olay düzeyi Opsiyonel Elde edilecek etkinlik günlüklerinin seviyesi. Geçerli düzeyler şunlardır: Critical, Error, Informational, Verbose, Warning. Sağlanmadığı durumda, tüm seviyeleri döndürür.
Hours Opsiyonel Etkinlik günlüklerinin alınması için şu andan önceki saat sayısı.
Kaynak türü Opsiyonel Azure kaynağının türü (örneğin, 'Microsoft.Storage/storageAccounts'). Aynı adı taşıyan birden fazla kaynak arasında ayrım yapmak gerekiyorsa, bunu sağlayın.
Üst Opsiyonel Alınacak etkinlik günlüğü sayısı üst sınırı.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ✅ ❌ ✅ ❌ ❌

Web Testleri: Web testi oluşturma veya güncelleştirme

Model Bağlam Protokolü (MCP) araçlarının bir parçası olan bu araç, uç nokta kullanılabilirliğini denetlemek için Azure İzleyici standart bir web testi oluşturur veya güncelleştirir. URL, sıklık, konumlar ve beklenen yanıtlar gibi izleme ayarlarını belirtirsiniz. Test yoksa, bu araç bunu oluşturur; aksi takdirde mevcut testi yeni ayarlarla güncelleştirir.

Örnek istemler şunlardır:

  • Yeni bir Standart Web Testi oluşturun ve bunu 'rg-prod-monitoring' kaynak grubundaki 'webtest-prod-availability' webtest kaynağı ile oluşturduktan sonra, AppInsights bileşeni '/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod' ile ilişkilendirin.
  • "Mevcut Standart Web Testi'ni, 'rg-prod-monitoring' kaynak grubundaki 'webtest-prod-availability' webtest kaynağı için AppInsights bileşeni '/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod' ile bağlamak için güncelleyin."
Parametre Gerekli veya isteğe bağlı Description
Kaynak Grubu Gerekli Azure kaynak grubunun adı.
Webtest kaynağı Gerekli Üzerinde çalışacak Web Testi kaynağının adı.
Appinsights bileşeni Opsiyonel Web testiyle ilişkilendirilecek Application Insights bileşeninin kaynak kimliği.
Açıklama Opsiyonel Web testinin kısa bir açıklaması.
Enabled Opsiyonel Web testinin etkinleştirilip etkinleştirilmediği.
Beklenen durum kodu Opsiyonel Http durum kodu bekleniyor.
Yeniden yönlendirmeleri takip et Opsiyonel HTTP yeniden yönlendirmelerinin izlenip izlenmeyeceği.
Sıklık Opsiyonel Saniye cinsinden test sıklığı. Desteklenen değerler: 300, 600, 900.
Üst Bilgileri Opsiyonel İstekte virgülle ayrılmış KEY=VALUE çiftleri olarak eklenecek HTTP üst bilgileri.
HTTP fiili Opsiyonel Kullanılacak HTTP yöntemi, örneğin alma veya gönderme.
Durum kodunu yoksay Opsiyonel Durum kodu doğrulamasının göz ardı edilip edilmeyeceği.
Location Opsiyonel Web testi kaynağının oluşturulduğu konum. Bu, Application Insights bileşen konumuyla eşleşmelidir.
İstekleri ayrıştırma Opsiyonel Bağımlı isteklerin ayrıştırılıp ayrıştırılmayacağı.
İstek içeriği Opsiyonel İstekle birlikte gönderilecek içerik.
İstek URL’i Opsiyonel Test edilecek mutlak URL.
Yeniden deneme etkinleştirildi Opsiyonel Yeniden denemelerin etkinleştirilip etkinleştirilmediği.
SSL denetimi Opsiyonel SSL sertifikalarının doğrulanıp doğrulanmayacağı.
SSL yaşam süresi denetimi Opsiyonel SSL sertifika ömrünün denetlenecek gün sayısı.
Timeout Opsiyonel İstek zaman aşımı süresi (saniye cinsinden). Desteklenen değerler: 30, 60, 90, 120.
Web testi adı Opsiyonel Web testi kaynağındaki testin adı.
Web testi konumları Opsiyonel Testin çalıştırılacak konumların virgülle ayrılmış listesi. Konum, Kullanılabilirlik Testleri için coğrafi konum popülasyon etiketine başvurur.
Webtest Opsiyonel Web testi yapılandırması.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
✅ ✅ ❌ ❌ ❌ ❌

Web Testleri: Web testi alma

Bu araç belirli bir web testinin ayrıntılarını alır veya tüm web testlerini listeler. Webtest kaynağını belirttiğinizde, bu araç bu web testi için ayrıntılı bilgileri döndürür. Webtest kaynağını belirtmediğinizde, bu araç abonelikteki tüm web testlerinin listesini döndürür ve listeyi kaynak grubuna göre filtreleyebilirsiniz.

Örnek istemler şunlardır:

  • "Aboneliğimdeki 'rg-monitoring' kaynak grubunda yer alan 'webtest-prod' webtest kaynağının Web Testi ayrıntılarını alın."
  • "Aboneliğimdeki tüm Web Testi kaynaklarını listele."
  • "Aboneliğimdeki tüm Web Testi kaynaklarını 'rg-prod' kaynak grubunda listele."
Parametre Gerekli veya isteğe bağlı Description
Webtest kaynağı Opsiyonel Üzerinde çalışacak Web Testi kaynağının adı.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ✅ ❌ ✅ ❌ ❌

Log Analytics: Çalışma alanlarını listeleme

Bu araç, abonelikteki Log Analytics çalışma alanlarını listeler. Her çalışma alanının adını, kimliğini, konumunu ve diğer anahtar özelliklerini alır. Günlüklerini sorgulamadan veya çalışma alanı ayarlarını incelemeden önce çalışma alanlarını tanımlamak için bunu kullanabilirsiniz.

Örnek istemler şunlardır:

  • "Aboneliğimdeki Log Analytics çalışma alanlarını listele."
  • "Log Analytics çalışma alanlarımı görüntüle."
  • Aboneliğimdeki Log Analytics çalışma alanlarını al.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ✅ ❌ ✅ ❌ ❌

Log Analytics: Tabloları listeleme

Bu araç, Log Analytics çalışma alanında yer alan tüm tabloları listeler. Örneğin, kullanılabilir sütunları ve veri türlerini önizlemek için 'rg-monitoring' kaynak grubundaki 'prod-law' çalışma alanındaki tabloları listeleyin. Kusto Sorgu Dili (KQL) sorguları oluşturmak için kullandığınız tablo adlarını ve şemaları döndürür. Tablo türüne göre filtreleyebilirsiniz, örneğin CustomLog veya AzureMetrics.

Örnek istemler şunlardır:

  • "'CustomLog' tablo türündeki tüm tabloları 'rg-prod' kaynak grubundaki 'prod-law' Log Analytics çalışma alanında listeleyin."
  • "'rg-monitoring' kaynak grubundaki 'f1b2c3d4-5678-90ab-cdef-1234567890ab' çalışma alanı için 'AzureMetrics' tablo türündeki tabloları göster."
Parametre Gerekli veya isteğe bağlı Description
Kaynak Grubu Gerekli Azure kaynak grubunun adı.
Çalışma alanı adı Gerekli Log Analytics çalışma alanı kimliği veya adı. Bu, benzersiz tanımlayıcı (GUID) veya çalışma alanınızın görünen adı olabilir.
Tablo türü Gerekli Filtrelenecek tablo türü.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ✅ ❌ ✅ ❌ ❌

Log Analytics: Tablo türlerini alma

Bu Model Bağlam Protokolü (MCP) aracı, bir Azure Log Analytics çalışma alanında kullanılabilir tablo türlerini listeler. Tablo türlerinin adlarını geri döndürür. Azure İzleyici Günlüklerine sorgu yazarken bu adları kullanabilirsiniz.

Örnek istemler şunlardır:

  • "‘rg-prod’ kaynak grubundaki ‘prod-law-01’ Log Analytics çalışma alanındaki tüm mevcut tablo türlerini listeleyin."
  • "'rg-logs' kaynak grubundaki 'analytics-workspace' adlı Log Analytics çalışma alanında hangi tablo türleri mevcut?"
Parametre Gerekli veya isteğe bağlı Description
Kaynak Grubu Gerekli Azure kaynak grubunun adı.
Çalışma alanı adı Gerekli Log Analytics çalışma alanının adı veya kimliği. Çalışma alanı GUID'sini veya görünen adı kullanabilirsiniz.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ✅ ❌ ✅ ❌ ❌

Log Analytics: Çalışma alanı günlüklerini sorgulama

Kusto Sorgu Dili (KQL) kullanarak bir Log Analytics çalışma alanının tamamında sorgu yapmak. Çalışma alanı içindeki tüm kaynaklar ve tablolar genelinde günlükleri döndüren sorguları çalışma alanı genelinde çalıştıran bu araçtır. Bu araç, Model Bağlam Protokolü (MCP) araçlarının bir parçasıdır. Örneğin şunları sorabilirsiniz: 'Çalışma alanımdaki tüm hataları göster', 'son 24 saat içinde çalışma alanımda ne oldu', 'çalışma alanı genelinde başarısız istekleri listeleme'.

Örnek istemler şunlardır:

  • 'rg-prod' kaynak grubundaki Log Analytics çalışma alanı 'my-workspace' içinde yer alan 'Syslog' tablosunda 'hatalar' sorgusunu kullanarak günlükleri göster.
Parametre Gerekli veya isteğe bağlı Description
Sorgu Gerekli Log Analytics çalışma alanında çalıştırılacak Kusto Sorgu Dili (KQL) sorgusu. Önceden tanımlanmış sorguları ada göre kullanabilirsiniz: recent TimeGenerated tarafından sıralanan en son günlükleri gösterir; errors TimeGenerated tarafından sıralanan hata düzeyi günlükleri gösterir. Veya özel bir KQL sorgusu sağlayın.
Kaynak Grubu Gerekli Azure kaynak grubunun adı.
Tablo adı Gerekli Çalışma alanı içinde sorgu için tablonun adı.
Çalışma alanı adı Gerekli Log Analytics çalışma alanı kimliği veya adı. Küresel olarak benzersiz tanımlayıcıyı (GUID) veya çalışma alanının görünen adını sağlayabilirsiniz.
Hours Opsiyonel Şu andan geriye doğru sorgulanacak saat sayısı.
Limit Opsiyonel Döndürülecek en fazla sonuç sayısı.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ✅ ❌ ✅ ❌ ❌

Log Analytics: Kaynak günlüklerini sorgulama

Kusto Sorgu Dili (KQL) kullanarak Log Analytics çalışma alanında belirli bir Azure kaynağın tanılama ve etkinlik günlüklerini sorgula. Bu araç sonuçları belirtilen kaynağa filtreler ve seçilen tabloda sağlanan KQL sorgusunu çalıştırır. Örneğin, "Son 24 saat için 'app-monitor' kaynağının günlüklerini göster" sorusunu sorun.

Örnek istemler şunlardır:

  • Kaynak kimliği '/subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/rg-prod/providers/Microsoft.Compute/virtualMachines/my-vm' olan kaynak için, 'AzureDiagnostics' tablosunda 'recent' sorgusuyla günlükleri gösterin.
Parametre Gerekli veya isteğe bağlı Description
Sorgu Gerekli Log Analytics çalışma alanında yürütülecek KQL sorgusu. Önceden tanımlanmış sorguları ada göre kullanabilirsiniz: recent TimeGenerated tarafından sıralanan en son günlükleri gösterir; errors TimeGenerated tarafından sıralanan hata düzeyi günlükleri gösterir. Aksi takdirde, özel bir KQL sorgusu sağlayın.
Kaynak Kimliği Gerekli Sorgu için kaynağın Azure Kaynak Kimliği. Örnek: /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.OperationalInsights/workspaces/<ws>.
Tablo adı Gerekli Çalışma alanı içinde sorgu için tablonun adı.
Hours Opsiyonel Şu andan geriye doğru sorgulanacak saat sayısı.
Limit Opsiyonel Döndürülecek en fazla sonuç sayısı.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ✅ ❌ ✅ ❌ ❌

Sistem durumu modelleri: Sistem durumu modellerini listeleme

Azure İzleyici sistem durumu modeli kaynağındaki tüm sistem durumu modellerini listeler. Bu araç, uygulama düzeyinde sistem durumunu izlemek için kullanılabilir sistem durumu modellerini keşfetmenize yardımcı olur. Model Bağlam Protokolü (MCP) aracı, temel kaynak kullanılabilirliğini değil özel sistem durumu modellerini temel alan uygulama düzeyinde sistem durumunu raporlar. Temel kaynak kullanılabilirliği için Azure Kaynak Durumu kullanın. Log Analytics çalışma alanında günlükleri sorgulamak için azmcp_monitor_workspace_log_query kullanın. Belirli bir Azure kaynağın günlüklerini sorgulamak için azmcp_monitor_resource_log_query kullanın.

Örnek istemler şunlardır:

  • 'rg-prod' kaynak grubundaki 'app-health-monitor' sağlık modeli kaynağındaki tüm sağlık modellerini listeleyin.

Örnek CLI komutu

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

Araç ek açıklaması ipuçları:

Yıkıcı: ❌ | Idempotent: ✅ | Açık Dünya: ❌ | Salt Okunur: ✅ | Gizli: ❌ | Yerel Gerekli: ❌

Sağlık modelleri: Sağlık modelini al

Azure İzleyici sistem durumu model kaynağından adına göre belirli bir sistem durumu modelini alır. Bu araç, belirli bir sağlık modeli için sağlık durumunu ve en son sağlık olaylarını döndürür. Model Bağlam Protokolü (MCP) aracı, temel kaynak kullanılabilirliğini değil özel sistem durumu modellerini temel alan uygulama düzeyinde sistem durumunu raporlar. Temel kaynak kullanılabilirliği için Azure Kaynak Durumu kullanın. Log Analytics çalışma alanında günlükleri sorgulamak için azmcp_monitor_workspace_log_query kullanın. Belirli bir Azure kaynağın günlüklerini sorgulamak için azmcp_monitor_resource_log_query kullanın.

Örnek istemler şunlardır:

  • 'rg-prod' kaynak grubundaki 'app-health-monitor' sistem durumu modeli kaynağından 'order-service-health' sistem durumu modelini alın.
Parametre Gerekli veya isteğe bağlı Description
Sistem durumu modeli Gerekli Alınacak sağlık modelinin adı.
Kaynak Grubu Gerekli Azure kaynak grubunun adı.

Uyarı

3.0.0-beta.24 ve önceki sürümlerden geçiş: Komut monitor healthmodels entity get 3.0.0-beta.25 sürümünde kaldırılır. Tüm sistem durumu modellerini listelemek için monitor healthmodels get kullanın veya adına göre belirli bir sistem durumu modelini almak için monitor healthmodels list kullanın.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ✅ ❌ ✅ ❌ ❌

Ölçümler: Sorgu ölçümleri

Bir kaynağın Azure İzleyici ölçümlerini sorgula. Bu araç, belirtilen ölçümler için zaman serisi verilerini döndürerek kaynak performansını ve kullanılabilirliğini analiz etmenize yardımcı olur. Bu araç, Model Bağlam Protokolü (MCP) araçlarının bir parçasıdır.

Örnek istemler şunlardır:

  • "Application Insights kaynağı 'appinsights-prod' için, 'requests/duration' ölçümleri ve 'microsoft.insights/components' ölçüm ad alanı kullanılarak performans eğilimlerini ve yanıt sürelerini analiz edin."
  • "'microsoft.insights/components' metrik ad alanını kullanarak 'appinsights-staging' Application Insights kaynağı için 'availabilityResults/availabilityPercentage' kullanılabilirlik metriğini denetleyin?"
  • "'microsoft.insights/components' ölçüm ad alanını kullanarak 'appinsights-prod' kaynağı için 'Ortalama' toplaması ve 'PT1M' aralığıyla 'istekler/süre' ölçümünü alın."
  • "Hata oranlarını ve başarısız istekleri, 'appinsights-prod' Application Insights kaynağı için "istekler/başarısız" ve "istisnalar/sayı" gibi metrikleri ve 'microsoft.insights/components' metrik ad alanını kullanarak araştırın."
  • 'Microsoft.Insights/bileşenleri' kaynak türü için 'appinsights-qa' kaynağının 'requests/count' metriğini, ölçüt ad alanı 'microsoft.insights/components' ve aralık 'PT5M' ile sorgulayın.
  • "'appinsights-prod' Application Insights kaynağı için 'Count' toplaması ve 'microsoft.insights/components' ölçüm ad alanı ile 'requests/count' metriğini kullanarak saniye başına istek oranı nedir?"
Parametre Gerekli veya isteğe bağlı Description
Ölçüm adları Gerekli Sorgu için virgülle ayrılmış ölçümlerin adları.
Metrik ad alanı Gerekli Sorgu için metrik ad alanı. Bu değeri azmcp-monitor-metrics-definitions aracından alın.
Kaynak adı Gerekli Ölçüm sorgularının yapılacağı Azure kaynağının adı.
Toplama Opsiyonel Ortalama, Maksimum, Minimum, Toplam veya Sayı gibi kullanılacak toplama türü.
Bitiş saati Opsiyonel Sorgunun ISO biçimindeki bitiş saati (örneğin, 2023-01-01T00:00:00Z). Varsayılan olarak şimdiki zamana ayarlanır.
Filtre Opsiyonel Ölçüm sorgusuna uygulanacak OData filtresi.
Aralık Opsiyonel Veri noktalarının zaman aralığı (örneğin, PT1H 1 saat, PT5M 5 dakika).
En fazla demet Opsiyonel Döndürülecek en fazla zaman dilimi sayısı. Varsayılan değer 50'dir.
Kaynak türü Opsiyonel Azure kaynak türü (örneğin, Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Belirtilmezse, araç kaynak adından türü çıkarsamaya çalışır.
Başlangıç saati Opsiyonel Sorgunun ISO biçimindeki başlangıç zamanı (örneğin, 2023-01-01T00:00:00Z). Varsayılan olarak 24 saat öncesine ayarlanır.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ✅ ❌ ✅ ❌ ❌

Ölçümler: Ölçüm tanımlarını listeleme

Bu araç, bir Azure kaynağı için ölçüm tanımlarını listeler. Ad alanları, açıklamalar ve toplama türleri dahil olmak üzere her ölçümle ilgili meta verileri döndürür, böylece kaynak için hangi ölçümlerin sorgulanabileceğini belirleyebilirsiniz.

Örnek istemler şunlardır:

  • "'app-insights-prod' kaynak adı için ölçüm tanımlarını alın."
  • "Kaynak adı 'mystorageacct', kaynak türü 'Microsoft.Storage/storageAccounts' ve ölçüm ad alanı 'Storage' olan ölçüm tanımlarını listeleyin."
  • "'vm-prod-01' kaynak adı için 'cpu' arama dizesi ve sınır '20' ile ölçüm tanımlarını göster."
Parametre Gerekli veya isteğe bağlı Description
Kaynak adı Gerekli Ölçüm sorgularının yapılacağı Azure kaynağının adı.
Limit Opsiyonel Döndürülecek en fazla ölçüm tanımı sayısı. Varsayılan değer 10'dır.
Metrik ad alanı Opsiyonel Sorgu için metrik ad alanı. Bu değeri azmcp-monitor-metrics-definitions aracından alın.
Kaynak türü Opsiyonel Azure kaynak türü (örneğin, Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Belirtmezseniz, araç kaynak adından kaynak türünü çıkarsamaya çalışır.
Arama dizesi Opsiyonel Ölçüm tanımlarını filtrelemek için bir dize. Filtre, ölçüm adında ve açıklamasında büyük/küçük harfe duyarsız eşleştirme gerçekleştirir.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ✅ ❌ ✅ ❌ ❌

Enstrümantasyon: Öğrenme kaynağını alma

Bu araç, Azure İzleyici izleme için tüm kullanılabilir öğrenme kaynaklarını listeler veya belirli bir kaynağın içeriğini yola göre alır. Araç varsayılan olarak tüm kaynak yollarını döndürür. Bir yol belirtirseniz, araç kaynak içeriğinin tamamını döndürür. Bir uygulamayı işaretlemek için orchestrator-start aracını kullanın.

Örnek istemler şunlardır:

  • 'Onboarding/get-started.md' dizinindeki karşılama öğrenme kaynağına erişin.
  • "'onboarding/quickstart.md' yolundaki Azure İzleyici katılım süreci öğrenme kaynağının içeriğini göster."
  • "'samples/instrumentation-guide.html' yolundaki Azure İzleyici öğrenme kaynak dosyasının içeriğini alın."
  • Azure İzleyici başlangıç öğrenme kaynaklarının tümünü listeleyin.
  • Azure İzleyici araçlarının izleme kaynak yollarını göster.
  • Azure İzleyici araç yüklemesi için hangi öğrenme kaynakları mevcut?
Parametre Gerekli veya isteğe bağlı Description
Path Opsiyonel Öğrenme Kaynakları Yolu

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ✅ ❌ ✅ ❌ ✅

Enstrümantasyon: Orkestrasyonu başlatma

Azure İzleyici'u kontrol eden Model Bağlam Protokolü (MCP) araçlarına buradan başlayın. Bu araç çalışma alanını analiz eder ve yürütülecek ilk eylemi döndürür. Eylemi yürüttkten sonra devam etmek için orchestrator-next öğesini çağırın. Eylemi instruction alanında tam olarak izleyin.

Örnek istemler şunlardır:

  • "'/home/dev/workspace-monitoring' çalışma alanı yolu için Azure İzleyici izleme düzenlemesini başlatın."
  • "'/src/projects/my-app-workspace' çalışma alanı yolunu analiz edin ve ilk Azure İzleyici izleme adımını döndür."
  • "'/workspace/my-app' çalışma alanı yolunda proje için kılavuzlu Azure İzleyici eklemeye başlayın ve bana birinci adımı verin."
Parametre Gerekli veya isteğe bağlı Description
Çalışma alanı yolu Gerekli Çalışma alanı klasörünün mutlak yolu.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ❌ ❌ ❌ ❌ ✅

Enstrümantasyon: Orkestrasyona devam et

Mevcut enstrümantasyon eylemini tamamladıktan sonra sonraki enstrümantasyon eylemini yapın.

Bu araç, Model Bağlam Protokolü (MCP) paketinin bir parçasıdır.

Önceki yanıttaki instruction'i tam olarak yürüttükten sonra, sonraki eylemi elde etmek için bu aracı çalıştırın.

Beklenen iş akışı:

  1. Orchestrator-start veya orchestrator-next'den bir eylem alırsınız.
  2. Alanı instruction tam olarak yürütürsünüz.
  3. Sonraki eylemi almak için bu aracı kısa Completion note bir süreyle çalıştırırsınız.

Döndürür: Yürütülecek sonraki eylem veya tüm adımlar tamamlandığında complete durumu.

Örnek istemler şunlardır:

  • "Önceki Azure İzleyici izleme adımını tamamladıktan sonra, 'session-abc123' oturum kimliği için 'Program.cs'a UseAzureMonitor() eklendi' tamamlama notunu içeren bir sonraki eylemi alın."
  • "'workspace/session-2026' oturum kimliği için sonraki onboarding eylemini alın ve 'dotnet add package Microsoft.ApplicationInsights' tamamlamasıyla birlikte."
  • Önceki enstrümantasyon adımını tamamladıktan sonra, 'session-789xyz' oturum kimliği için 'Application Insights'ı etkinleştirmek amacıyla appsettings.json güncellendi' tamamlanma notunu içeren bir sonraki adıma geçin.
Parametre Gerekli veya isteğe bağlı Description
Tamamlanma notu Gerekli Gerçekleştirdiğiniz işlemi açıklayan bir cümle yazın, örneğin, 'dotnet add package komutunu çalıştırdım' veya 'Program.cs'ye UseAzureMonitor() ekledim'.
oturum kimliği Gerekli Orchestrator-start'tan sessionId olarak döndürülen çalışma alanı yolu.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ❌ ❌ ❌ ❌ ✅

Enstrümantasyon: Brownfield analizi gönderme

Durum orchestrator-start döndüğünde analysis_needed brownfield kod analizi bulgularını gönderir. Bu araç, Model Bağlam Protokolü (MCP) iş akışının bir parçasıdır. Bu aracı çağırmadan önce çalışma alanı kaynak dosyalarını taramalı ve analiz şablonunu doldurmalısınız. Bu araç başarılı olduktan sonra orchestrator-next ile devam edin.

Örnek istemler şunlardır:

  • "Analiz istendikten sonra brownfield kod analizi bulguları JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' öğesini Azure İzleyici enstrümantasyon oturumuna 'workspace-7a3b' gönderin."
  • "'{"serviceOptions":{"found":true,"details":"AddApplicationInsightsTelemetry used"},"initializers":[],"processors":[]," bulgularını göndererek geçiş düzenlemeye devam edin clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' to session 'sess-01234'."
  • "Tamamlanmış brownfield telemetri analizini bulgular JSON'ı olarak '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":{"found":true},"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":{"found":true}}' dahil edilme oturumu 'session-9f3b' için gönderin."
Parametre Gerekli veya isteğe bağlı Description
Bulgular JSON Gerekli Brownfield analiz bulgularına sahip JSON nesnesi. Gerekli özellikler: serviceOptions (AddApplicationInsightsTelemetry() çağrısını analiz ederken elde edilen hizmet seçenekleri bulguları, bulunamazsa null), başlatıcılar (ITelemetryInitializer veya IConfigureOptions<TelemetryConfiguration> uygulamalarını analiz ederek elde edilen telemetri başlatıcı bulguları, yoksa null), işlemciler (ITelemetryProcessor uygulamalarını analizden elde edilen telemetri işlemcisi bulguları, bulunamazsa null), clientUsage (doğrudan TelemetryClient kullanımı analizinden gelen TelemetryClient kullanım bulguları, bulunamazsa null), örnekleme (özel örnekleme yapılandırması bulguları, özel örnekleme yoksa null), telemetryPipeline (özel ITelemetryChannel veya TelemetrySinks kullanım bulguları, bulunamazsa null), loglama (açık log sağlayıcısı ve filtre bulguları, bulunamazsa null). Kod tabanında mevcut olmayan bölümler için boş bir varsayılan nesne geçirin; örneğin, null yerine found: false veya hasCustomSampling: false.
oturum kimliği Gerekli sessionId olarak orchestrator-start'den çalışma alanı yolu döndürülür.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ❌ ❌ ❌ ❌ ✅

Enstrümantasyon: Geliştirme seçimi gönderimi

Durumu orchestrator-start döndürdüğünde kullanıcının geliştirme seçimini enhancement_available gönderin. Kullanıcıya geliştirme seçeneklerini sunun ve ardından seçilen geliştirme anahtarlarıyla bu aracı çağırın. Virgülle ayrılmış bir liste geçirerek birden çok geliştirme seçebilirsiniz; örneğin, redis,processors. Bu araç başarılı olduktan sonra orchestrator-next ile devam edin.

Örnek istemler şunlardır:

  • "Azure İzleyici izleme oturumu kimliği 'workspaces/my-app/session-abc123' için 'redis,processors' geliştirme anahtarlarını gönderin."
  • "'workspaces/prod-app/session-789' oturum kimliğine geliştirme anahtarları 'redis' göndererek izleme geliştirme akışına devam edin."
  • "'workspaces/onboard/session-456' oturum kimliği ekleme için seçilen geliştirme anahtarlarını 'entityframework,otlp' gönderin."
Parametre Gerekli veya isteğe bağlı Description
Geliştirme anahtarları Gerekli Virgülle ayrılmış bir veya daha fazla geliştirme tuşu (örneğin, redis, redis,processors, entityframework,otlp).
oturum kimliği Gerekli sessionId olarak orchestrator-start'den çalışma alanı yolu döndürülür.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ❌ ❌ ❌ ❌ ✅

Çalışma Kitapları: Çalışma kitaplarını listeleme

Hızlı meta veri sorguları için Kaynak Grafı'nı kullanarak Azure Çalışma Kitaplarında arama. Bu araç çalışma kitaplarını farklı kapsamlarda bulmanıza, filtrelemenize ve saymanıza yardımcı olur.

Çalışma kitabının meta verilerini, id, name, location ve zaman damgalarını içeren category, döndürür. Varsayılan olarak, tam çalışma kitabı içeriğini (serializedData) döndürmez — bunun için göster aracını kullanın veya Output format'i full olarak ayarlayın.

Varsayılan olarak, arama geçerli Azure bağlamınızdaki (kiracı/abonelik) çalışma kitaplarını hedefler. Arama kapsamınızı açıkça belirtmek için kullanabilirsiniz Resource group . Araç varsayılan olarak sunucu tarafı toplam sayısını döndürür. Döndürülen en fazla sonuç sayısı 50'dir ve maksimum limit 1000'dir; bunu Max results ile ayarlayın. En az belirteç veya tam Output format çıkış için olarak summary seçeneğini belirleyinfull.serializedData

Örnek istemler şunlardır:

  • "'monitoring-rg' kaynak grubundaki tüm çalışma kitaplarını göster."
  • "'prod-rg' kaynak grubundaki paylaşılan çalışma kitaplarını listeleyin."
  • "'analytics-rg' kaynak grubunda 2024-01-15'in ardından hangi çalışma kitapları değiştirildi?"
Parametre Gerekli veya isteğe bağlı Description
Kaynak Grubu Opsiyonel Azure kaynak grubunun adı.
Kategori Opsiyonel Çalışma kitaplarını kategoriye göre filtreleyin (örneğin, workbook, sentinel, TSG). Belirtilmezse, tüm kategoriler döndürülür.
Toplam sayıyı dahil et Opsiyonel Yanıta eşleşen tüm çalışma kitaplarının toplam sayısını ekleyin (varsayılan: true).
Kind Opsiyonel Çalışma kitaplarını türe göre filtreleyin (örneğin, shared, user). Belirtilmezse, tüm türler döndürülür.
En fazla sonuç Opsiyonel Döndürülecek sonuç sayısı üst sınırı (varsayılan: 50, maksimum: 1000).
Değiştirildikten sonra Opsiyonel Bu tarihten sonra değiştirilen çalışma kitaplarını filtreleyin (ISO 8601 biçimi, örneğin, 2024-01-15).
Ad şunu içerir: Opsiyonel Görünen adın bu metni içerdiği çalışma kitaplarını filtreleyin (büyük/küçük harfe duyarsız).
Çıktı biçimi Opsiyonel Çıkış biçimi: summary (Yalnızca kimlik ve ad, en az belirteç), standard (içeriksiz meta veriler, varsayılan), full (içerir serializedData).
Kaynak Kimliği Opsiyonel Çalışma kitaplarını kaynak kaynak kimliğine göre filtreleyin (örneğin, /subscriptions/abc123/resourceGroups/prod/providers/Microsoft.Insights/components/myapp). Belirtilmezse, tüm çalışma kitapları döndürülür.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ✅ ❌ ✅ ❌ ❌

Çalışma Kitapları: Çalışma kitabı ayrıntılarını göster

serializedData içeriği dahil olmak üzere Azure Resource Manager (ARM) API'si aracılığıyla tam çalışma kitabı ayrıntılarını alın. Bu komut, görselleştirme JSON'u da içeren tam çalışma kitabı tanımını almanıza olanak tanır.

Tam çalışma kitabı özelliklerini, serializedData, etiketlerini ve ETag döndürür. Toplu işlemler için birden çok Workbook IDs sağlayabilirsiniz. Komut, tek tek çalışma kitapları için kısmi hataları bildirir. Daha iyi performans için, önce çalışma kitaplarını bulmak için liste aracını kullanın, ardından belirli çalışma kitapları için show komutunu kullanın.

Örnek istemler şunlardır:

  • "Kaynak Kimliği '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1' olan çalışma kitabının ayrıntılarını göster."
  • "'/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' çalışma kitabının tam tanımını alın."
Parametre Gerekli veya isteğe bağlı Description
Çalışma Kitabı Kimlikleri Gerekli Alınacak çalışma kitaplarının Azure kaynak kimlikleri nelerdir? Toplu işlemler için birden çok değeri destekler.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
❌ ✅ ❌ ✅ ❌ ❌

Çalışma Kitapları: Çalışma kitabı oluşturma

Belirtilen kaynak grubunda ve abonelikte yeni bir çalışma kitabı oluşturun. Çalışma kitabı için görünen adı ve serileştirilmiş JSON içeriğini ayarlayabilirsiniz. Bu komut, başarıyla tamamlandıktan sonra oluşturulan çalışma kitabı bilgilerini döndürür.

Örnek istemler şunlardır:

  • "Temel bir not defterinin serileştirilmiş içeriğiyle 'monitoring-rg' kaynak grubunda 'Performans Panosu' adlı yeni bir çalışma kitabı oluşturun."
  • "VM ölçümlerini gösteren içerikle 'prod-rg' kaynak grubunda 'Altyapıya Genel Bakış' adlı bir çalışma kitabı oluşturun."
Parametre Gerekli veya isteğe bağlı Description
Görüntü adı Gerekli Çalışma kitabının görünen adı.
Kaynak Grubu Gerekli Azure kaynak grubunun adı.
Serileştirilmiş içerik Gerekli Çalışma kitabının serileştirilmiş JSON içeriği.
Kaynak Kimliği Opsiyonel Çalışma kitabının bağlı kaynak kimliği. Varsayılan olarak, bu şeklindedir azure monitor.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
✅ ❌ ❌ ❌ ❌ ❌

Çalışma Kitapları: Çalışma kitabını güncelleştirme

Yeni adımlar ekleyerek, içeriği değiştirerek veya görünen adı değiştirerek mevcut Azure çalışma kitabının özelliklerini güncelleştirin. Bu eylem güncelleştirilmiş çalışma kitabı ayrıntılarını döndürür. Çalışma kitabı kaynak kimliğine ihtiyacınız vardır ve yeni serileştirilmiş içerik veya yeni bir görünen ad belirtebilirsiniz.

Örnek istemler şunlardır:

  • "/subscriptions/abc123/resourceGroups/monitoring-rg/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1 çalışma kitabını 'Aylık Rapor' görüntüleme adıyla güncelleştirin."
  • "'/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' çalışma kitabının serileştirilmiş içeriğini yeni bir ölçüm grafiğini dahil edecek şekilde değiştirin."
Parametre Gerekli veya isteğe bağlı Description
Çalışma Kitabı Kimliği Gerekli Güncelleştirilecek çalışma kitabının Azure kaynak kimliği.
Görüntü adı Opsiyonel Çalışma kitabının görünen adı.
Serileştirilmiş içerik Opsiyonel Çalışma kitabının JSON serileştirilmiş içeriği.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
✅ ✅ ❌ ❌ ❌ ❌

Çalışma Kitapları: Çalışma kitaplarını silme

Bir veya daha fazla çalışma kitabını Azure kaynak kimliklerine göre silin. Bu komut çalışma kitaplarında geçici silme işlemi gerçekleştirerek bunları 90 gün boyunca saklar. Gerekirse bunları Azure portalı aracılığıyla Geri Dönüşüm Kutusu'ndan geri yükleyebilirsiniz.

Toplu işlemler için birden çok Workbook IDs değer sağlayabilirsiniz. Komut, çalışma kitabı başına kısmi hatalar bildirerek tek tek hataların toplu işlemin tamamını etkilememesini sağlar.

Daha fazla bilgi edinmek için bkz. Azure İzleyici çalışma kitaplarını yönetme.

Örnek istemler şunlardır:

  • "Kaynak kimliği '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1' olan çalışma kitabını silin."
  • "Kaynak kimlikleri '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' ve '/subscriptions/def456/resourceGroups/analytics-rg/providers/Microsoft.Insights/workbooks/c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3' olan çalışma kitaplarını kaldırın."
Parametre Gerekli veya isteğe bağlı Description
Çalışma Kitabı Kimlikleri Gerekli Silinecek çalışma kitaplarının Azure kaynak kimlikleri. Toplu işlemler için birden çok değeri destekler.

Araç ek açıklaması ipuçları:

Yıkıcı İdempotent Açık Dünya Yalnızca Okunur Secret Yerel olarak gerekli
✅ ✅ ❌ ❌ ❌ ❌

İlgili içerik

  • Last updated on