System.Diagnostics.Metrics 命名空间

指标是一段时间内报告的数值度量,最常用于监视应用程序的运行状况并生成警报。 例如,Web 服务可能会跟踪每秒接收的请求数、响应所花费的毫秒数以及响应发送回用户的错误数。 这些指标可以定期频繁地向监视系统报告。 System.Diagnostics.Metrics 命名空间可用于向应用程序添加指标。 这些 API 适用于 .NET 支持的所有平台,旨在与 OpenTelemetry 不断增长的工具生态系统很好地集成。 它们还与 .NET SDK 工具集成,例如 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

Meter 是负责创建和跟踪 Instruments 的类。

MeterFactoryExtensions

用于 MeterIMeterFactory的扩展方法。

MeterListener

MeterListener 是用于侦听指标检测测量记录的类。

MeterOptions

用于创建 Meter的选项。

ObservableCounter<T>

表示可观察指标的检测,该检测在观察检测时报告单调递增值,例如 CPU 时间(对于不同的进程、线程、用户模式或内核模式)。 调用 CreateObservableCounter 以创建可观察计数器对象。

ObservableGauge<T>

表示一个可观测仪器,该仪器在观察仪器时报告非累加值,例如,当前室内温度。 调用 CreateObservableGauge 以创建可观察计数器对象。

ObservableInstrument<T>

ObservableInstrument{T} 是所有指标可观测仪器将继承的基类。

ObservableUpDownCounter<T>

一种可观察指标检测,用于报告在观察检测时增加或减少值。 例如,使用此检测来监视无锁循环缓冲区中的进程堆大小或近似项数。 若要创建 ObservableUpDownCounter 对象,请使用 CreateObservableUpDownCounter 方法。

UpDownCounter<T>

支持报告正指标值或负指标值的检测。 UpDownCounter 可用于报告活动请求或队列大小的更改等方案。

结构

Measurement<T>

存储一个观察到的指标值及其关联的标记。 报告当前度量值时,可观测仪器的 Observ() 方法使用此类型。

接口

IMeterFactory

用于创建 Meter 实例的工厂。

委托

MeasurementCallback<T>

表示记录度量值时使用的 Meterlistener 回调的委托。