Prometheus increase()未检测到服务重启后的Counter更新（prometheus-client 0.16.0）

1. 为何increase()无法检测服务重启后的数值变化？ #

increase()的核心逻辑是基于Counter时间序列的连续样本差值计算增量，它需要至少两个有效样本点才能得出结果。你的场景里有两个关键原因导致失效：

• Counter未预先注册：服务重启后，目标标签组合的Counter是在第一次更新时才被创建的，Prometheus在重启前根本没有采集过这个时间序列的样本。重启后第一次采集到的是值为1的样本，没有前序基准样本（比如初始0值），increase()无法计算差值。
• 全新时间序列的判定：未预先注册的Counter对Prometheus来说是全新的时间序列，increase()不会将其视为“重启重置后的Counter”，自然无法识别首次更新带来的增长。

2. 如何确保increase()正确识别此类更新？ #

核心是让Prometheus能获取到Counter的完整样本序列，具体操作如下：

• 预先注册所有需要的标签组合Counter：在服务启动阶段，就完成所有可能用到的标签组合的Counter实例注册，而非等到更新时才创建。这样服务重启后，Counter初始值为0，Prometheus会采集到这个0值样本，后续更新到1时，increase()就能通过0和1的差值算出增量1。
  示例代码（Python）：

  from prometheus_client import Counter
  
  # 启动时预先注册带标签的Counter
  task_update_counter = Counter(
      'task_update_total', 
      'Total number of task updates', 
      ['region', 'task_tag']
  )
  # 后续直接调用已注册的Counter
  task_update_counter.labels(region='us-west', task_tag='data_sync').inc()
  

• 适配Prometheus采集间隔：确保采集间隔小于任务执行周期，避免错过Counter初始0值和更新后1值的样本点，保证increase()有足够的样本计算差值。

3. 有无可无视服务重启检测变化的替代方案？ #

如果需要跨服务重启统计累计变化，有两种可行方向：

• 持久化计数并通过Gauge暴露：将Counter的计数持久化到外部存储（比如本地文件、数据库），服务重启时从存储中读取上次的计数，用Gauge类型暴露这个持久化数值。之后可以用delta()函数计算时段内的增长，Gauge不受重启重置影响，只要持久化逻辑正确，就能跨重启统计。
• 基于事件的统计方式：每次任务执行时生成一个值为1的瞬时样本，使用count_over_time()函数统计指定时段内的事件数量。这种方式不依赖Counter的连续性，只要每个事件都能生成样本，就能准确统计，不受服务重启影响。

内容的提问来源于stack exchange，提问作者Uri Amiel