haufelexware/pushgateway-pruner Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

pushgateway-pruner Docker镜像文档

概述

pushgateway-pruner是一个轻量级工具，专门用于清理Prometheus Pushgateway中的过期或不再需要的指标数据。它可以帮助维护Pushgateway实例，防止因长期累积的指标数据导致的性能问题和存储占用过大问题。

核心功能和特性

• 基于时间的自动清理机制，可配置保留时间
• 支持按标签筛选需要清理的指标
• 可配置的清理频率
• 轻量级设计，资源占用低
• 支持Prometheus Pushgateway API v1
• 详细的日志输出，便于问题排查

使用场景和适用范围

• Prometheus监控环境中使用Pushgateway的场景
• 需要定期清理临时或短期监控指标的环境
• 希望自动化管理Pushgateway数据的监控系统
• 需要控制Pushgateway存储占用的生产环境

使用方法和配置说明

基本使用

使用docker run命令启动容器：

bash
docker run -d \
  --name pushgateway-pruner \
  -e PUSHGATEWAY_URL=[***] \
  -e RETENTION_DURATION=24h \
  haufelexware/pushgateway-pruner

Docker Compose配置

yaml
version: '3'
services:
  pushgateway-pruner:
    image: haufelexware/pushgateway-pruner
    environment:
      - PUSHGATEWAY_URL=[***]
      - RETENTION_DURATION=24h
      - CLEANUP_INTERVAL=1h
      - LOG_LEVEL=info
    restart: always

环境变量配置

高级使用示例

按特定标签清理指标：

bash
docker run -d \
  --name pushgateway-pruner \
  -e PUSHGATEWAY_URL=[***] \
  -e RETENTION_DURATION=12h \
  -e CLEANUP_INTERVAL=30m \
  -e FILTER_LABEL=job \
  -e FILTER_VALUE=transient-jobs \
  haufelexware/pushgateway-pruner

干运行模式（仅显示将要删除的内容，不实际删除）：

bash
docker run -d \
  --name pushgateway-pruner \
  -e PUSHGATEWAY_URL=[***] \
  -e RETENTION_DURATION=24h \
  -e DRY_RUN=true \
  haufelexware/pushgateway-pruner

注意事项

• 确保pushgateway-pruner能够网络访问到Pushgateway实例
• 合理设置RETENTION_DURATION，避免误删仍需使用的指标数据
• 建议先使用DRY_RUN模式测试清理规则，确认无误后再实际执行
• 在生产环境中建议监控pushgateway-pruner的运行状态和日志