Aracılığıyla paylaş

Özel ölçümler yayma

  • Makale

UYGULANANLAR: Tüm API Management katmanları

İlke, emit-metric özel ölçümleri belirtilen biçimde Application Insights'a gönderir.

Not

İlkenin öğelerini ve alt öğelerini ilke bildiriminde sağlanan sırayla ayarlayın. API Management ilkelerini ayarlama veya düzenleme hakkında daha fazla bilgi edinin.

Özel ölçümler için sınırlar

Azure İzleyici, API Management'tan ölçüm yayma yeteneğinizi etkileyebilecek özel ölçümler için kullanım sınırları uygular. Örneğin, Azure İzleyici şu anda ölçüm başına 10 boyut anahtarı sınırı ve abonelikteki bölge başına toplam etkin zaman serisi sayısı (12 saatlik bir süre içinde) 50.000 sınırı ayarlar.

Bu sınırlar, veya azure-openai-emit-token-metricgibi emit-metric bir API Management ilkesinde özel ölçümleri yapılandırmaya yönelik aşağıdaki etkilere sahiptir:

  • İlke başına en fazla 10 özel boyut yapılandırabilirsiniz.

  • İlke tarafından 12 saatlik bir süre içinde oluşturulan etkin zaman serisi sayısı, dönem içinde yapılandırılan her boyutun benzersiz değer sayısının çarpımdır. Örneğin, ilkede üç özel boyut yapılandırıldıysa ve her boyut dönem içinde 10 olası değere sahipse, ilke 1.000 (10 x 10 x 10) etkin zaman serisine katkıda bulunur.

  • İlkeyi bir abonelikte aynı bölgede bulunan birden çok API Management örneğinde yapılandırdığınızda, tüm örnekler bölgesel etkin zaman serisi sınırına katkıda bulunabilir.

Azure İzleyici'de özel ölçümler için tasarım sınırlamaları ve dikkat edilmesi gerekenler hakkında daha fazla bilgi edinin.

Önkoşullar

İlke bildirimi

<emit-metric name="name of custom metric" value="value of custom metric" namespace="metric namespace"> 
    <dimension name="dimension name" value="dimension value" /> 
</emit-metric>

Özellikler

Öznitelik Açıklama Gerekli Default value
Adı Bir dize. Özel ölçümün adı. İlke ifadelerine izin verilmez. Yes Yok
ad alanı Bir dize. Özel ölçümün ad alanı. İlke ifadelerine izin verilmez. Hayır API Management
değer Çift olarak ifade edilen özel ölçümün değeri. İlke ifadelerine izin verilir. Hayır 1

Öğeler

Öğe Açıklama Gerekli
boyut Özel ölçüme dahil edilen her boyut için bu öğelerden birini veya daha fazlasını ekleyin. Yes

boyut öznitelikleri

Öznitelik Açıklama Gerekli Default value
Adı Dize veya ilke ifadesi. Boyut adı. Yes Yok
değer Dize veya ilke ifadesi. Boyut değeri. Yalnızca varsayılan boyutlardan biriyle eşleşiyorsa name atlanabilir. Bu durumda, boyut adına göre değer sağlanır. Hayır YOK

Değer olmadan kullanılabilecek varsayılan boyut adları

  • API Kimliği
  • İşlem Kimliği
  • Ürün Kimliği
  • Kullanıcı kimliği
  • Subscription ID
  • Konum
  • Ağ Geçidi Kimliği

Kullanım

Kullanım notları

  • Bu ilke için en fazla 10 özel boyut yapılandırabilirsiniz.

Örnek

Aşağıdaki örnek, API kimliğiyle birlikte API isteklerinin sayısını özel boyut olarak saymak için özel bir ölçüm gönderir.

<policies>
  <inbound>
    <emit-metric name="Request" value="1" namespace="my-metrics"> 
        <dimension name="API ID" /> 
    </emit-metric> 
  </inbound>
  <outbound>
  </outbound>
</policies>

İlgili içerik

İlkelerle çalışma hakkında daha fazla bilgi için bkz: