Azure API Management'ta gözlemlenebilirlik

UYGULANANLAR: Tüm API Management katmanları

Gözlemlenebilirlik, sistemin ürettiği verilerden iç durumunu anlama ve neler olduğu ve neden olduğuyla ilgili soruları yanıtlamak için bu verileri keşfedebilme özelliğidir.

Azure API Management, kuruluşların tüm API'lerin yönetimini merkezileştirmesine yardımcı olur. Tüm API trafiğinin tek bir giriş noktası olarak hizmet ettiğinden, API'leri gözlemlemek için ideal bir yerdir.

Genel bakış

Azure API Management, yönetilen ağ geçidini veya şirket içinde barındırılan ağ geçidini kendi kendine dağıtılan veya Azure Arc uzantısını kullanarak kullanmayı seçmenizi sağlar.

Aşağıdaki tabloda API'leri çalıştırmak için API Management tarafından desteklenen tüm gözlemlenebilirlik özellikleri ve bunların desteklediği dağıtım modelleri özetlenmektedir. API Yayımcıları ve API Management örneğini çalıştırma veya yönetme izinleri olan diğerleri bu özellikleri kullanabilir.

Not

Geliştirici portalını kullanan API tüketicileri için yerleşik bir API raporu sağlanır. Yalnızca önceki 90 gün boyunca kendi api kullanımı hakkında bilgi sağlar. Şu anda yerleşik API raporu v2 hizmet katmanları için geliştirici portalında kullanılamamaktadır.

Araç Şunlar için kullanışlıdır: Veri gecikmesi4 Tutma Örnekleme Veri türü Desteklenen Dağıtım Modelleri
İstek izleme (API Denetçisi) Test etme ve hata ayıklama Anında Son 100 izleme İstek üzerine etkinleştirildi İstek izleme kayıtları Yönetilen, Kendi Kendine Barındırılan, Azure Arc, Çalışma Alanı
Yerleşik Analiz Raporlama ve izleme Dakika Yaşam süresi %100 Raporlar ve günlükler Yönetilen
Azure İzleyici Ölçümleri Raporlama ve izleme Dakika 90 gün (uzatmak için yükseltme) %100 Ölçümler Yönetilen, Kendi kendine barındırılan2, Azure Arc
Azure İzleyici Günlükleri Raporlama, izleme ve hata ayıklama Dakika 31 gün/5 GB (uzatmak için yükseltin) %100 (ayarlanabilir) Günlükler Yönetilen1, Kendi kendine barındırılan3, Azure Arc3
Azure Uygulaması Insights Raporlama, izleme ve hata ayıklama Saniye 90 gün/5 GB (uzatmak için yükseltin) Özel Günlükler, ölçümler Yönetilen1, Öz yönetimli1, Azure Arc1, Çalışma Alanı1
Azure Event Hubs'da günlüğe kaydetme Özel senaryolar Saniye Kullanıcı tarafından yönetilir Özel Özel Yönetilen1, Kendi kendine barındırılan1, Azure Arc1
OpenTelemetry İzleme Dakika Kullanıcı tarafından yönetilir %100 Ölçümler Kendi kendine barındırılan2

1 Azure API Management'taki özelliğin yapılandırmasına bağlı olarak isteğe bağlı olarak.
2 Ağ geçidinin yapılandırmasına bağlı olarak isteğe bağlı olarak.
3Kendinden barındırılan ağ geçidi şu anda tanılama günlüklerini Azure İzleyici'a göndermiyor. Ancak, günlükleri, kendiliğinden barındırılan ağ geçidinin dağıtıldığı konumda yapılandırmak ve kalıcı hale getirmek mümkündür. Daha fazla bilgi için bkz. Şirket içinde barındırılan ağ geçidi için yerel ölçümleri ve günlükleri yapılandırma.
4 İstek izleme dışında API Management'taki tüm günlükler zaman uyumsuz olarak gerçekleşir.

En iyi uygulamalar

Aşağıdaki uygulamalar API gözlemlenebilirliğinizi geliştirebilir:

  • Ayrıntılı izleme: Yanıt sürelerine ve hata oranlarına ilişkin ayrıntılı içgörüler için yöntem başına ölçümleri etkinleştirin.
  • Kuyruk gecikmesi izleme: Ortalama gecikme süresi yanıltıcı olabileceği için kuyruk gecikme süresi (örneğin, 90. , 95. veya 99. yüzdebirlik) için yöntem başına uyarıları yapılandırın. Bu özelliği uygulamak için Kusto Sorgu Dili'ni (KQL) kullanarak günlükleri bir Log Analytics çalışma alanına iletin.
  • Proaktif uyarılar: Hata oranları ve düşük başarı oranları için yöntem başına uyarılar oluşturun, doğruluğu sağlamak için sayımlar yerine hızları kullanın.
  • Dağıtılmış izleme: Performans sorunlarını belirlemek ve sorunları gidermek için izlemeyi etkinleştirin.
  • Kaynak etiketleme: Doğru maliyet izleme ve ayırma için API'lere etiket uygulayın.

İlgili içerik

  • Last updated on