数据指标类型

Prometheus 客户端库提供了四种核心数据指标类型。这些仅在客户端库(针对特定类型的使用量身定制的API)和有线协议中有所区别。Prometheus 服务尚未使用数据类型,而是将所有数据平铺为没有类型的时间序列。将来可能会改变。

Counter 计数器类型

counter是一个累计类型的数据指标,它代表单调递增的计数器,其值只能在重新启动时增加或重置为 0。例如,您可以使用计数器来表示已响应的请求数,已完成或出错的任务数。

不要使用计数器来显示可以减小的值。例如,请不要使用计数器表示当前正在运行的进程数;使用 gauge 代替。

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

Gauge 数据轨迹类型

gauge 是可以任意上下波动数值的指标类型。

Gauge 通常用于测量值,例如温度或当前的内存使用量,还可用于可能上下波动的”计数”,例如请求并发数。

Gauge 的客户端库使用文档:

Histogram 直方图类型

Histogram 对观测值(通常是请求持续时间或响应大小之类的数据)进行采样,并将其计数在可配置的数值区间中。它也提供了所有数据的总和。

基本数据指标名称为<basename>的直方图类型数据指标,在数据采集期间会显示多个时间序列:

  • 数值区间的累计计数器,显示为<basename>_bucket{le="<数值区间的上边界>"}
  • 所有观测值的总和,显示为<basename>_sum
  • 统计到的事件计数,显示为<basename>_count(与上述<basename>_bucket{le="+Inf"}相同)

使用histogram_quantile()函数可以根据直方图及聚合直方图来计算分位数。直方图也适用于计算 Apdex 得分。在数值区间操作时,请注意直方图是累积的。更多直方图用法的详细信息及与 summary 的差异,请参见直方图和 summary

Histogram 的客户端库使用文档:

Summary 汇总类型

类似于 histogramsummary 会采样观察结果(通常是请求持续时间和响应大小之类的数据)。它不仅提供了观测值的总数和所有观测值的总和,还可以计算滑动时间窗口内的可配置分位数。

基本数据指标名称为<basename>的 summary 类型数据指标,在数据采集期间会显示多个时间序列:

  • 流观察到的事件的 φ-quantiles(0≤φ≤1),显示为<basename>{quantile="<φ>"}
  • 所有观测值的总和,显示为<basename>_sum
  • 观察到的事件计数,显示为<basename>_count

有关 φ-quantiles 的详细说明,summary 使用方法用法以及与的差异,请参见 histograms and summaries

Summary 的客户端库使用文档: