System.Diagnostics.Metrics 命名空间

指标是在一段时间内报告的数值度量值,主要用于监视应用程序的运行状况并生成警报。 例如,Web 服务可能会跟踪每秒接收到的请求数、响应所花的毫秒数,以及向用户返回错误的响应数。 可以定期向监视系统报告这些指标。 System.Diagnostics.Metrics 命名空间可用于向应用程序添加指标。 这些 API 在 .NET 支持的所有平台上工作,旨在与 OpenTelemetry 不断增长的工具生态系统很好地集成。 它们还与 .NET SDK 工具(如 dotnet-counters)集成。 侦听器 API 适用于想要创建自定义工具或适配器到其他系统的开发人员。

Counter<T>

表示支持添加非负值的仪器。 例如,可以在每次处理请求时调用 counter.Add(1) 以跟踪请求总数。 默认情况下,大多数指标查看器使用速率 (请求数/秒) 显示计数器,但也可以显示累积总计。

Histogram<T>

表示可用于报告可能具有统计意义的任意值(例如请求持续时间)的指标工具。 调用 CreateHistogram<T>(String, String, String) 以创建直方图对象。

Instrument

所有指标检测类的基类

Instrument<T>

所有不可观测仪器的基类。

Meter

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

MeterFactoryExtensions

IMeterFactoryMeter扩展方法。

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 回调的委托。