指标类型

浏览 0      扫码          2019-12-08 17:58:12     码农文档      译文原文 英文原文

公告:如果您也想加入翻译队伍,或者您有相关中文文档想要贡献给大家,请联系coderdocument@163.com ,谢谢!

Prometheus客户端库提供了四种核心指标类型。目前,它们只在客户端库(为了使API能够根据特定类型的使用而进行自定义)和wire协议中有所区别。Prometheus服务器还没有利用类型信息,并将所有数据压缩成无类型的时间序列。这种情况在未来可能会改变。

计数器(Counter)

计数器是一个累积指标,它表示一个单调递增的计数器,其值在重新启动时只能递增或重置为零。例如,你可以使用计数器来表示服务的请求、完成的任务或错误的数量。

不要使用计数器来暴露可能减少的值。例如,不要为当前正在运行的进程的数量使用计数器;而是要使用Guage。

计数器的客户端库使用文档:

量规(Guage)

guage是一个指标,它表示一个可以任意上下移动的数值。

guage通常用于测量温度或当前内存使用情况等测量值,但也用于“计数”,比如并发请求的数量。

guage的客户端库使用文档:

直方图(Histogram)

直方图对采样观察结果(通常是请求持续时间或响应大小之类的东西),并在可配置的桶中计数。它还提供所有观测值的和。

<basename>为基本指标名称的直方图在抓取期间暴露多个时间序列:

  • 观察桶的累积计数器,暴露为 <basename>_bucket{le="<upper inclusive bound>"}
  • 所有观察至的值的总和,暴露为 <basename>_sum
  • 已观察到的事件数量,暴露为 <basename>_count(与上述的<basename>_bucket{le="+Inf"} 相同)

使用e histogram_quantile()函数`)从直方图甚至是直方图的聚合中计算分位数。直方图也适用于计算Apdex评分。在桶上操作时,请记住直方图是累积的。请参阅直方图和摘要的最佳实践,以了解直方图用法的细节以及与摘要的区别。

直方图的客户端库使用文档:

摘要图(Summary)

与直方图类似,摘要图对观察结果进行采样(通常是请求持续时间和响应大小之类的内容)。虽然它还提供了观察值的总数和所有观察值的总和,但它计算了一个滑动时间窗口上的可配置分位数。

一个基本指标名称为<basename>的摘要在抓取期间暴露了多个时间序列:

  • 观察到的事件的流式 φ-quantiles (0 ≤ φ ≤ 1) ,暴露为 <basename>{quantile="<φ>"}
  • 所有观察至的值的总和,暴露为 <basename>_sum
  • 已观察到的事件数量,暴露为 <basename>_count

请参阅直方图和摘要的最佳实践,以了解φ-quantiles的细节以及与直方图的区别。

摘要的客户端库使用文档:

返回顶部