Özel ölçümler yayma

Makale
04/04/2024

UYGULANANLAR: Tüm API Management katmanları

İlke, emit-metric uygulama Analizler belirtilen biçimde özel ölçümler gönderir.

Not

Özel ölçümler, Azure İzleyici'nin bir önizleme özelliğidir ve sınırlamalara tabidir.
Uygulama Analizler eklenen API Management verileri hakkında daha fazla bilgi için bkz. Azure API Management'ı Azure Uygulaması Analizler ile tümleştirme.

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.

İ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
Yerleşim kodu
Ağ Geçidi Kimliği

Kullanım

İlke bölümleri: gelen, giden, arka uç, hatada
İlke kapsamları: genel, çalışma alanı, ürün, API, işlem
Ağ geçitleri: klasik, v2, tüketim, şirket içinde barındırılan

Kullanım notları

Bu ilke için en fazla 10 özel boyut yapılandırabilirsiniz.
İlkeyi emit-metric çağırmak, bir abonelikteki bölge başına özel ölçümler için kullanım sınırlarına göre sayılır. Daha fazla bilgi edinin

Örnek

Aşağıdaki örnek kullanıcı kimliği, istemci IP'si ve API kimliği ile birlikte API isteklerinin sayısını özel boyutlar olarak saymak için özel bir ölçüm gönderir.

<policies>
  <inbound>
    <emit-metric name="Request" value="1" namespace="my-metrics"> 
        <dimension name="User ID" /> 
        <dimension name="Client IP" value="@(context.Request.IpAddress)" /> 
        <dimension name="API ID" /> 
    </emit-metric> 
  </inbound>
  <outbound>
  </outbound>
</policies>

Günlüğe kaydetme

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