prometheus 中文文档
v2.17
v2.17
  • Prometheus 中文文档
  • introduction
    • 概述
    • 初识 Prometheus
    • 与替代品比较
    • 常见问题
    • 路线图
    • 相关资源
    • 相关术语
  • concepts
    • 数据模型
    • 数据指标类型
    • 作业和实例
  • prometheus
    • 快速开始
    • 安装
    • 配置
      • 配置
      • 定义记录规则
      • 告警规则
      • 模板示例
      • 模板参考
      • 规则的单元测试
    • 查询
      • Prometheus 查询
      • 运算符
      • 函数
      • 查询示例
      • HTTP API
    • 存储
    • 联合
    • 管理 API
    • Prometheus 2.0 迁移指南
    • API 稳定性保证
  • visualization
    • 表达式浏览器
    • Grafana 对 Prometheus 的支持
    • 控制台模板
  • operating
    • 安全模型
    • 集成
  • instrumenting
    • 客户端库
    • 编写客户端库
    • 推送数据指标
    • 数据导出及相关集成
    • 编写数据导出器
    • 公开的格式
  • alerting
    • 告警概述
    • Alertmanager
    • 配置
    • 发送告警
    • 通知模板参考
    • 通知模板示例
    • 管理 API
  • practices
    • 指标和标签命名
    • 控制台和仪表盘
    • 工具
    • Histogram and Summary
    • 告警
    • 记录规则
    • 什么时候使用 Pushgateway
    • 远程写调试
  • guides
    • 使用 cAdvisor 监控 docker 容器数据指标
    • 使用基于文件的服务发现来发现数据采集目标
    • 实现一个 Go 应用
    • 使用 Node Exporter 监控 Linux 主机指标
    • 使用基本身份验证保护 Prometheus API 和 UI 端点
    • 理解并使用 multi-target exporters 模式
    • 使用 TLS 加密 Prometheus API 和 UI 端点
    • 使用 Prometheus 查询日志
由 GitBook 提供支持
在本页
  • 指标名称和标签
  • 数据样本
  • 表示方式

这有帮助吗?

  1. concepts

数据模型

上一页相关术语下一页数据指标类型

最后更新于5年前

这有帮助吗?

Prometheus 基本上将所有数据存储为时间序列:属于同一数据指标和同一组标注维度的带有时间戳的数据流。除了存储的时间序列之外,Prometheus 可能会生成临时派生的时间序列作为查询的结果。

指标名称和标签

每个时间序列都由其名称和被称为标签的可选键值对唯一标识。

指标名称指定了所监测系统的一般功能(如http_requests_total - 收到 HTTP 请求总数)。它可能包含 ASCII 字符,数字下划线和冒号。它必须能被正则表达式[a-zA-Z_:][a-zA-Z0-9_:]*匹配。

注意:冒号是为用户自定义的规则保留的。exporter 或直接展示的组件都不应使用它们。

标签可以使 Prometheus 支持多维度数据模型:具有相同数据指标名称的标签的任何给定组合都可以标识该数据指标的特定维度实例(如,使用POST方法到/api/tracks处理程序的所有 HTTP 请求)。查询语言允许基于这些维度进行过滤和聚合。更改任何标签值,包括添加或删除,都会创建一个新的时间序列。

标签名称可以包含 ASCII 字符,数字和下划线。它必须能被正则表达式[a-zA-Z_:][a-zA-Z0-9_:]*匹配。以__开头的标签名称保留供内部使用。

标签值可以包含任何 Unicode 字符。

标签值为空的标签被认为等同于不存在的标签。

另请参阅

数据样本

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

  • 64 位浮点型数值

  • 毫秒精度的时间戳

表示方式

数据指标指定了数据指标名称和一组标签,通常使用如下表示方式来标识时间序列:

<metric name>{<label name>=<label value>, ...}

例如,包含数据指标名称api_http_requests_total和标签method="POST"",handler="/messages"的时间序列可以这样写:

api_http_requests_total{method="POST", handler="/messages"}

这与 使用的表示方式相同。

命名指标和标签的最佳实践
OpenTSDB