OpenTelemetry 指标 vs Prometheus 指标:数据模型的深度对比

OpenTelemetry 与 Prometheus 的指标数据模型在时间戳语义、累加方式、直方图结构上存在本质差异,直接影响速率计算与查询结果。本文深入对比两者数据模型,帮助你在迁移或混用时避开数值误读的坑。

最佳实践
OpenTelemetry 指标 vs Prometheus 指标:数据模型的深度对比封面

OpenTelemetry 指标与 Prometheus 指标的核心差异在于数据模型:OTel 的 Sum 与 Histogram 等类型可用 Delta 或 Cumulative 表达聚合区间,Prometheus 常规计数器则以带时间戳的累计样本表示——同一组测量值在两种模型下的查询语义不同,混用时若不理解差异,速率、占比计算都可能出错。

核心要点速览

  • OTel 的 Sum 与两类 Histogram 区分 Delta(间隔内增量)与 Cumulative(自起点以来的累计值),Gauge 不设聚合时间性。Prometheus 常规计数器使用累计值,较新版本的 OTLP 入口另有实验性 Delta 选项;
  • OTel 聚合数据点可提供起止时间戳,Delta 的平均速率需要用增量除以区间秒数;
  • OTel 有显式桶和指数桶直方图,Prometheus 有经典直方图和原生直方图,查询要与实际入库的形态匹配;
  • 命名依转换策略而定,例如 http.server.request.duration 在 Prometheus 的下划线和后缀转换策略下可变为 http_server_request_duration_seconds。

累加语义:Delta vs Cumulative

Prometheus 的 counter 记录自上次重置以来的累计值。对这类计数器,rate() 根据窗口内样本及其时间戳估算每秒增量,处理可检测的计数器重置,并向窗口边界外推。Prometheus 3.16 查询函数

OTel 支持两种 temporality:

  • Cumulative:记录从聚合起点到当前区间末尾的累计值;
  • Delta:记录这个聚合区间内的增量。例如 10 秒内新增 30 次请求,区间平均速率为 3 次/秒。

Delta 丢失一个区间点时,后续增量无法补回它。Cumulative 在同一个累计周期内可以用后续样本跨过缺测点估算总变化,但无法恢复缺测区间内的分布。Prometheus 3.16 的 OTLP 入口有两种互斥的实验性处理方式,分别是先转累计和原生接收 Delta。OTLP 接收与配置

时间戳模型的影响

Prometheus 样本关联一个时间戳,通常由抓取时刻确定,也可来自目标显式提供的时间戳或推送。普通样本的时间戳不描述一个完整聚合区间。OTLP 聚合数据点使用 start_time_unix_nano 与 time_unix_nano 表达区间(起点可未知)。转换和转发是否保留起点,要看具体协议与配置。OTel 指标数据模型

直方图:固定桶 vs 指数桶

Prometheus 经典直方图使用预设边界(如 0.1/0.5/1/5s),每条 _bucket{le=…} 记录不超过该边界的累计观测数。常规的跨实例聚合需要一致的边界,且应先对累计桶取 rate(),再按 le 等标签汇总。原生直方图把桶、计数和总和放在一个复合样本内,支持指数桶,也可使用自定义边界。Prometheus 原生直方图

OTel 的显式桶保存各个不重叠区间内的计数。写成 Prometheus 经典桶时,要按上界做前缀求和,若原数据是 Delta 还要单独处理时间上的累积。OTel 的指数直方图可在兼容的链路上映射为 Prometheus 原生直方图。分位数仍是基于桶内插值得出的估计,精度取决于桶分辨率、数据分布和转换过程。OTel 与 Prometheus 兼容性规范

命名与单位约定

  • OTel:http.server.request.duration,单位秒(UCUM 标准),属性点分;
  • Prometheus:常见转换结果为 http_server_request_duration_seconds,单位后缀由命名策略决定。

混用体系时建议在入库前明确命名规则。OTel 区分资源、埋点作用域和数据点属性,Prometheus 用指标名与标签集合标识序列。核对哪些字段被映射为标签,避免原本独立的写入源被转换成同一条序列。

两类指标汇入同一后端时,应先选一个 Counter 和一个 Histogram 做对照。接入观测云可分别使用 OTLP与 Prometheus 采集器;收到数据后核对名称、单位、标签和重启后的计数变化,再编写速率与分位数查询。两条接入路径可用,并不意味着 Delta、Cumulative 和直方图会自动得到相同结果。

常见问题(FAQ)

Q:Delta 和 Cumulative 查询结果会不一样吗? 在同一区间、没有丢点或重置时,可以换算并对照增量。实际结果还受采样边界、缺测、重置及查询算法影响。

Q:OTel 直方图能转成 Prom 直方图吗? 显式桶可转为经典桶,指数桶可在兼容的链路上映射为原生直方图。核对时间性、单位和分辨率,避免把转换前后的查询结果直接视为等价。

Q:迁移期两套指标并存会不会混乱? 用命名规范区分(如老指标保留 prom 风格,新指标用 OTel 风格),并在视图中统一别名,过渡期后逐步下线老指标。

Q:Gauge 在两种模型下有区别吗? 两者都能表示瞬时值,查询时应核对时间戳和标签。OTel API 有同步 Gauge,也有通过回调读取的 Observable Gauge,具体可用性取决于语言 SDK 版本。

系列阅读

[1]: 观测云文档《OpenTelemetry》https://docs.guance.com/integrations/opentelemetry/
[2]: 观测云文档《DataKit》https://docs.guance.com/datakit/
[3]: 观测云文档《监控》https://docs.guance.com/monitoring/

获取专属方案

联系我们

加入社区

微信扫码
加入官方交流群

立即体验

在线开通,按量计费,真正的云服务!

立即开始

选择观测云版本

代码托管平台