System.Diagnostics.Metrics Пространство имен
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Метрики — это периодически публикуемые числовые измерения, наиболее часто используемые для мониторинга работоспособности приложения и создания оповещений. Например, веб-служба может отслеживать количество запросов, получаемых каждую секунду, количество миллисекунд, затраченных на ответ, и количество ответов, отправивших пользователю ошибку. Эти метрики можно отправлять в систему мониторинга через частые и регулярные интервалы. Пространство имен System.Diagnostics.Metrics можно использовать для добавления метрик в приложение. API работают на всех платформах, поддерживаемых .NET, и предназначены для хорошой интеграции с растущей экосистемой инструментов OpenTelemetry . Они также интегрируются с инструментами пакета SDK для .NET, такими как dotnet-counters. API прослушивателя доступен для разработчиков, которые хотят создавать пользовательские инструменты или адаптеры для других систем.
Классы
Counter<T> |
Представляет инструмент, поддерживающий добавление не отрицательных значений. Например, можно вызывать |
Histogram<T> |
Представляет инструмент метрик, который можно использовать для передачи произвольных значений, которые могут быть статистически значимыми, например длительности запроса. Вызовите CreateHistogram<T>(String, String, String) , чтобы создать объект гистограммы. |
Instrument |
Базовый класс всех классов инструментов метрик |
Instrument<T> |
Базовый класс для всех ненаблюдаемых инструментов. |
Meter |
Meter — это класс, отвечающий за создание и отслеживание instruments. |
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, используемых при записи измерений. |
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по