可观测性与稳定性 / 系统课时

一条 Prometheus 指标长什么样

一条 Prometheus 指标长什么样

看到 /metrics 页面里密密麻麻的文本时,先不要把它当日志读。一条 Prometheus 指标本质上是在描述某个时间序列上的一个样本:指标名称和 Label 决定“测的是谁”,数值和采样时间说明“这一刻测到了什么”。

学习目标

  • 能从指标文本中识别指标名称、Label 和样本值
  • 理解“时间序列”和“样本”不是同一个概念
  • 知道时间戳通常由 Prometheus 抓取时确定,而不是必须由目标显式输出

从一行样本开始读

先看一条典型的指标文本:

text
http_requests_total{method="GET",code="200",instance="web-01"} 1027

这一行可以拆成两部分。左边的 http_requests_total{...} 标识时间序列,右边的 1027 是这次暴露出的样本值。

http_requests_total 是指标名称。它通常表达“测量什么”,这里表示 HTTP 请求累计数量。method="GET"、code="200" 和 instance="web-01" 是 Label,用于描述这个测量对象的具体维度。

只要指标名称或任意一个 Label 的名称、值发生变化,Prometheus 就会把它视为另一条时间序列。例如下面两行虽然指标名称相同,却属于两条不同的序列:

text
http_requests_total{method="GET",code="200",instance="web-01"} 1027
http_requests_total{method="POST",code="200",instance="web-01"} 318

这里真正标识序列的是“指标名称 + 完整 Label 集合”,而不是右侧的数值。数值从 1027 增加到 1028,仍然是同一条序列产生了新的样本。

一个样本由什么组成

在 Prometheus 的时间序列模型里,可以把单个样本理解为三部分:序列身份、时间和值。

text
时间序列:http_requests_total{method="GET",code="200",instance="web-01"}
时间:    <TIME>
值:      1027

实际时间值会随抓取时刻变化,所以这里使用 <TIME> 表示动态值。Prometheus 周期性抓取目标时,会把新的数值记录到同一条时间序列上,于是形成随时间变化的一串样本。

例如连续三次抓取可能得到:

text
<TIME>  1027
<TIME>  1041
<TIME>  1058

这不是三条时间序列,而是同一条时间序列上的三个样本。

HELP 和 TYPE 行不是样本

真实 /metrics 输出里,经常还能看到 # HELP 和 # TYPE:

text
# HELP http_requests_total Total number of HTTP requests processed.
# TYPE http_requests_total counter
http_requests_total{method="GET",code="200"} 1027

# HELP 提供指标说明,# TYPE 声明指标类型,例如 counter、gauge、histogram 或 summary。它们属于指标元数据,不会像最后一行那样形成时间序列样本。

因此阅读文本格式时,可以先跳过以 # 开头的元数据行,重点分析真正包含“指标名称、Label、数值”的样本行。

时间戳为什么经常看不见

Prometheus 文本格式允许样本显式携带时间戳,但常见的应用和 Exporter 通常只输出指标与数值:

text
process_resident_memory_bytes 73400320

Prometheus 抓取这条数据时,会使用抓取发生的时间作为样本时间。这样目标只负责暴露当前状态,采集时间由 Prometheus 统一管理。

如果某个暴露端显式提供了时间戳,文本格式会把它放在数值之后。除非数据源确实需要保留自己的原始采样时间,否则通常没有必要让普通 Exporter 自己生成时间戳。

阅读一条陌生指标时看什么

面对陌生指标,可以按固定顺序阅读:先看指标名称确认测量对象,再看所有 Label 确认这条序列描述的是哪个实例、接口或状态,最后看数值判断当前样本代表什么。

尤其要避免把 Label 当成普通备注。Label 是时间序列身份的一部分,这意味着添加、删除或改变 Label 值都会影响 Prometheus 实际存储的序列。理解这一点之后,后续分析 Label 基数、查询聚合和存储成本才有可靠基础。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

一条 Prometheus 指标长什么样

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通