数据模型

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”)字符集。

信息:另请参阅 指标和标签命名最佳实践

样本

样本构成了实际的时间序列数据。每个样本包含

表示法

给定一个指标名称和一组标签,时间序列通常使用以下表示法标识

<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>", ...}

本页内容