quay.io/prometheus/pushgateway:master

quay.io/prometheus/pushgateway 技术说明

技术定位

quay.io/prometheus/pushgateway 是 Prometheus 生态中的核心组件，作为指标中转服务，主要用于接收短生命周期任务、批处理任务或临时性作业的指标数据，并暂存这些数据供 Prometheus 服务器定期拉取。由于 Prometheus 原生采用「拉模式」（Pull）收集指标，对于无法持续运行（如一次性脚本、CI/CD 任务）或网络不可直接访问的目标，Pushgateway 提供了「推模式」（Push）补充方案，实现指标的可靠传递。

典型使用场景

• 短生命周期任务：如定时数据清洗、临时计算任务，任务结束前主动推送指标至 Pushgateway。
• 批处理作业：离线数据分析、日志处理等非持续运行的任务，通过 Pushgateway 汇总运行状态（如成功率、耗时）。
• 边缘设备/隔离环境：网络受限或动态变化的设备（如 IoT 终端），无法被 Prometheus 直接拉取时，通过 Pushgateway 中转指标。
• CI/CD 流水线：记录单次构建、测试任务的指标（如测试覆盖率、构建时长），供监控系统分析。

版本标签说明

镜像标签遵循 Prometheus 项目版本规范，主要类型包括：

• 稳定版本：如 v1.11.3、v1.10.0 等，对应 Pushgateway 官方发布的稳定版，推荐生产环境使用。
• 最新版：latest 标签指向当前最新稳定版本，适合快速测试或无需固定版本的场景。
• 开发分支：master 标签对应项目主分支最新代码，包含未发布特性，仅用于开发测试。
• 轻量版本：master-distroless 基于 Distroless 基础镜像构建，仅包含运行时必要依赖，体积更小、安全性更高，适合资源受限环境。

与主流技术栈集成

Docker 环境

通过 Docker 快速启动 Pushgateway：

docker run -d -p 9091:9091 --name pushgateway quay.io/prometheus/pushgateway:latest

默认暴露 9091 端口，可通过 http://localhost:9091 访问 Web UI 或推送指标。

Kubernetes 环境

通常以 Deployment 形式部署，配合 Service 提供集群内访问：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: pushgateway
spec:
  replicas: 1
  selector:
    matchLabels:
      app: pushgateway
  template:
    metadata:
      labels:
        app: pushgateway
    spec:
      containers:
      - name: pushgateway
        image: quay.io/prometheus/pushgateway:v1.11.3
        ports:
        - containerPort: 9091

Prometheus 配置

需在 Prometheus 的 scrape_configs 中添加对 Pushgateway 的拉取配置：

scrape_configs:
  - job_name: 'pushgateway'
    static_configs:
      - targets: ['pushgateway:9091']  # Pushgateway 服务地址

注意事项

• Pushgateway 仅暂存指标，需配置持久化存储（如通过 -persistence.file 参数指定本地文件）避免重启后数据丢失。
• 指标推送需遵循 Prometheus 数据格式，通常通过 HTTP POST 请求发送（如 curl -X POST http://pushgateway:9091/metrics/job/myjob ...）。
• 生产环境建议使用固定版本标签（如 v1.11.3）而非 latest，确保部署稳定性。