Share via


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 saniyede kaç istek aldığını, kaç milisaniyelik 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'nin büyüyen araç ekosistemiyle iyi tümleştirilerek tasarlanmıştır. Ayrıca dotnet-counters gibi .NET SDK araçlarıyla da tümleştirilir. Diğer sistemlere özel araçlar veya bağdaştırıcılar oluşturmak isteyen geliştiriciler için bir dinleyici API'si kullanılabilir.

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 çağrısında counter.Add(1) bulunabilirsiniz. Ö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.

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 çağrısı CreateHistogram<T>(String, String, String) yapın.

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.

Meter

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

MeterFactoryExtensions

ve IMeterFactoryiçin Meter uzantı yöntemleri.

MeterListener

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

MeterOptions

oluşturma Meterseçenekleri.

ObservableCounter<T>

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

ObservableGauge<T>

Alet gözlemlenirken , örneğin geçerli oda sıcaklığında, eklenebilir olmayan değerleri bildiren gözlemlenebilir bir aleti temsil eder. Gözlemlenebilir sayaç nesnesini oluşturmak için çağrısı CreateObservableGauge yapı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 döngüsel arabellekteki yaklaşık öğe sayısını izlemek için bu aracı kullanın. ObservableUpDownCounter nesnesi oluşturmak için yöntemlerini kullanın CreateObservableUpDownCounter .

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çümler raporlanırken Gözlemlenebilir aracının Observe() yöntemi tarafından kullanılır.

Arabirimler

IMeterFactory

Örnek oluşturmaya Meter yönelik bir fabrika.

Temsilciler

MeasurementCallback<T>

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