Trace

  • Artikel

BERLAKU UNTUK: Semua tingkatAN API Management

Kebijakan menambahkan trace jejak kustom ke dalam output pelacakan permintaan di konsol pengujian, telemetri Application Insights, dan/atau log sumber daya.

  • Kebijakan menambahkan jejak kustom ke output pelacakan permintaan di konsol pengujian saat pelacakan dipicu.
  • Kebijakan ini membuat telemetri Pelacakan di Application Insights, ketika integrasi Application Insights diaktifkan dan severity yang ditentukan dalam kebijakan sama dengan atau lebih besar dari verbosity yang ditentukan dalam pengaturan diagnostik.
  • Kebijakan menambahkan properti dalam entri log saat log sumber daya diaktifkan dan tingkat keparahan yang ditentukan dalam kebijakan berada pada atau lebih tinggi dari tingkat verbositas yang ditentukan dalam pengaturan diagnostik.
  • Kebijakan ini tidak terpengaruh oleh pengambilan sampel Application Insights. Semua pemanggilan kebijakan akan dicatat.

Penting

  • Pelacakan permintaan API Management tidak dapat lagi diaktifkan dengan mengatur header Ocp-Apim-Trace dalam permintaan dan menggunakan nilai header Ocp-Apim-Trace-Location dalam respons untuk mengambil jejak.
  • Untuk meningkatkan keamanan, pelacakan sekarang diaktifkan pada tingkat API individual dengan mendapatkan token terbatas waktu menggunakan API Management REST API, dan meneruskan token dalam permintaan ke gateway. Untuk detailnya, lihat nanti dalam tutorial ini.
  • Berhati-hatilah saat mengaktifkan pelacakan, karena dapat mengekspos informasi sensitif dalam data pelacakan. Pastikan Anda memiliki langkah-langkah keamanan yang sesuai untuk melindungi data pelacakan.

Catatan

Saat ini, pelacakan permintaan API tidak didukung di tingkat Dasar v2 dan Standard v2.

Catatan

Tetapkan elemen kebijakan dan elemen turunan dalam urutan yang disediakan dalam pernyataan kebijakan. Pelajari lebih lanjut cara mengatur atau mengedit kebijakan API Management.

Pernyataan kebijakan

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

Atribut

Atribut Deskripsi Wajib diisi Default
sumber String literal yang bermakna bagi penampil lacak dan menentukan sumber pesan. Ekspresi kebijakan tidak diizinkan. Ya T/A
keparahan Menentukan tingkat keparahan pelacakan. Nilai yang diperbolehkan adalah verbose, information, error (dari terendah hingga tertinggi). Ekspresi kebijakan tidak diizinkan. No verbose

Elemen

Nama Deskripsi Wajib diisi
pesan Sebuah string atau ungkapan yang akan dicatat. Ekspresi kebijakan diizinkan. Ya
metadata Menambahkan properti khusus ke telemetri Lacak Application Insights. No

atribut metadata

Atribut Deskripsi Wajib diisi Default
nama Nama properti. Ya T/A
value Nilai properti. Ya T/A

Penggunaan

Contoh

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

Konten terkait

Untuk informasi selengkapnya tentang bekerja dengan kebijakan, lihat: