数据模型

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 兼容的项目和供应商、工具、第三方仪表化、收集器等）可能需要一些时间来采用新的引用机制、放宽验证等。为了获得最佳兼容性，建议遵循推荐的（“应当”）字符集。

样本构成了实际的时间序列数据。每个样本由以下部分组成：

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

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

本页内容