İ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
severityilkede belirtilen değer tanılama ayarında belirtilene eşit veya bundanverbositybü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 artık izleme için abonelikleri veya Ocp-Apim-Trace üst bilgisini desteklemez .
- API güvenliğini geliştirmek için artık API Management REST API'sini kullanarak zaman sınırlı bir belirteç elde ederek 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, çalışma alanı
Örnek
<trace source="PetStore API" severity="verbose">
<message>@((string)context.Variables["clientConnectionID"])</message>
<metadata name="Operation Name" value="New-Order"/>
</trace>
İlgili ilkeler
İlgili içerik
İlkelerle çalışma hakkında daha fazla bilgi için bkz: