Azure SRE Aracısında Bağlayıcılar

Ajansınız, Azure hizmetlerine entegre erişimle birlikte gelir. Azure İzleyici, Application Insights, Log Analytics ve Azure Kaynak Grafı sorgulayabilir. Bağlayıcılar dış sistemlere kadar uzanır: Kusto kümeleriniz, kaynak kodu depolarınız, işbirliği araçları ve özel API'ler.

Uyarı

Bağlayıcılar ve olay platformları:Bağlayıcılar , aracınıza veri ve eylemlere erişim verir; günlükleri sorgulama, bildirim gönderme, kod okuma. Olay platformları ayrı bir kavramdır: uyarıların nereden geldiğini ve aracınızın bunlara otomatik olarak nasıl yanıt verdiğini denetler.

Bu makale bağlayıcıları kapsar. Olay platformlarını görmek için Olay platformları'na bakın.

Ajanınızın bağlayıcılara ihtiyaç duymadan yapabilecekleri şeyler

Bağlayıcı yapılandırılmamış olsa bile, aracınız yönetilen kimliği ve Azure RBAC izinleri aracılığıyla yerleşik özelliklere sahiptir:

Yerleşik yetenek	Ne sağlar?
Application Insights	Uygulama telemetrisini, izlerini ve özel durumlarını sorgulama
Log Analytics	Log Analytics çalışma alanlarını sorgulama
Azure İzleyici ölçümleri	Ölçümleri listeleme ve sorgulama, eğilimleri ve anomalileri analiz etme
Azure Kaynak Grafı	Abonelikler arasında herhangi bir Azure kaynağını bulma ve sorgulama
ARM / Azure CLI	Herhangi bir Azure kaynak türünü okuma ve değiştirme
AKS tanılama	kubectl komutlarını çalıştırma, Kubernetes sorunlarını tanılama

Azure Kaynak Grafı ve ARM işlemleri herhangi bir Azure kaynak türüyle, App Services, Container Apps, VM'ler, ağ, depolama ve daha fazlasıyla çalışır. Günlükleriniz ve ölçümleriniz Azure İzleyici ve Application Insights'ta yaşıyorsa, aracınız bağlayıcı kurulumuna gerek olmadan sorunları hemen araştırmaya başlayabilir. Azure dışındaki sistemlere aracının ulaşması gerektiğinde bağlayıcılar değerli hale gelir.

Bağlayıcılar ne sağlar?

Bağlayıcılar, aracınıza verdikleri bilgilere göre dört kategoriye ayrılır:

Veri kaynakları

Veri depolarınızdan günlükleri, ölçümleri ve telemetri verilerini sorgulayın.

Bağlayıcı	Ne sağlar?
Log Analytics	Temsilcinizin günlük verileriniz hakkında kalıcı bir bağlamı olması ve bunları proaktif olarak sorgulayabilmesi için belirli çalışma alanlarını bağlayın
Application Insights	Uygulama telemetriniz hakkında ajanınızın sürekli bağlam sahibi olması için belirli App Insights kaynaklarını bağlayın.
Veritabanı sorgusu (Azure Veri Gezgini)	Kusto kümelerinizde önceden tanımlanmış KQL sorguları çalıştırma
Veritabanı dizin oluşturma (Azure Veri Gezgini)	Aracının dinamik olarak sorgu oluşturabilmesi için Kusto şemanızı otomatik olarak öğrenin

Tip

Yerleşik erişim ve Log Analytics ile Application Insights için bağlayıcılar

Aracınız zaten any Log Analytics çalışma alanını veya Application Insights kaynağını built-in araçları aracılığıyla sorgulayabilir; bağlayıcı gerekmez. Log Analytics veya Application Insights connector daha ileri bir adım atar: Aracınıza belirli çalışma alanlarına kalıcı bir farkındalık kazandırır, verilerini aracının ortam bağlamına dahil eder ve bağlı kaynaklarınız üzerinde daha kapsamlı MCP tabanlı tanılama olanakları sunar.

Kaynak kodu ve bilgi

Sistemleriniz hakkında kodlar, vikiler ve belgeler gibi bilgileri temsilcinize sağlayın.

Bağlayıcı	Ne sağlar?
GitHub MCP sunucusu	Depolara, sorunlara, çekme isteklerine ve wiki sayfalarına erişim
GitHub OAuth	OAuth kimlik doğrulama akışıyla GitHub erişimi
Azure DevOps OAuth	Azure DevOps’a OAuth kimlik doğrulaması aracılığıyla erişim
Dokümantasyon (Azure DevOps)	Azure DevOps wiki'lerinizi dizine oluşturma ve arama

Ajanınız bu bağlayıcılarla kodda hata desenleri araması yapabilir, wiki belgelerini okuyabilir, sorun giderme sırasında API belgelerine başvurabilir ve olayları ilgili çekme isteklerine (pull requests) bağlayabilir.

İşbirliği araçları

Temsilcinizin bulguları ekibinizin zaten kullandığı kanallar aracılığıyla iletmesine izin verin.

Bağlayıcı	Ne sağlar?
Bildirim gönder (Teams)	Teams kanallarına bulguları ve güncelleştirmeleri gönderme
E-posta gönder (Outlook)	E-posta araştırma özetleri ve raporları

Özel bağlayıcılar (MCP sunucuları)

MCP (Model Bağlam Protokolü), aracınızı gözlemlenebilirlik platformları, kaynak kodu depoları, bilet sistemleri ve özel API'ler dahil olmak üzere herhangi bir sisteme bağlamanıza olanak tanır. Aracınız bağlı sunuculardan araçları otomatik olarak bulur, 60 saniyelik sinyallerle bağlantı durumunu izler ve geçici hatalardan otomatik olarak kurtarır.

Her dağıtım modelini kapsayan iki aktarım türü vardır: Uzak bulut hizmetleri için Streamable-HTTP ve aracınızla birlikte çalışan yerel işlemler için stdio . GitHub, Datadog, Splunk, New Relic ve daha fazlası için önceden yapılandırılmış iş ortağı bağlayıcıları tek tıklamayla kurulum sağlar.

MCP mimarisi, aktarım türleri, iş ortağı bağlayıcıları, sistem durumu izleme ve araç yönetimiyle ilgili eksiksiz bir kılavuz için bkz. MCP bağlayıcıları ve araçları.

İlk MCP bağlayıcınızı ayarlamak için bkz. MCP bağlayıcısını ayarlama.

Bağlayıcılara göz atma ve bağlayıcıları yönetme

Bağlayıcılarınızı daraltılabilir kategori grupları halinde düzenlenmiş olarak görmek için Bağlayıcılar sayfasını (Oluşturucu > Bağlayıcıları) açın. Tüm gruplar varsayılan olarak genişletilir.

Category	Neler içerir?
Kod Deposu	GitHub, Azure DevOps, kaynak kodu ve belge bağlayıcıları
Bildirim	Teams ve Outlook mesajlaşma bağlayıcıları
Telemetri	Azure Veri Gezgini, Datadog, Dynatrace, Elasticsearch, New Relic, Splunk ve diğer izleme bağlayıcıları
Diğer	Diğer kategorilere uymayan genel MCP sunucuları ve bağlayıcıları

Her kategori üst bilgisi, bu gruptaki bağlayıcı sayısını gösterir. Bir kategoriyi daralttığınızda, bu gruptaki herhangi bir bağlayıcıda bağlantı sorunu varsa kırmızı bir rozet görüntülenir. Her bölümü genişletmeden sorunları bir bakışta görebilirsiniz. Görünümünüzü yönetmek için araç çubuğu denetimlerini kullanın:

• Tüm kategori gruplarını aynı anda açmak için tümünü genişlet / Tümünü daralt.
• Yalnızca belirli bir kategorideki bağlayıcıları göstermek için kategori filtresi.
• Arama özelliği ile bağlayıcıları isimlerine göre bulun (anahtar kelime araması için düz listeye geçer).

Yalnızca en az bir bağlayıcı içeren kategoriler görüntülenir. Bir bağlayıcıyı ada göre aradığınızda, sayfa daha hızlı filtreleme için düz liste görünümüne geçer.

Bağlayıcıları kimler yapılandırabilir?

Bağlayıcı yönetimi aracı üzerinde yazma izni gerektirir. Uygulamada:

Rol	Bağlayıcıları yapılandırabilir misiniz?
SRE Aracısı Yöneticisi	Evet
SRE Aracısı Standart Kullanıcısı	Hayır—sadece görüntüleme
SRE Ajan Okuyucusu	Hayır, yalnızca görüntüleme

Kurulum sırasında bazı bağlayıcılar, dış sistemde doğru izinlere sahip bir kullanıcıdan OAuth onayı gerektirir (örneğin, GitHub bağlayıcılar için GitHub kuruluş üyesi veya Outlook/Teams için Azure AD yöneticisi). Bu onay, SRE Aracısı rolleriyle değil dış hizmetteki izinlerle ilgili.

Bağlayıcının managed identity'sini (Azure Veri Gezgini gibi) kullanan bağlayıcılar için, dış sistemin yöneticisi kimliği listeye eklemeye izin vermelidir.

Bağlayıcıları yapılandırdığınızda, tüm aracı kullanıcıları bu bağlayıcılardan otomatik olarak yararlanıyor. Yalnızca aracıya sorular sorarlar ve arka planda kullanılabilir bağlayıcıları kullanır.

Bağlayıcılar ve özel aracılar

Özelleştirilmiş özel aracılara belirli MCP araçlarını atayabilirsiniz. Bir veritabanı sorun giderme özel aracısı Kusto araçlarını, dağıtım özel aracısı ise GitHub erişim alabilir. Bu yaklaşım her özel ajanı odaklı tutar ve çok fazla araçla bunalmayı önler.

Portal araç seçicisinde araçları tek tek atayın veya YAML'de joker karakter desenlerini (connection-id/*) kullanarak bir sunucudaki tüm araçları aynı anda ekleyin. Araç ataması ve joker karakter söz dizimi hakkında ayrıntılı bilgi için bkz. MCP bağlayıcıları ve araçları.

Portalda OluşturucuÖzel aracı> gidin, özel aracı oluşturun veya düzenleyin ve Gelişmiş ayarlar'ın altında Araçları seç'i seçin. Araç seçici araçları MCP bağlantısına göre gruplandırılmış olarak görüntüler. Özel etmeninizin ihtiyaç duyduğu şeyleri seçin.

YAML'de her aracı tam adına göre listeleyin:

mcp_tools:
  - azure-data-explorer_kusto_query
  - azure-data-explorer_kusto_table_list
  - azure-data-explorer_kusto_table_schema

MCP sunucusundan tüm araçları ekleme (joker karakter)

Şunlar için geçerlidir: sürüm 26.2.9.0 ve üzeri

Bir MCP sunucusu birçok aracı kullanıma sunarsa ve özel aracınızın tümüne ihtiyacı olduğunda, her aracı ayrı ayrı listelemek yerine joker karakter desenini kullanın:

mcp_tools:
  - azure-data-explorer/*

Desen, {connection-id}/* bu MCP bağlantısındaki tüm araçları ekler. Ajanınız, başlangıçta joker karakteri açar. Örneğin azure-data-explorer/*, azure-data-explorer adlı bir bağlantı altında kayıtlı tüm araçları çözümler (26.4.16.0 sürümünden itibaren Kusto bağlayıcısı ile Azure MCP için önceden doldurulmuş varsayılan değer). Bağlayıcınıza verdiğiniz ismi kullanın.

Joker karakterleri tek tek araç adlarıyla birleştirebilirsiniz:

mcp_tools:
  - azure-data-explorer/*  # All tools from the Kusto connection
  - grafana-mcp_dashboard  # One specific tool from Grafana

Uyarı

Genel karakter söz dizimi

Desenin, {connection-id}/* işareti ile eğik çizgi kullanılarak oluşturulması gerekir. Eğik çizgi olmadan azure-data-explorer* desenleri joker karakter olarak değil, tam olarak araç adları olarak kabul edilir.

Aşağıdaki tabloda tek tek araç seçimi ve joker karakter yaklaşımı karşılaştırır.

Yaklaşım	Ne zaman kullanılır?
Bireysel araçlar	Özel bir aracının hangi araçlara erişebileceğini tam olarak denetlemek istiyorsunuz
Joker karakter (connection-id/*)	MCP sunucusuna güveniyor ve daha sonra eklenenler de dahil olmak üzere tüm araçlarını istiyorsunuz
Mixed	Bir sunucuya ait tüm araçların yanı sıra başka bir sunucudan belirli araçlar istiyorsunuz

Joker karakter neden kullanılır? MCP sunucusu yeni araçlar eklediğinde joker karakter, özel aracınızı yeniden yapılandırmadan bunları otomatik olarak alır. Tek tek araç seçimi size tam denetim sağlar. Joker karakter size otomatik kapsam sağlar.

MCP araçları henüz hazır olmadığında

Aracınız başlatıldığında bir MCP sunucusu hazır değilse, aracınız bu sunucudan araçlara erişemez. Ajanınız bu durumu düzgün bir şekilde işler. Çözümlenmemiş joker karakterlere veya eksik araçlara sahip özel aracıları yok eder ve aracınız MCP bağlantısını kurduktan sonra bunları otomatik olarak yükler. El ile işlem yapmanız gerekmez.

Daha fazla bilgi için bkz. Özel Aracılar.

Sonraki adım

MCP bağlayıcısı ayarlama

İlgili içerik

Kaynak	Neden önemlidir?
Olay platformları	Ajanınız olayları otomatik olarak nasıl alır ve yanıtlar?
Kaynak kodu bağlama	GitHub veya Azure DevOps bağlayıcıları ayarlama
MCP bağlayıcısı ayarlama	Özel MCP sunucuları ekleme
Özel Aracılar	Odaklanmış bağlayıcı erişimiyle uzmanlaşmış ajanlar oluşturma
Permissions	Azure kaynak erişimini aracınız için yapılandırın