Mengeluarkan metrik kustom

Artikel
04/04/2024

BERLAKU UNTUK: Semua tingkatAN API Management

emit-metric Kebijakan mengirimkan metrik kustom dalam format yang ditentukan ke Application Insights.

Catatan

Metrik kustom adalah fitur pratinjau dari Azure Monitor dan tunduk pada batasan.
Untuk informasi selengkapnya tentang data API Management yang ditambahkan ke Application Insights, lihat Cara mengintegrasikan Azure API Management menggunakan Azure Application Insights.

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

<emit-metric name="name of custom metric" value="value of custom metric" namespace="metric namespace"> 
    <dimension name="dimension name" value="dimension value" /> 
</emit-metric>

Atribut

Atribut	Deskripsi	Wajib diisi	Nilai default
nama	String . Nama metrik kustom. Ekspresi kebijakan tidak diizinkan.	Ya	T/A
namespace	String . Namespace metrik kustom. Ekspresi kebijakan tidak diizinkan.	No	API Management
value	Nilai metrik kustom yang dinyatakan sebagai ganda. Ekspresi kebijakan diizinkan.	No	1

Elemen

Elemen	Deskripsi	Wajib diisi
dimensi	Tambahkan satu atau beberapa elemen ini untuk setiap dimensi yang disertakan dalam metrik kustom.	Ya

atribut dimensi

Atribut	Deskripsi	Wajib diisi	Nilai default
nama	String atau ekspresi kebijakan. Nama dimensi.	Ya	T/A
value	String atau ekspresi kebijakan. Nilai dimensi. Hanya dapat dihilangkan jika `name` cocok dengan salah satu dimensi default. Jika demikian, nilai disediakan berdasarkan nama dimensi.	No	T/A

Nama dimensi default yang dapat digunakan tanpa nilai

ID API
ID Operasi
ID Produk
Id Pengguna
ID Langganan
ID Lokasi
ID Gateway

Penggunaan

Bagian kebijakan: masuk, keluar, backend, saat terjadi kesalahan
Cakupan kebijakan: global, ruang kerja, produk, API, operasi
Gateway: klasik, v2, konsumsi, dihost sendiri

Catatan penggunaan

Anda dapat mengonfigurasi paling banyak 10 dimensi kustom untuk kebijakan ini.
Memanggil emit-metric kebijakan dihitung terhadap batas penggunaan untuk metrik kustom per wilayah dalam langganan. Pelajari lebih lanjut

Contoh

Contoh berikut mengirimkan metrik kustom untuk menghitung jumlah permintaan API bersama dengan ID pengguna, IP klien, dan ID API sebagai dimensi kustom.

<policies>
  <inbound>
    <emit-metric name="Request" value="1" namespace="my-metrics"> 
        <dimension name="User ID" /> 
        <dimension name="Client IP" value="@(context.Request.IpAddress)" /> 
        <dimension name="API ID" /> 
    </emit-metric> 
  </inbound>
  <outbound>
  </outbound>
</policies>

Pembuatan Log

Untuk informasi selengkapnya tentang bekerja dengan kebijakan, lihat:

Tutorial: Mengubah dan melindungi API Anda
Referensi Kebijakan untuk daftar lengkap pernyataan kebijakan dan pengaturannya
Ekspresi kebijakan
Mengatur atau mengedit kebijakan
Menggunakan kembali konfigurasi kebijakan
Repositori cuplikan kebijakan
Kebijakan penulis menggunakan Microsoft Copilot untuk Azure