System.Diagnostics.Metrics Ruang nama

Metrik adalah pengukuran numerik yang dilaporkan dari waktu ke waktu, paling sering digunakan untuk memantau kesehatan aplikasi dan menghasilkan pemberitahuan. Misalnya, layanan web mungkin melacak berapa banyak permintaan yang diterimanya setiap detik, berapa banyak milidetik yang diperlukan untuk merespons, dan berapa banyak respons yang mengirim kesalahan kembali kepada pengguna. Metrik ini dapat dilaporkan ke sistem pemantauan secara berkala dan berkala. Namespace System.Diagnostics.Metrics dapat digunakan untuk menambahkan metrik ke aplikasi. API bekerja pada semua platform yang didukung oleh .NET dan dirancang untuk berintegrasi dengan baik dengan ekosistem alat OpenTelemetry yang terus berkembang. Mereka juga terintegrasi dengan alat .NET SDK, seperti penghitung dotnet. API pendengar tersedia untuk pengembang yang ingin membuat alat atau adaptor kustom ke sistem lain.

Kelas

Counter<T>

Mewakili instrumen yang mendukung penambahan nilai non-negatif. Misalnya, Anda dapat memanggil counter.Add(1) setiap kali permintaan diproses untuk melacak jumlah total permintaan. Sebagian besar penampil metrik menampilkan penghitung menggunakan tarif (permintaan/detik), secara default, tetapi juga dapat menampilkan total kumulatif.

Histogram<T>

Mewakili instrumen metrik yang dapat digunakan untuk melaporkan nilai arbitrer yang kemungkinan bermakna secara statistik, misalnya, durasi permintaan. Panggil CreateHistogram<T>(String, String, String) untuk membuat objek Histogram.

Instrument

Kelas dasar dari semua kelas instrumen metrik

Instrument<T>

Kelas dasar untuk semua instrumen yang tidak dapat diamati.

Meter

Meter adalah kelas yang bertanggung jawab untuk membuat dan melacak Instrumen.

MeterFactoryExtensions

Metode ekstensi untuk Meter dan IMeterFactory.

MeterListener

MeterListener adalah kelas yang digunakan untuk mendengarkan rekaman pengukuran instrumen metrik.

MeterOptions

Opsi untuk membuat Meter.

ObservableCounter<T>

Mewakili instrumen yang dapat diamati metrik yang melaporkan nilai yang meningkat secara monoton saat instrumen sedang diamati, misalnya, waktu CPU (untuk proses, utas, mode pengguna, atau mode kernel yang berbeda). Panggil CreateObservableCounter untuk membuat objek penghitung yang dapat diamati.

ObservableGauge<T>

Mewakili instrumen yang dapat diamati yang melaporkan nilai non-aditif ketika instrumen sedang diamati, misalnya, suhu ruangan saat ini. Panggil CreateObservableGauge untuk membuat objek penghitung yang dapat diamati.

ObservableInstrument<T>

ObservableInstrument{T} adalah kelas dasar dari mana semua metrik yang dapat diamati akan mewarisi instrumen.

ObservableUpDownCounter<T>

Instrumen yang dapat diamati metrik yang melaporkan peningkatan atau penurunan nilai saat instrumen sedang diamati. Gunakan instrumen ini untuk memantau ukuran tumpukan proses atau perkiraan jumlah item dalam buffer melingkar bebas kunci, misalnya. Untuk membuat objek ObservableUpDownCounter, gunakan CreateObservableUpDownCounter metode .

UpDownCounter<T>

Instrumen yang mendukung pelaporan nilai metrik positif atau negatif. UpDownCounter dapat digunakan dalam skenario seperti melaporkan perubahan permintaan aktif atau ukuran antrean.

Struct

Measurement<T>

Menyimpan satu nilai metrik yang diamati dan tag terkait. Jenis ini digunakan oleh metode Observe() instrumen yang dapat diamati saat melaporkan pengukuran saat ini.

Antarmuka

IMeterFactory

Pabrik untuk membuat Meter instans.

Delegasikan

MeasurementCallback<T>

Delegasi untuk mewakili panggilan balik Meterlistener yang digunakan saat merekam pengukuran.