Поделиться через


System.Diagnostics.Metrics Пространство имен

Метрики — это числовые измерения, сообщаемые с течением времени, чаще всего используются для мониторинга работоспособности приложения и создания оповещений. Например, веб-служба может отслеживать количество запросов, которые он получает каждую секунду, сколько миллисекунд потребовалось для ответа, и сколько ответов отправляет ошибку пользователю. Эти метрики можно сообщать в систему мониторинга с частыми регулярными интервалами. Пространство имен System.Diagnostics.Metrics можно использовать для добавления метрик в приложение. API работают на всех платформах, поддерживаемых .NET, и предназначены для интеграции хорошо с растущей экосистемой инструментов OpenTelemetry. Они также интегрируются с инструментами пакета SDK для .NET, такими как счетчики dotnet-counters. API прослушивателя доступен для разработчиков, которые хотят создавать пользовательские средства или адаптеры для других систем.

Классы

Counter<T>

Представляет инструмент, поддерживающий добавление не отрицательных значений. Например, можно вызывать counter.Add(1) каждый раз при обработке запроса для отслеживания общего количества запросов. Большинство средств просмотра метрик отображают счетчики с использованием скорости (запросов/с), но по умолчанию также могут отображать совокупную общую сумму.

Gauge<T>

Датчик — это инструмент, используемый для записи недитивных значений при каждом изменении. Например, запишите значение фонового шума комнаты при изменении.

Histogram<T>

Представляет инструмент метрик, который можно использовать для отправки произвольных значений, которые, скорее всего, будут статистически значимыми, например длительность запроса. Вызовите CreateHistogram<T>(String, String, String) для создания объекта гистограммы.

Instrument

Базовый класс всех классов инструментов метрик

Instrument<T>

Базовый класс для всех не наблюдаемых инструментов.

InstrumentAdvice<T>

Содержит параметры конфигурации, которые рекомендуется использовать потребителям метрик при записи измерений для заданного Instrument<T>.

Meter

Счетчик — это класс, ответственный за создание и отслеживание инструментов.

MeterFactoryExtensions

Методы расширения для Meter и IMeterFactory.

MeterListener

Класс MeterListener используется для прослушивания записей измерений инструментирования метрик.

MeterOptions

Параметры создания Meter.

ObservableCounter<T>

Представляет наблюдаемый метрики инструмент, который сообщает монотонно увеличивающиеся значения при наблюдаемом инструменте, например время ЦП (для различных процессов, потоков, пользовательского режима или режима ядра). Вызовите CreateObservableCounter для создания наблюдаемого объекта счетчика.

ObservableGauge<T>

Представляет наблюдаемый инструмент, который сообщает не аддитивные значения, когда инструмент наблюдается, например текущая температура комнаты. Вызовите CreateObservableGauge для создания наблюдаемого объекта счетчика.

ObservableInstrument<T>

ObservableInstrument{T} — это базовый класс, от которого наследуются все метрики наблюдаемых инструментов.

ObservableUpDownCounter<T>

Инструмент, отслеживаемый метриками, который сообщает о увеличении или уменьшении значений при наблюдаемом инструменте. Используйте этот инструмент для отслеживания размера кучи процесса или приблизительного количества элементов в буфере, свободном от блокировки, например. Чтобы создать объект ObservableUpDownCounter, используйте методы CreateObservableUpDownCounter.

UpDownCounter<T>

Инструмент, поддерживающий отчеты о положительных или отрицательных значениях метрик. UpDownCounter может использоваться в таких сценариях, как отчеты об изменении активных запросов или размера очереди.

Структуры

Measurement<T>

Хранит одно наблюдаемое значение метрик и связанные с ним теги. Этот тип используется методом Observ() наблюдаемого инструмента при составлении отчетов о текущих измерениях.

Интерфейсы

IMeterFactory

Фабрика для создания Meter экземпляров.

Делегаты

MeasurementCallback<T>

Делегат для представления обратных вызовов Meterlistener, которые используются при записи измерений.