可观测性与稳定性 / 系统课时
一条 Prometheus 指标长什么样
一条 Prometheus 指标长什么样
看到 /metrics 页面里密密麻麻的文本时,先不要把它当日志读。一条 Prometheus 指标本质上是在描述某个时间序列上的一个样本:指标名称和 Label 决定“测的是谁”,数值和采样时间说明“这一刻测到了什么”。
学习目标
- 能从指标文本中识别指标名称、Label 和样本值
- 理解“时间序列”和“样本”不是同一个概念
- 知道时间戳通常由 Prometheus 抓取时确定,而不是必须由目标显式输出
从一行样本开始读
先看一条典型的指标文本:
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 就会把它视为另一条时间序列。例如下面两行虽然指标名称相同,却属于两条不同的序列:
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 的时间序列模型里,可以把单个样本理解为三部分:序列身份、时间和值。
时间序列:http_requests_total{method="GET",code="200",instance="web-01"}
时间: <TIME>
值: 1027实际时间值会随抓取时刻变化,所以这里使用 <TIME> 表示动态值。Prometheus 周期性抓取目标时,会把新的数值记录到同一条时间序列上,于是形成随时间变化的一串样本。
例如连续三次抓取可能得到:
<TIME> 1027
<TIME> 1041
<TIME> 1058这不是三条时间序列,而是同一条时间序列上的三个样本。
HELP 和 TYPE 行不是样本
真实 /metrics 输出里,经常还能看到 # HELP 和 # TYPE:
# 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 通常只输出指标与数值:
process_resident_memory_bytes 73400320Prometheus 抓取这条数据时,会使用抓取发生的时间作为样本时间。这样目标只负责暴露当前状态,采集时间由 Prometheus 统一管理。
如果某个暴露端显式提供了时间戳,文本格式会把它放在数值之后。除非数据源确实需要保留自己的原始采样时间,否则通常没有必要让普通 Exporter 自己生成时间戳。
阅读一条陌生指标时看什么
面对陌生指标,可以按固定顺序阅读:先看指标名称确认测量对象,再看所有 Label 确认这条序列描述的是哪个实例、接口或状态,最后看数值判断当前样本代表什么。
尤其要避免把 Label 当成普通备注。Label 是时间序列身份的一部分,这意味着添加、删除或改变 Label 值都会影响 Prometheus 实际存储的序列。理解这一点之后,后续分析 Label 基数、查询聚合和存储成本才有可靠基础。