dmathai/prom-pushgateway-ttl

镜像概述

本镜像基于Prometheus Pushgateway扩展，增加了TTL（Time to Live）功能，能够让推送至Pushgateway的监控指标在指定生存时间后自动移除，有效解决传统Pushgateway中指标长期堆积的问题，兼容原生Pushgateway的接口规范。

核心功能

1. 支持为每个metric设置metric.timetolive属性，指定指标的生存时间
2. 自动检测并清理超过TTL的metrics，保持Pushgateway数据的有效性
3. 完全兼容Prometheus原生Pushgateway的指标推送和查询接口

使用场景

1. 临时任务或批处理作业的指标上报（如一次性数据处理任务的运行状态监控）
2. 需要定期清理过期指标的监控场景（如短期实验环境的指标收集）
3. 避免Pushgateway中堆积大量无效历史指标的场景

配置说明

• 推送指标时，需在指标标签中添加metric.timetolive参数（单位通常为秒，具体规则可参考https://github.com/dinumathai/pushgateway%EF%BC%89
• 镜像默认端口为9091，与原生Pushgateway一致

部署示例

Docker Run命令

bash
docker run -d -p 9091:9091 dmathai/prom-pushgateway-ttl

推送带TTL的指标示例

（假设使用curl推送）

bash
echo "my_metric{job='test', metric.timetolive='300'} 1" | curl --data-binary @- http://localhost:9091/metrics/job/test

上述命令推送的指标将在5分钟（300秒）后自动从Pushgateway中移除。