数据模型
Prometheus 从根本上将所有数据存储为 时间序列:属于相同指标和相同标签集的时间戳值流。除了存储的时间序列外,Prometheus 还可能在查询结果中生成临时派生时间序列。
指标名称和标签
每个时间序列都由其指标名称和可选的键值对(称为标签)唯一标识。
指标名称
- 指标名称应该指定被测量的系统的通用特征(例如,
http_requests_total- 收到的 HTTP 请求总数)。 - 指标名称可以使用任何 UTF-8 字符。
- 为了获得最佳体验和兼容性,指标名称应匹配正则表达式
[a-zA-Z_:][a-zA-Z0-9_:]*(请参阅下方的警告)。超出此集合的指标名称将在 PromQL 中使用时需要引用(请参阅 UTF-8 指南)。
注意冒号(':')保留供用户定义的记录规则使用。导出器或直接仪表化不应使用它们。
指标标签
标签允许您捕获同一指标名称的不同实例。例如:所有使用 POST 方法发送到 /api/tracks 处理程序的 HTTP 请求。我们将此称为 Prometheus 的“维度数据模型”。查询语言允许基于这些维度进行过滤和聚合。任何标签值的更改,包括添加或删除标签,都会创建一个新的时间序列。
- 标签名称可以使用任何 UTF-8 字符。
- 以
__(两个下划线)开头的标签名称必须保留供 Prometheus 内部使用。 - 为了获得最佳体验和兼容性,标签名称应匹配正则表达式
[a-zA-Z_][a-zA-Z0-9_]*(请参阅下方的警告)。超出此正则表达式的标签名称将在 PromQL 中使用时需要引用(请参阅 UTF-8 指南)。 - 标签值可以包含任何 UTF-8 字符。
- 标签值为空的标签被视为与不存在的标签等效。
警告:Prometheus v3.0.0 较早的版本才添加了对指标和标签名称的 UTF-8 支持。更广泛的生态系统(下游兼容 PromQL 的项目和供应商、工具、第三方仪表化、收集器等)可能需要一段时间才能采用新的引用机制、放宽的验证等。为了获得最佳兼容性,建议坚持使用推荐的(“SHOULD”)字符集。
信息:另请参阅 指标和标签命名最佳实践。
样本
样本构成了实际的时间序列数据。每个样本包含
- 一个 float64 或 原生直方图值
- 一个毫秒精度的时间戳
表示法
给定一个指标名称和一组标签,时间序列通常使用以下表示法标识
<metric name>{<label name>="<label value>", ...}
例如,一个指标名称为 api_http_requests_total 且标签为 method="POST" 和 handler="/messages" 的时间序列可以这样写
api_http_requests_total{method="POST", handler="/messages"}
这与 OpenTSDB 使用的表示法相同。
包含推荐集合之外的 UTF-8 字符的名称必须引用,使用此表示法
{"<metric name>", <label name>="<label value>", ...}
由于指标名称在内部表示为带有特殊标签名称(__name__="<metric name>")的标签对,因此也可以使用以下表示法
{__name__="<metric name>", <label name>="<label value>", ...}