zerok/celery-prometheus-exporter

镜像概述

celery-prometheus-exporter是一款独立服务工具，用于从Celery任务队列中导出Prometheus兼容的监控指标，支持与Prometheus集成实现Celery系统的可视化监控，具有复用性强、无框架依赖的特点。

核心功能

• 任务状态统计：通过celery_tasks指标按状态（如RECEIVED、STARTED、SUCCESS等）分组展示任务数量；
• 任务名称维度统计：通过celery_tasks_by_name指标按任务名称和状态分组统计任务数；
• Worker状态监控：通过celery_workers指标展示当前活跃的worker数量；
• 任务延迟分析：通过celery_task_latency直方图记录任务从接收至启动的延迟时间；
• 任务运行时间统计：通过celery_tasks_runtime_seconds直方图跟踪任务完成所需时间。

使用场景

• 监控Celery任务队列的整体运行状态；
• 分析任务延迟情况，优化任务调度策略；
• 评估worker负载，调整资源分配；
• 结合Prometheus和Grafana构建Celery系统的监控仪表盘。

配置说明

关键参数

• Broker URL：通过--broker选项或BROKER_URL环境变量指定Celery broker地址（默认：redis://redis:6379/0）；
• 监听地址：通过--addr选项或DEFAULT_ADDR环境变量设置HTTP服务监听地址（默认：0.0.0.0:8888）；
• 事件启用：使用--enable-events参数定期启用Celery worker的任务事件；
• 时区设置：通过--tz参数指定Celery应用的时区（默认使用系统本地时间）；
• 传输选项：通过--transport-options参数传递broker传输的额外配置（JSON格式）。

Docker部署示例

1. 默认配置运行（Redis broker）

bash
docker run -d -p 8888:8888 zerok/celery-prometheus-exporter

2. 自定义Broker和监听端口

bash
docker run -d -p 9090:9090 \
  -e BROKER_URL="amqp://user:pass@rabbitmq:5672//" \
  -e DEFAULT_ADDR="0.0.0.0:9090" \
  zerok/celery-prometheus-exporter

3. 启用事件并指定时区

bash
docker run -d -p 8888:8888 \
  --broker redis://my-redis:6379/1 \
  --enable-events \
  --tz "Asia/Shanghai" \
  zerok/celery-prometheus-exporter