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 na sekundę, ile milisekund zajęło 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 zostały zaprojektowane tak, aby dobrze integrować się z rosnącym ekosystemie narzędzi openTelemetry. Integrują się one również z narzędziami zestawu SDK platformy .NET, takimi jak liczniki dotnet-counter. 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 innych niż ujemne. Możesz na przykład wywołać counter.Add(1) za każdym razem, gdy żądanie jest przetwarzane w celu śledzenia całkowitej liczby żądań. Większość osób przeglądających metryki domyślnie wyświetla liczniki przy użyciu współczynnika (żądań/s), ale może również wyświetlać łączną sumę.
Gauge<T>	Miernik jest instrumentem używanym do rejestrowania wartości nie addytywnej za każdym razem, gdy wystąpią zmiany. Na przykład zarejestruj wartość poziomu szumu tła pomieszczenia, gdy wystąpią zmiany.
Histogram<T>	Reprezentuje instrument metryk, który może służyć do raportowania dowolnych wartości, które mogą być statystycznie istotne, na przykład czas trwania żądania. Wywołaj CreateHistogram<T>(String, String, String), aby utworzyć obiekt Histogramu.
Instrument	Klasa podstawowa wszystkich klas instrumentów metryk
Instrument<T>	Klasa bazowa dla wszystkich nieoserwowalnych instrumentów.
InstrumentAdvice<T>	Zawiera ustawienia konfiguracji zalecane do użycia przez użytkowników metryk podczas rejestrowania pomiarów dla danego Instrument<T>.
Meter	Meter jest klasą odpowiedzialną za tworzenie i śledzenie instrumentów.
MeterFactoryExtensions	Metody rozszerzeń dla Meter i IMeterFactory.
MeterListener	MeterListener jest klasą używaną do nasłuchiwania nagrań pomiarów instrumentów metryk.
MeterOptions	Opcje tworzenia Meter.
ObservableCounter<T>	Reprezentuje obserwowalny instrument, który zgłasza 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 CreateObservableCounter, aby utworzyć obserwowalny obiekt licznika.
ObservableGauge<T>	Reprezentuje obserwowalny instrument, który zgłasza wartości nie addytywne, gdy instrument jest obserwowany, na przykład bieżąca temperatura pomieszczenia. Wywołaj CreateObservableGauge, aby utworzyć obserwowalny obiekt licznika.
ObservableInstrument<T>	Obserwowalnyinstrument{T} to klasa bazowa, z której będą dziedziczone wszystkie obserwowane metryki.
ObservableUpDownCounter<T>	Instrument z możliwością obserwowania metryk, który zgłasza wzrost lub zmniejszanie wartości podczas obserwowania instrumentu. Ten instrument służy do monitorowania rozmiaru sterty procesu lub przybliżonej liczby elementów w buforze cyklicznym bez blokady, na przykład. Aby utworzyć obiekt ObservableUpDownCounter, użyj metod CreateObservableUpDownCounter.
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ą obserwowaną 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 wystąpień Meter.

Delegaci

MeasurementCallback<T>

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