Bir telemetri kaynağı bağlayın

Ajanınızın cevaplarını genel bilginize değil, kendi sinyallerinize bağlayacak bir telemetri kaynağı bağlayın. Telemetri konnektörünü kurduktan sonra, sade dilde bir soruşturma sorusu sorun. Temsilci sorguyu çalıştırır ve gerçek sayılarla cevaplar.

Bu eğitim, Telemetri kategorisindeki konnektörleri kapsar. Azure Veri Gezgini, Azure MCP Kusto yolunu kullanır. Üçüncü taraf telemetri konnektörleri, MCP kullanılsa bile Telemetri sekmesinde de görünür. Kurulum, her yönetilen bağlantıyla aynı sihirbazı kullanır, bu nedenle bu makale telemetri detaylarına odaklanır: kaynakların nasıl kimlik doğrulaması, hangi işlemlerin etkinleştirilmesi ve bir sorgu ile nasıl doğrulanacağı.

Important

Yönetilen konnektörler önizleme aşamasında. Bağlayıcı kullanılabilirliği, alanları ve operasyonları değişebilir.

Prerequisites

  • Çalışan bir SRE Temsilcisi ve sre.azure.com'ye erişim.
  • Ajanda konnektör yapılandırma izni.
  • Bağladığınız telemetri kaynağına erişimi okuyun. Bir Azure kaynağı için, bağlantıyı yetkileyen kimlik en azından hedef kaynağa okuma erişimi gerektirir.

Daha önce bir konnektör kurmadıysanız, tam sihirbaz rehberi için yönetilen bir konnektör kur olarak başlayın. Bu makale yalnızca telemetri kaynak farklarını vurgulamaktadır.

Telemetri konnektörleri

Bağlayıcı Hizmet Authentication Tipik kullanım
Azure Veri Gezgini (via Azure MCP) Azure Veri Gezgini (Kusto) İdare edilen kimlik ADX kümelerine karşı KQL sorguları çalıştır
Log Analytics Çalışma Alanı Log Analytics İdare edilen kimlik Çalışma alanı loglarını yalnızca okunma modunda sorgulayın
Application Insights Application Insights İdare edilen kimlik Yalnızca okunma modunda uygulama telemetrisini sorgulayın
Datadog Datadog Bağlantı cihazı tarafından gösterilen hizmet kimlik bilgileri Sorgulama metrikleri, loglar ve monitörler
Elasticsearch Elasticsearch Bağlantı cihazı tarafından gösterilen hizmet kimlik bilgileri Arama günlükleri ve indekslenmiş telemetri
Dynatrace Dynatrace Bağlantı cihazı tarafından gösterilen hizmet kimlik bilgileri Gözlemlenebilirlik verileri ve izlerini sorgulayın
New Relic New Relic Bağlantı cihazı tarafından gösterilen hizmet kimlik bilgileri Sorgu telemetrisi ve olaylar
Splunk Splunk Bağlantı cihazı tarafından gösterilen hizmet kimlik bilgileri Splunk kayıtları ve etkinlikleri araması
Hawkeye (NeuBird) Hawkeye, NeuBird tarafından Bağlantı cihazı tarafından gösterilen hizmet kimlik bilgileri Yapay zeka destekli gözlemlenebilirlik verilerini sorgulama

Üçüncü taraf telemetri bağlayıcıları, bağlantıyı yapılandırmanıza yardımcı olmak için varsayılan URL, kimlik doğrulama ve başlık ipuçları içerir.

Ayrıca kullanıcı tarafından sağlanan bir konnektör aracılığıyla başka bir telemetri kaynağı da ekleyebilirsiniz. Takımınızın özel bir aracı veya bağlantı seçicisinde listelenmemiş bir kaynağı varsa bu seçeneği kullanın.

Adım 1: Konnektör ekleyin

  1. sre.azure.com gidin ve temsilcinizi seçin.

  2. Sol yan panelde Builder'ı genişletin ve ardından Connectors'ı seçin.

  3. Bağlayıcı ekle'yi seçin.

  4. Telemetri sekmesini seçin ve ardından telemetri kaynağınızı seçin. Azure Veri Gezgini için, Azure MCP Kusto yolunu kullanan Azure Veri Gezgini'ı seçin.

Adım 2: Doğrulama

For Azure telemetry connectors:

  1. Bağlayıcı tarafından gösterilen alanları tamamlayın.

    • Azure Veri Gezgini için, bağlayıcıyı adlandırın, ajanın Kusto'yu sorgulamak için kullandığı yönetilen kimliği seçin ve ardından küme URL'lerine sahip bir veya daha fazla küme grubu ekleyin.
    • Log Analytics Workspace için, workspace picker'dan bir çalışma alanı seçin veya workspace ARM kaynak ID'sini manuel olarak girin.
    • Application Insights için, kaynak seçiciden bir Application Insights kaynağı seçin veya kaynak ARM kaynak kimliğini manuel olarak girin.

  2. Connector bir kimlik istediğinde Managed identity seçin.

  3. Sihirbazın gösterdiği inceleme, küme veya araç seçimi adımına devam edin.

Yönetilen kimliğin hedef kaynağa okuma erişimi olmalıdır. Eğer sorgular daha sonra izin hatası ile başarısız olursa, o kimliğe okuma erişimi verin ve sorguyu tekrar deneyin.

Adım 3: Sorgu araçlarını kurun

Araçları kur adımında, telemetri okuyan işlemleri etkinleştirin. Sorgu işlemleri, telemetri bağlayıcısının çekirdeği olduğundan, run-query veya search işlemlerini seçin. İdari işlemleri devre dışı bırakın, ihtiyacınız olmadıkça.

Her okuma işlemini Permission olarak ayarlayın ki ajan soruları duraklatmadan yanıtlayabilsin. Veriyi değiştiren herhangi bir işlemi etkinleştirirseniz, onu Sor' olarak ayarlayın.

Azure Veri Gezgini'dan Azure MCP'ye kadar olan bu süreçte, sihirbat küme grubu adımı ve bağlantı testi ile birlikte inceleme adımı içerir. Küme gruplarını yapılandırın, bağlantıyı test edin ve konnektörü kaydedin. Kusto araç seti, Azure MCP Kusto yolu tarafından yönetilir.

İpucu

Etkinleştirilmiş seti küçük tutun. Bir telemetri konnektörünün genellikle sadece sorgu işlemlerine ihtiyacı vardır. Daha az araç, temsilcinin doğru olanı daha güvenilir seçmesini ve 80 aletlik bütçe içinde kalmasını sağlar.

Adım 4: Bir soruyla doğrulama

  1. Ajanınızla sohbet açın.

  2. Telemetri gerektiren bir soru sorun. Örneğin:

    How many errors were logged in the last hour, grouped by service?

  3. Yanıtı izleyin. Bir araç kartı, ajanın konektörün sorgu aracını seçip sorguyu çalıştırdığını, ardından telemetrinize dayalı bir yanıtın geldiğini gösterir.

Genel bir açıklama yerine kendi kaynağından gerçek bir sayım gördüğünüzde, konnektör baştan uca çalışır.

Troubleshooting

Sorun Cause Düzelt
Sorgu "Yetkisiz" veya "Yasak" döneri Bağlantı kimliği okuma erişiminden yoksundur Hedef kaynağa kimlik okuma erişimi verin, sonra tekrar deneyin.
Sorgu "bulunmadı" döner. Yanlış çalışma alanı, küme, veritabanı veya tablo adı Hizmette tam adı doğrulayın. Adlar büyük/küçük harfe duyarlıdır.
Üçüncü parti konnektör bağlanamıyor URL, token veya başlık değeri yanlış Değerleri gözlemlenebilirlik yöneticinizle onaylayın ve konnektörü güncelleyin.
Cevap genel ve bir araç kartı görünmüyor Soru telemetri gerektirmiyordu Soruyu telemetri gerektirecek şekilde yeniden ifade edin, örneğin "X hizmetindeki son gün için başarısız istekleri say."
Konnektör kaydedildi ama telemetri geri dönmedi Boş veya filtrelenmiş sonuç Sorunuzdaki zaman aralığını genişletin ya da kaynağın yakın zamanda telemetri aldığını doğrulayın.

İlgili içerik

  • Last updated on