- 文档首页
托管 Prometheus
Prometheus 基础知识
数据格式和指标类型
Prometheus 时序数据格式
数据格式和指标类型
Prometheus 时序数据格式
Prometheus 时序数据格式
本文为您介绍 Prometheus 时序数据的格式。
时间序列
时间序列(time-series),简称为 时序,是 Prometheus 数据的基本组成。Prometheus 会将所有采集到的样本数据以时间序列的方式保存在内存数据库中,并且定时保存到硬盘上。
一个时间序列由 指标名称(metrics name) 和一组 标签集(labelset) 命名,并按照时间戳进行排列。
- node_cpu_seconds_total - 节点 CPU 的使用时间
- node_filesystem_free_bytes - 文件系统挂载点上的可用空间
- kube_pod_status_ready - 集群中所有处于 Ready 状态的 Pod
- 每个时间序列可以有多个 label="value" 标签。例如:
- node_cpu_seconds_total{cluster="ccdxxx",host_ip="10.10.128.2"}
- kube_pod_status_ready{namespace="default"}
- 如果两个时间序列的名称或者标签的键值有任何一个不同,那么就被定义为不同的时间序列。例如下面的示例就为 3 个时间序列:
- kube_pod_status_ready{namespace="default"}
- kube_pod_status_ready{namespace="volcano-metrics"}
时间序列是按照时间戳和值的序列顺序存放的,被称为:向量(vector),如下图所示。
活跃时序
如果一个时间序列在指定时间(1 小时)内被抓取到新数据,那么它被称为活跃时间序列。
活跃时序数与工作区的写入能力有直接相关。如果您的最大活跃时序数超过了工作区的配额,会导致所采集到的数据被丢弃。因此,您需要根据实际情况,合理估算最大活跃时序数。
样本
在时间序列中,每一个点称为一个样本(sample),样本由以下三部分组成。
- 指标(metric):包含指标名(metric name)和描述当前样本特征的标签(labelsets)。
- 时间戳(timestamp):一个精确到毫秒的时间戳。
- 样本值(value): 一个 float64 的浮点型数据,表示当前样本的值。
样本示例如下所示。
<--------------- metric ---------------------><---timestamp--><-value->
http_request_total{status="200", method="GET"}@1434417560938 => 94355
指标
指标(metric)由 指标名 + 标签(label) 组成,一个指标可以包含多个 label。
<--metric name -->{<label name>=<label value>, ...}
prometheus_http_requests_total{status="200", method="GET"}
最近更新时间:2025.07.03 10:49:58