İzleme

UYGULANANLAR: Tüm API Management katmanları

İlke, trace test konsolunda, Application Insights telemetrilerinde ve/veya kaynak günlüklerinde istek izleme çıkışına özel bir izleme ekler.

• İlke, izleme tetiklendiğinde test konsolundaki istek izleme çıkışına özel bir izleme ekler.
• İlke, Application Insights 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 Insights'ta 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 Application Insights örneklemeden etkilenmez. İlkenin tüm çağrıları günlüğe kaydedilir.

Önemli

• API Management istek izlemesi, istekteki Ocp-Apim-Trace üst bilgisini kullanarak ve Ocp-Apim-Trace-Location yanıt üst bilgisinin değerini kullanarak kullanım dışı bırakılıyor.
• Güvenliği geliştirmek için artık API Management REST API'sini kullanarak zaman sınırlı bir belirteç elde edilerek ve belirteci ağ geçidine bir istekte geçirerek izleme tek bir API düzeyinde etkinleştirilebilir. Ayrıntılar için bkz . API izlemeyi etkinleştirme.
• İzleme verilerindeki hassas bilgileri açığa çıkaraabildiği için izlemeyi etkinleştirirken dikkatli olun. İzleme verilerini korumak için uygun güvenlik önlemlerine sahip olduğunuzdan emin olun.

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

İlgili ilkeler

• Günlüğe kaydetme

İlgili içerik

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

• Öğretici: API'nizi dönüştürme ve koruma
• İlke deyimlerinin ve ayarlarının tam listesi için ilke başvurusu
• İlke ifadeleri
• İlkeleri ayarlama veya düzenleme
• İlke yapılandırmalarını yeniden kullanma
• İlke kod parçacıkları deposu
• Azure'da Microsoft Copilot kullanarak ilke yazma