## 问题现象使用 increase 函数查询请求数、错误数、重启次数、发送字节数等 Counter 类型指标在指定时间范围内的总增量时，查询结果与预期存在差异。查询示例如下： ```Plain Text increase(http_requests_total[5m]) sum(increase(http_requests_total{service="api"}[5m])) by (cluster) ``` ## 原因分析托管 Prometheus 中，查询 Counter 类型指标在指定时间范围内的总增量时，结果不符合预期，大部分情况并非故障，而是函数选用不适合导致的结果。查询 Counter 类型指标在指定时间范围内的总增量时，可能用到以下 3 个函数：increase、increase_pure、increase_prometheus。针对每个查询 step，查询引擎只会结合该 step 对应的回看窗口进行计算，因此，首个 step 有时为 0 有时不为 0。例如，对 `increase(x[5m])` 而言，在 10:05 这个 step 上，系统主要分析 10:00 至 10:05 附近的样本。若窗口前存在可用样本，默认 `increase() `会优先使用该样本作为比较基准；若窗口前不存在样本，则不会机械地将窗口内第一个样本统一视为“本窗口新增”，也不会统一视为“历史旧值”，而是结合第一个样本与后续样本之间的变化关系进行判断。当缺少窗口前样本时，默认 `increase()` 会结合首个点与后续增量关系，判断该首值更像是当前窗口内新增，还是窗口开始前已经存在的存量值。 |**样本形态** |**默认判断方式** |**可能呈现的结果** | |---|---|---| |窗口前存在上一个样本 |直接以窗口前样本作为基准值。 |能够更清晰地判断增量是否发生在当前窗口内。 | |窗口前不存在样本，且首个点数值较小，后续仍有明显增长 |更接近“从 0 开始增长”的情形。 |首个点可能被计入当前窗口增量，因此结果可能不为 0。 | |窗口前不存在样本，且首个点数值较大，后续变化很小 |更接近“历史旧值重新上报”的情形。 |首个点可能不计入当前窗口新增，因此结果可能为 0。 | ## 选型建议三种 `increase` 函数的差异，核心看两点：缺少窗口前样本时如何假设第一个点、是否按 Prometheus 口径对外。因此，日常查询优先使用 `increase()`；明确要求首值按 0 起算时使用 `increase_pure()`；需要与 Prometheus 原生结果保持一致时使用 `increase_prometheus()`。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a3195fc49b5bd25307f4ad2a68ae8268.png) 更多详细说明如下： |**函数** |**窗口前无样本时的处理方式** |**是否按 Prometheus 外推** |**适用场景** |原因 | |---|---|---|---|---| |increase() |根据首个点与后续增量关系，判断首值应视为新增还是历史值。 |否 |托管 Prometheus 的日常查询与常规分析。 |默认口径会尽量利用窗口边界附近的样本，避免把明显是旧值的首个样本误算成新增。 | |increase_pure() |直接假定首个值自 0 开始累计。 |否 |业务上能够明确确认首值应从 0 起算的场景。 |没有窗口前样本时，直接假设 Counter 从 0 开始。 | |increase_prometheus() |按照 Prometheus 风格结合窗口内样本进行计算。 |是 |Prometheus 看板迁移、告警兼容性校验、口径差异排查。 |按 Prometheus 风格计算，包括窗口外推，结果可能出现小数。 | ## 解决方案当查询结果与预期不一致时，建议参考以下步骤进行排查，定位问题并选择最适合当前使用场景的函数。 1. 确认指标类型是否为 Counter。Gauge 类型的指标，不适合使用 increase 解释增量。 2. 检查原始样本分布，重点确认窗口前是否存在上一个样本，若不存在，再观察首个点与后续点之间的增量变化关系。 3. 同时查询 `increase()` 和 `increase_prometheus()`，判断差异是否来自 Prometheus 外推口径。 4. 保证 range window 不小于采集间隔的 2 倍，避免由于窗口内样本过少导致结果不稳定。 ```Bash # 托管 Prometheus 默认口径 increase(my_counter_total[5m]) # Prometheus 兼容口径 increase_prometheus(my_counter_total[5m]) # 首值明确按 0 起算的口径 increase_pure(my_counter_total[5m]) ```