quay.io/prometheus/pushgateway:v1.11.1

Pushgateway 是 Prometheus 生态中的一款轻量工具，主要用于解决短生命周期任务或批处理作业的指标采集问题。

在 Prometheus 的默认架构中，指标采集依赖 "拉取"（Pull）模式，即 Prometheus 主动从目标服务抓取指标。但对于运行时间短（如几分钟内完成的脚本）、动态启停（如临时数据处理任务）或无法被 Prometheus 直接访问（如处于防火墙后的内部作业）的场景，目标服务可能在 Prometheus 发起拉取前就已结束，导致指标丢失。Pushgateway 正是为这类场景设计的中间代理——它允许任务主动 "推送"（Push）指标到本地存储，再由 Prometheus 定期从 Pushgateway 拉取这些指标，从而确保短任务的运行状态、执行结果等关键数据不会遗漏。

核心功能

作为指标中转枢纽，Pushgateway 的核心能力是临时存储推送来的指标。它支持 Prometheus 标准的文本格式指标，任务只需通过 HTTP API（如 POST /metrics/job/<job_name>）即可将指标推送到指定路径，无需复杂配置。同时，它会保留指标数据直到被新数据覆盖或手动删除，确保 Prometheus 有足够时间完成拉取。

适用场景

Pushgateway 尤其适合三类场景：

1. 批处理任务：如定时运行的数据分析脚本、日志清洗作业，可在任务结束前推送执行时长、成功/失败状态、处理数据量等指标；
2. 短暂服务：如临时启动的测试环境实例、一次性数据迁移工具，可在运行期间推送资源占用（CPU/内存）、进度等指标；
3. 隔离环境任务：如内网服务器上的脚本、边缘节点的本地作业，因网络限制无法被 Prometheus 直接访问，可通过 Pushgateway 中转指标。

工作流程

使用时，流程通常为：

1. 任务（如脚本、小程序）在运行中或结束前，通过 HTTP 请求将指标推送到 Pushgateway（需指定任务名称、实例标签等标识信息）；
2. Pushgateway 接收并存储这些指标，形成可被 Prometheus 识别的指标端点；
3. Prometheus 按配置的时间间隔（如 15 秒一次）从 Pushgateway 拉取指标，完成数据采集。

使用注意事项

由于 Pushgateway 会持久化存储指标，需注意两点：

• 及时清理旧数据：若任务结束后未更新或删除指标，旧数据可能长期留存，导致 Prometheus 采集到无效信息（可通过 API 或工具定期清理）；
• 规范标签设计：推送指标时需合理设置标签（如 job、instance），避免不同任务的指标混淆，影响后续监控和告警准确性。

总体而言，Pushgateway 是 Prometheus 用户扩展指标采集能力的实用工具，无需修改 Prometheus 核心配置即可适配短任务场景，且部署简单（单二进制文件运行），适合各类需要补充 "推送式" 指标采集的场景。