使用限制
更新时间：2026-06-12
概述
本文主要介绍 Prometheus 监控服务使用过程中的内置限制条件。
使用限制
Prometheus 监控服务内置限制条件如下：
| 类型 | 限制项 | 默认配额 | 受限处理方式 |
|---|---|---|---|
| 数据查询 | 最大查询时间范围 | 实例支持的存储时长 | 查询报错，返回 503 |
| 单次接口查询超时时间 | 10 分钟 | 暂不支持调整 | |
| 单次查询最多扫描时间线数量 | 4 万 | 暂不支持调整 | |
| 指标采集后可被正常查询的时间 | 30 秒 | 暂不支持调整 | |
| 查询结果中每条时序样本数 | 不超过 10,000 个 | 暂不支持调整 | |
| 查询涉及的原始样本 | 不超过每条时序 5,000,000 个 | 暂不支持调整 | |
| 单次查询扫描最大数据量 | 不超过 5000 万 | 暂不支持调整 | |
| 查询语句最大长度 | 16384 个字符 | 暂不支持调整 | |
| 数据采集和上报 | 单个指标 Labels 数量限制 | 100 个 | 不支持调整，超出可能会造成数据丢失 |
| 单个指标 Label name 最大长度 | 256 Bytes | 暂不支持调整 | |
| 单个指标 Label 最大长度 | Label Key 或者 Label Value 字符串长度不超过 256 个字符 | 暂不支持调整 | |
| 每个样本都必须有一个 metrics name | - | 暂不支持调整 | |
| Agent 最大副本数 | 2 | 支持通过控制台调整，详情参见 调整 Agent 副本数 重要说明：Agent 副本数量不足可能会导致 Agent 频繁地因内存溢出 (OOM) 而重启，进而造成数据采集延迟甚至丢失。我们强烈建议您 开启并配置 Agent 相关监控，并密切关注其副本的 CPU 和 Memory 资源使用率。一旦观察到资源使用率持续高位或出现 OOM 事件，请立即前往控制台 手动扩容 副本数量。 |
|
| 其他 | 每个区域最大的实例数量 | 5 个 | 支持，您可以 提交工单 提升配额 |
| 单个实例不变的 Series 最大限制 | 1 亿 | 资源充足时，将会为您合理地调整相关限制 | |
| 单个实例每天变化的 Series 最大限制 | 1000 万 | 资源充足时，将会为您合理地调整相关限制 | |
| 默认数据保存时长 | 默认保存 15 天 | 支持在控制台自行调整数据存储时长 | |
| 单实例告警规则最大数量 | 200 个 | - | |
| 单实例预聚合规则最大数量 | 200 个 | - | |
| Token 使用有效期 | 2025 年 5 月 1 日之前创建：有效期默认 2 年；2025 年 5 月 1 日之后创建：有效期默认 100 年（请及时替换） | - |
说明：
- 时间序列（时间线，Series）：由指标名称（Metric Name）和标签集合（Labels）唯一标识的数据序列。相同指标名和完全一致的标签组合，在存储中生成一条独立的时间线。
- 变化的时间序列（时间线，Series）：某个指标的时间线由于其中标签的 key 或者标签的 value 不断变化而写入的时间线。
- Token：用于客户端采集和上报数据、远程读写的安全认证。
注意：
- Token：2025 年 5 月 1 日之前生成的用于远程读写的 token 默认有效期为 2 年，请在过期之前提前更换新的 Token；2025 年 5 月 1 日之后生成的 token 默认有效期为 100 年。请注意 token 的安全保密，如需定期更换，可以到 Cprom 平台进行更换。
评价此篇文章