Özel ölçümler yayma

UYGULANANLAR: Tüm API Management katmanları

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

Note

İ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. API Management'ta, aşağıdakiler dahil olmak üzere varsayılan boyutlar için bunlardan 5'i kullanılır:

  • Region
  • Hizmet Kimliği
  • Hizmet Adı
  • Hizmet Türü

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

  • İlke başına en fazla 5 ö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.

Prerequisites

İ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>

Attributes

Attribute Description Required Varsayılan değer
name Bir dize. Özel ölçümün adı. İlke ifadelerine izin verilmez. Yes N/A
namespace Bir dize. Özel ölçümün ad alanı. İlke ifadelerine izin verilmez. No API Management
value Çift olarak ifade edilen özel ölçümün değeri. İlke ifadelerine izin verilir. No 1

Elements

Element Description Required
dimension Özel ölçüme dahil edilen her boyut için bu öğelerden birini veya daha fazlasını ekleyin. Yes

Boyut öznitelikleri

Attribute Description Required Varsayılan değer
name Dize veya ilke ifadesi. Boyut adı. Yes N/A
value 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. No N/A

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

  • API Kimliği
  • İşlem Kimliği
  • Ürün kodu
  • Kullanıcı kimliği
  • Abonelik Kimliği
  • Location
  • Ağ Geçidi Kimliği
  • Arka uç kimliği (yalnızca giden ilke bölümünde kullanın)

Usage

Kullanım notları

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

Example

Aşağıdaki örnek, API kimliğiyle birlikte API isteklerinin sayısını varsayılan 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:

  • Last updated on