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

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

Классы

Counter<T>	Представляет инструмент, поддерживающий добавление не отрицательных значений. Например, можно вызывать counter.Add(1) каждый раз при обработке запроса для отслеживания общего количества запросов. Большинство средств просмотра метрик по умолчанию отображают счетчики с использованием скорости (запросов/с), но также могут отображать совокупный итог.
Histogram<T>	Представляет инструмент метрик, который можно использовать для передачи произвольных значений, которые могут быть статистически значимыми, например продолжительности запроса. Вызовите CreateHistogram<T>(String, String, String) , чтобы создать объект гистограммы.
Instrument	Базовый класс всех классов инструментов метрик
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, которые используются при записи измерений.