İzleme

Makale
04/05/2024

UYGULANANLAR: Tüm API Management katmanları

İlke, trace test konsolu, Uygulama Analizler telemetrileri ve/veya kaynak günlüklerindeki istek izleme çıkışına özel bir izleme ekler.

İlke, izleme tetiklendiğinde test konsolundaki istek izleme çıkışına özel bir izleme ekler; başka bir ifadeyle istek Ocp-Apim-Trace üst bilgisi bulunur ve olarak ayarlanır true ve Ocp-Apim-Subscription-Key istek üst bilgisi bulunur ve izlemeye izin veren geçerli bir anahtar barındırır.
İlke, Application Analizler tümleştirmesi etkinleştirildiğinde ve severity ilkede belirtilen değer tanılama ayarında belirtilene eşit veya bundan verbosity büyük olduğunda Application Analizler'de bir İzleme telemetrisi oluşturur.
İlke, kaynak günlükleri etkinleştirildiğinde ve ilkede belirtilen önem düzeyi tanılama ayarında belirtilen ayrıntı düzeyinden yüksek veya daha yüksek olduğunda günlük girdisine bir özellik ekler.
İlke, Uygulama Analizler örneklemeden etkilenmez. İlkenin tüm çağrıları günlüğe kaydedilir.

Uyarı

Aboneliklerle yalnızca hata ayıklama amacıyla izlemeye izin verin. Yetkisiz kullanıcılar için izlemeye izin veren abonelik anahtarlarının paylaşılması anahtarlar, erişim belirteçleri, parolalar, iç ana bilgisayar adları ve IP adresleri gibi izleme günlüklerinde yer alan hassas bilgilerin açığa çıkmasına yol açabilir.
Test konsolunda API Management, abonelikte etkinleştirildikten 1 saat sonra izlemeyi otomatik olarak devre dışı bırakır.

Not

Şu anda API isteği izleme, Temel v2 ve Standart v2 katmanlarında desteklenmemektedir.

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

<trace source="arbitrary string literal" severity="verbose | information | error">
    <message>String literal or expressions</message>
    <metadata name="string literal or expressions" value="string literal or expressions"/>
</trace>

Özellikler

Öznitelik	Açıklama	Zorunlu	Varsayılan
kaynak	İzleme görüntüleyicisi için anlamlı olan ve iletinin kaynağını belirten dize değişmez değeri. İlke ifadelerine izin verilmez.	Yes	Yok
önem derecesi	İzlemenin önem düzeyini belirtir. İzin verilen değerler `verbose`, , `informationerror` (en düşükten en yükseğe) olur. İlke ifadelerine izin verilmez.	Hayır	`verbose`

Öğeler

Veri Akışı Adı	Açıklama	Gerekli
ileti	Günlüğe kaydedilecek dize veya ifade. İlke ifadelerine izin verilir.	Yes
meta veriler	Uygulama Analizler İzleme telemetrisine özel bir özellik ekler.	Hayır

meta veri öznitelikleri

Öznitelik	Açıklama	Zorunlu	Varsayılan
Adı	Özelliğin adı.	Yes	Yok
değer	Özelliğin değeri.	Yes	Yok

Kullanım

İlke bölümleri: gelen, giden, arka uç
İ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

Örnek

<trace source="PetStore API" severity="verbose">
    <message>@((string)context.Variables["clientConnectionID"])</message>
    <metadata name="Operation Name" value="New-Order"/>
</trace>

Günlüğe kaydetme

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