Pushgateway简介
Pushgateway是Prometheus监控系统中的一个重要组件,它采用被动push的方式获取数据,由应用主动将数据推送到pushgateway,然后Prometheus再从Pushgateway抓取数据。使用Pushgateway的主要原因是:
- Prometheus和target由于某些原因网络不能互通,需要经由Pushgateway代理
- 某些作业生命周期较短,没有足够的时间等待Prometheus抓取数据。所以可以先把数据推送到Pushgateway,再让Prometheus抓取
但是PushGateway也存在一些弊端:
- 通过单个 Pushgateway 监控多个实例时, Pushgateway 将会成为单点故障和潜在瓶颈
- Pushgateway 可以持久化推送给它的所有监控数据。
因此,即使监控目标以下线,prometheus 还会拉取到旧的监控数据,需要手动清理 pushgateway 不要的数据。
部署Pushgateway
下载安装包
wget https://github.com/prometheus/pushgateway/releases/download/v1.5.1/pushgateway-1.5.1.linux-amd64.tar.gz
tar xvf pushgateway-1.5.1.linux-amd64.tar.gz
pushgateway-1.5.1.linux-amd64/pushgateway /usr/bin/
pushgateway -h #查看帮助
准备service文件
root@prometheus-server-01:~# cat /lib/systemd/system/pushgateway.service
[Unit]
Description=Prometheus Pushgateway
After=network.target
[Service]
Type=simple
User=root
Group=root
ExecStart=pushgateway --web.listen-address=:9091
Restart=on-failure
[Install]
WantedBy=multi-user.target
启动服务
systemctl daemon-reload
systemctl start pushgateway
systemctl status pushgateway
systemctl enable pushgateway
访问pushgateway界面
配置Prometheus抓取数据
在prometheus配置中添加job,抓取pushgateway数据,内容如下:
- job_name: pushgateway
honor_labels: true
static_configs:
- targets: ["192.168.122.21:9091"]
配置修改完成后重启Prometheus。然后在Prometheus界面查看target状态
测试
要推送数据到Pushgateway中,可以其提供的API接口来添加,默认URL地址为http://<ip>:9091/metrics/job/<job-name>/<label-name>/<label-value>
其中job-name是必填项,是job标签的值,后边可以跟任意数量的标签&标签值对,一般会添加一个instance/<instance-name>标签来区分指标数据来源
测试向Pushgateway推送单条数据
执行如下命令进行单条数据推送
#my_metric表示指标名称,2022表示指标值
echo "my_metric 2022"| curl --data-binary @- http://192.168.122.21:9091/metrics/job/test-job/instance/192.168.122.22
#再执行一次推送,将值改为2023
echo "my_metric 2023"| curl --data-binary @- http://192.168.122.21:9091/metrics/job/test-job/instance/192.168.122.22
在Pushgateway界面查看数据,如下图,可以看到只显示了最新值。
在Prometheus中查询my_metric,验证是否获取到数据
测试向Pushgateway推送多条数据
cat <<EOF | curl --data-binary @- http://192.168.122.21:9091/metrics/job/test-job/instance/192.168.122.22
#TYPE node_memory_total gauge
node_memory_total 10240000000
#TYPE node_memory_usage gauge
node_memory_usuge 1024000000
EOF
在Pushgateway界面查看数据
在Prometheus中查询,验证是否获取到数据
测试删除数据
curl -X DELETE http://192.168.122.21:9091/metrics/job/test-job/instance/192.168.122.22
在Pushgateway界面验证