System.Diagnostics.Metrics Przestrzeń nazw

Metryki to pomiary liczbowe zgłaszane w czasie, najczęściej używane do monitorowania kondycji aplikacji i generowania alertów. Na przykład usługa internetowa może śledzić liczbę żądań, które otrzymuje co sekundę, liczbę milisekund potrzebnych do odpowiedzi oraz liczbę odpowiedzi wysłanych z powrotem do użytkownika. Te metryki można zgłaszać do systemu monitorowania w regularnych odstępach czasu. Przestrzeń nazw System.Diagnostics.Metrics może służyć do dodawania metryk do aplikacji. Interfejsy API działają na wszystkich platformach obsługiwanych przez platformę .NET i są zaprojektowane tak, aby dobrze integrować się z rosnącym ekosystemem narzędzi openTelemetry . Integrują się również z narzędziami zestawu SDK platformy .NET, takimi jak dotnet-counters. Interfejs API odbiornika jest dostępny dla deweloperów, którzy chcą tworzyć niestandardowe narzędzia lub karty do innych systemów.

Klasy

Counter<T>	Reprezentuje instrument, który obsługuje dodawanie wartości nie ujemnych. Można na przykład wywołać każde counter.Add(1) przetworzenie żądania w celu śledzenia całkowitej liczby żądań. Większość osób przeglądających metryki domyślnie wyświetla liczniki przy użyciu szybkości (żądań/s), ale może również wyświetlać łączną sumę.
Histogram<T>	Reprezentuje instrument metryk, który może służyć do raportowania dowolnych wartości, które mogą być statystycznie znaczące, na przykład czas trwania żądania. Wywołaj metodę CreateHistogram<T>(String, String, String) , aby utworzyć obiekt Histogram.
Instrument	Klasa podstawowa wszystkich klas instrumentów metryk
Instrument<T>	Klasa bazowa dla wszystkich nieoserwowalnych instrumentów.
Meter	Meter jest klasą odpowiedzialną za tworzenie i śledzenie instrumentów.
MeterFactoryExtensions	Metody rozszerzenia dla Meter i IMeterFactory.
MeterListener	MeterListener jest klasą służącą do nasłuchiwania nagrań pomiarów instrumentów metryk.
MeterOptions	Opcje tworzenia elementu Meter.
ObservableCounter<T>	Reprezentuje obserwowalny instrument, który raportuje monotonicznie rosnące wartości, gdy instrument jest obserwowany, na przykład czas procesora (w przypadku różnych procesów, wątków, trybu użytkownika lub trybu jądra). Wywołaj metodę CreateObservableCounter , aby utworzyć obiekt licznika, który można zaobserwować.
ObservableGauge<T>	Reprezentuje obserwowalny instrument, który zgłasza wartości inne niż addytywne, gdy instrument jest obserwowany, na przykład bieżącą temperaturę pomieszczenia. Wywołaj metodę CreateObservableGauge , aby utworzyć obiekt licznika, który można zaobserwować.
ObservableInstrument<T>	ObserwowalnyInstrument{T} jest klasą bazową, z której wszystkie metryki obserwowalne instrumenty będą dziedziczone.
ObservableUpDownCounter<T>	Obserwowalny instrument, który zgłasza wzrost lub zmniejszanie wartości, gdy instrument jest obserwowany. Ten instrument służy do monitorowania rozmiaru sterty procesu lub przybliżonej liczby elementów w buforze okrągłym bez blokady, na przykład. Aby utworzyć obiekt ObservableUpDownCounter, użyj CreateObservableUpDownCounter metod .
UpDownCounter<T>	Instrument obsługujący raportowanie dodatnich lub ujemnych wartości metryk. Funkcja UpDownCounter może być używana w scenariuszach, takich jak raportowanie zmian w aktywnych żądaniach lub rozmiarze kolejki.

Struktury

Measurement<T>

Przechowuje jedną zaobserwowaną wartość metryk i skojarzone z nią tagi. Ten typ jest używany przez metodę Obserwowane() instrumentu podczas raportowania bieżących pomiarów.

Interfejsy

IMeterFactory

Fabryka do tworzenia Meter wystąpień.

Delegaci

MeasurementCallback<T>

Pełnomocnik reprezentujący wywołania zwrotne miernika, które są używane podczas rejestrowania pomiarów.