Prometheus Pushgateway 完整指南：如何快速安装与配置临时任务监控

汤涌双

915人浏览 · 2026-01-06 16:05:54

汤涌双 · 2026-01-06 16:05:54 发布

Prometheus Pushgateway 完整指南：如何快速安装与配置临时任务监控

【免费下载链接】pushgateway Push acceptor for ephemeral and batch jobs. 项目地址: https://gitcode.com/gh_mirrors/pu/pushgateway

Prometheus Pushgateway 是一个专为临时任务和批处理作业设计的监控组件，它允许这些短生命周期的任务将指标推送到 Pushgateway，再由 Prometheus 服务器进行抓取。作为 Prometheus 生态系统中不可或缺的一部分，Pushgateway 解决了短生命周期任务无法被常规抓取的痛点。在前100个字内，我们再次强调：Prometheus Pushgateway 是处理临时任务监控的终极解决方案。

🚀 Pushgateway 的核心价值与适用场景

Pushgateway 主要服务于那些存在时间不够长、无法被 Prometheus 常规抓取的作业。比如：

批处理任务：定时运行的数据处理作业
临时服务：一次性运行的脚本或程序
Cron 任务：定时执行的系统任务
CI/CD 流水线：构建和部署过程中的监控指标

⚠️ 重要提醒：Pushgateway 不是万能药

需要注意的是，Pushgateway 并不能将 Prometheus 变成基于推送的监控系统。它只是一个指标缓存，而不是聚合器或分布式计数器。对于机器级别的指标，通常使用 Node Exporter 的 textfile 收集器更为合适。

📦 快速安装 Pushgateway 的3种方法

方法一：二进制文件安装（推荐）

从发布页面下载对应平台的二进制版本：

# 下载并解压
wget https://github.com/prometheus/pushgateway/releases/download/v1.4.3/pushgateway-1.4.3.linux-amd64.tar.gz
tar -xzf pushgateway-1.4.3.linux-amd64.tar.gz
cd pushgateway-1.4.3.linux-amd64
./pushgateway

方法二：Docker 容器部署

使用官方 Docker 镜像快速部署：

docker pull prom/pushgateway
docker run -d -p 9091:9091 prom/pushgateway

方法三：从源码编译

如果你需要自定义功能，可以从源码编译：

git clone https://gitcode.com/gh_mirrors/pu/pushgateway
cd pushgateway
make build

⚙️ Pushgateway 配置详解

基本配置参数

启动 Pushgateway 时可以使用以下关键参数：

--web.listen-address：监听地址，如 "0.0.0.0:9091"
--persistence.file：指标持久化文件路径
--web.enable-admin-api：启用管理 API
--push.disable-consistency-check：禁用一致性检查

持久化配置示例

为了确保指标在 Pushgateway 重启后不丢失：

./pushgateway --web.listen-address=":9091" --persistence.file="/tmp/pushgateway.metrics"

🔄 Prometheus 集成配置

要让 Prometheus 能够抓取 Pushgateway 中的指标，需要在 prometheus.yml 中进行配置：

scrape_configs:
  - job_name: 'pushgateway'
    honor_labels: true  # 必须设置为 true
    static_configs:
      - targets: ['localhost:9091']

重要提示：必须设置 honor_labels: true，这样才能保留推送到 Pushgateway 的指标中的 job 和 instance 标签。

📊 指标推送实战教程

简单指标推送

推送一个简单的指标到 Pushgateway：

echo "some_metric 3.14" | curl --data-binary @- http://localhost:9091/metrics/job/some_job

复杂指标推送

推送包含类型信息和帮助文本的复杂指标：

cat <<EOF | curl --data-binary @- http://localhost:9091/metrics/job/some_job/instance/some_instance
# TYPE some_metric counter
some_metric{label="val1"} 42
# TYPE another_metric gauge
# HELP another_metric Just an example.
another_metric 2398.283
EOF

指标删除操作

删除特定分组的指标：

# 删除特定实例的指标
curl -X DELETE http://localhost:9091/metrics/job/some_job/instance/some_instance

# 删除整个作业的指标
curl -X DELETE http://localhost:9091/metrics/job/some_job

🛠️ API 接口详解

Pushgateway 提供了完整的 REST-like API：

主要 API 端点

推送指标：PUT /metrics/job/<JOB_NAME>
追加指标：POST /metrics/job/<JOB_NAME>
删除指标：DELETE /metrics/job/<JOB_NAME>

管理 API

启用管理 API 后可以使用的功能：

清空所有指标：PUT /api/v1/admin/wipe

🔒 安全配置建议

TLS 和基础认证

通过配置文件启用安全功能：

./pushgateway --web.config.file="web-config.yml"

📈 监控与告警最佳实践

关键监控指标

push_time_seconds：最后一次成功推送的时间
push_failure_time_seconds：最后一次推送失败的时间

告警规则配置

groups:
- name: pushgateway
  rules:
  - alert: PushgatewayPushFailed
    expr: push_time_seconds > 300
    for: 5m
    labels:
      severity: warning
    annotations:
      summary: "Pushgateway 推送失败"