Bagikan melalui


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 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 openTelemetry ekosistem alat yang 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.

Gauge<T>

Pengukur adalah instrumen yang digunakan untuk merekam nilai non-aditif setiap kali perubahan terjadi. Misalnya, rekam nilai tingkat kebisingan latar belakang ruangan saat perubahan terjadi.

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.

InstrumentAdvice<T>

Berisi pengaturan konfigurasi yang disarankan untuk digunakan oleh konsumen metrik saat merekam pengukuran untuk Instrument<T>tertentu.

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 ketika 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 tempat semua metrik instrumen yang dapat diamati akan mewarisi.

ObservableUpDownCounter<T>

Instrumen yang dapat diamati metrik yang melaporkan peningkatan atau penurunan nilai ketika 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 metode CreateObservableUpDownCounter.

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 terkaitnya. Jenis ini digunakan oleh metode Observe() instrumen Yang Dapat Diamati saat melaporkan pengukuran saat ini.

Antarmuka

IMeterFactory

Pabrik untuk membuat instans Meter.

Delegasikan

MeasurementCallback<T>

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