System.Diagnostics.Metrics 命名空间
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
指标是一段时间内报告的数值度量,最常用于监视应用程序的运行状况并生成警报。 例如,Web 服务可能会跟踪每秒接收的请求数、响应所花费的毫秒数以及响应发送回用户的错误数。 这些指标可以定期频繁地向监视系统报告。 System.Diagnostics.Metrics 命名空间可用于向应用程序添加指标。 这些 API 适用于 .NET 支持的所有平台,旨在与 OpenTelemetry 不断增长的工具生态系统很好地集成。 它们还与 .NET SDK 工具集成,例如 dotnet-counters。 侦听器 API 适用于希望创建自定义工具或其他系统的适配器的开发人员。
类
Counter<T> |
表示支持添加非负值的检测。 例如,每次处理请求以跟踪请求总数时,都可以调用 |
Gauge<T> |
仪表是一种工具,用于在发生更改时记录非累加值。 例如,在发生更改时记录房间背景噪音级别值。 |
Histogram<T> |
表示可用于报告可能具有统计意义的任意值的指标检测,例如请求持续时间。 调用 CreateHistogram<T>(String, String, String) 以创建直方图对象。 |
Instrument |
所有指标检测类的基类 |
Instrument<T> |
所有不可观测仪器的基类。 |
InstrumentAdvice<T> |
包含在记录给定 Instrument<T>度量值时指标使用者建议使用的配置设置。 |
Meter |
Meter 是负责创建和跟踪 Instruments 的类。 |
MeterFactoryExtensions |
用于 Meter 和 IMeterFactory的扩展方法。 |
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 回调的委托。 |