System.Diagnostics.Metrics Ad Alanı

Ölçümler, zaman içinde bildirilen sayısal ölçümlerdir ve çoğunlukla bir uygulamanın durumunu izlemek ve uyarılar oluşturmak için kullanılır. Örneğin, bir web hizmeti her saniye kaç istek aldığını, kaç milisaniye yanıt aldığını ve yanıtlardan kaçının kullanıcıya hata gönderdiğini izleyebilir. Bu ölçümler bir izleme sistemine sık ve düzenli aralıklarla bildirilebilir. System.Diagnostics.Metrics ad alanı, bir uygulamaya ölçüm eklemek için kullanılabilir. API'ler .NET tarafından desteklenen tüm platformlarda çalışır ve OpenTelemetry'in büyüyen araç ekosistemiyle tümleştirilerek tasarlanmıştır. Ayrıcadotnet-counters gibi .NET SDK araçlarıyla tümleştirilir. Diğer sistemlere özel araçlar veya bağdaştırıcılar oluşturmak isteyen geliştiriciler için dinleyici API'sini kullanabilirsiniz.

Sınıflar

Counter<T>

Negatif olmayan değerler eklemeyi destekleyen bir aracı temsil eder. Örneğin, toplam istek sayısını izlemek için her istek işlendiğinde counter.Add(1) çağırabilirsiniz. Ölçüm görüntüleyicilerinin çoğu sayaçları varsayılan olarak bir hız (istek/sn) kullanarak görüntüler, ancak birikmeli toplamı da görüntüleyebilir.

Gauge<T>

Ölçer, her değişiklik olduğunda eklemesiz değerleri kaydetmek için kullanılan bir araçtır. Örneğin, değişiklikler gerçekleştiğinde oda arka planı kirlilik düzeyi değerini kaydedin.

Histogram<T>

İstatistiksel olarak anlamlı olma olasılığı yüksek rastgele değerleri (örneğin, istek süresi) raporlamak için kullanılabilecek bir ölçüm aracını temsil eder. Histogram nesnesi oluşturmak için CreateHistogram<T>(String, String, String) çağır.

Instrument

Tüm ölçüm araç sınıflarının temel sınıfı

Instrument<T>

Gözlemlenemeyen tüm araçlar için temel sınıf.

InstrumentAdvice<T>

Belirli bir Instrument<T>için ölçümleri kaydederken ölçüm tüketicileri tarafından kullanılması önerilen yapılandırma ayarlarını içerir.

Meter

Ölçüm, Instruments'ı oluşturmak ve izlemekle sorumlu olan sınıftır.

MeterFactoryExtensions

Meter ve IMeterFactoryiçin uzantı yöntemleri.

MeterListener

MeterListener, ölçüm aracı ölçümleri kaydını dinlemek için kullanılan sınıftır.

MeterOptions

Meteroluşturma seçenekleri.

ObservableCounter<T>

Ölçüm gözlemlenirken monoton olarak artan değerleri bildiren ölçüm gözlemlenebilir bir aracı temsil eder( örneğin, CPU süresi (farklı işlemler, iş parçacıkları, kullanıcı modu veya çekirdek modu için). gözlemlenebilir sayaç nesnesini oluşturmak için CreateObservableCounter çağırın.

ObservableGauge<T>

Ölçüm aleti gözlemlenirken, örneğin geçerli oda sıcaklığında ekleme olmayan değerleri bildiren gözlemlenebilir bir aleti temsil eder. gözlemlenebilir sayaç nesnesini oluşturmak için CreateObservableGauge çağırın.

ObservableInstrument<T>

ObservableInstrument{T}, gözlemlenebilir tüm ölçümlerin devralınacağı temel sınıftır.

ObservableUpDownCounter<T>

Ölçüm gözlemlenirken değerlerin arttığını veya azaldığını bildiren ölçüm gözlemlenebilir bir araç. Örneğin, işlem yığını boyutunu veya kilitsiz dairesel arabellekteki yaklaşık öğe sayısını izlemek için bu aracı kullanın. ObservableUpDownCounter nesnesi oluşturmak için CreateObservableUpDownCounter yöntemlerini kullanın.

UpDownCounter<T>

Pozitif veya negatif ölçüm değerlerini raporlamayı destekleyen bir araç. UpDownCounter, etkin isteklerdeki veya kuyruk boyutundaki değişikliği raporlama gibi senaryolarda kullanılabilir.

Yapılar

Measurement<T>

Gözlemlenen bir ölçüm değerini ve ilişkili etiketlerini depolar. Bu tür, geçerli ölçümleri bildirirken Gözlemlenebilir bir aracının Observe() yöntemi tarafından kullanılır.

Arabirimler

IMeterFactory

Meter örnekleri oluşturmaya yönelik bir fabrika.

Temsilciler

MeasurementCallback<T>

Ölçümler kaydedilirken kullanılan Meterlistener geri çağırmalarını temsil eden bir temsilci.