ovalmoney/celery-exporter

Celery Exporter镜像说明

镜像概述

Celery Exporter是针对Celery 4的Prometheus指标导出器，采用Python开发，可收集并暴露Celery任务的关键指标，助力用户监控Celery任务队列的运行状态与性能。

核心功能

• 任务总数统计：通过celery_tasks_total指标按任务名称、状态、队列和命名空间统计当前任务数量；
• 运行时间监控：通过celery_tasks_runtime_seconds直方图记录任务完成所需时间；
• 延迟分析：通过celery_tasks_latency_seconds直方图记录任务从接收至被工人拾取的延迟；
• 工人存活统计：通过celery_workers指标反映当前存活的工人数量。

使用场景

• 监控Celery任务队列健康状态，及时发现任务堆积或失败问题；
• 分析任务性能瓶颈，优化任务执行效率；
• 跟踪工人节点存活情况，确保任务处理能力充足。

配置说明

依赖要求

• 镜像已预装Redis依赖，若使用RabbitMQ等其他消息broker，需额外安装对应依赖；
• Celery工人需开启任务事件发送（参考Celery官方配置worker_send_task_events），也可通过--enable-events选项定期启用事件。

命令行选项

主要配置选项：

• -b, --broker-url：Celery broker的URL（默认：redis://redis:6379/0）；
• -l, --listen-address：HTTP服务监听地址（默认：0.0.0.0:9540）；
• -m, --max-tasks：任务缓存大小（默认：***）；
• -n, --namespace：指标命名空间（默认：celery）；
• --enable-events：定期启用Celery事件；
• --verbose：开启详细日志。

Docker部署示例

拉取镜像

bash
docker pull ovalmoney/celery-exporter

运行容器

bash
docker run -it --rm \
  -p 9540:9540 \
  -e CELERY_EXPORTER_BROKER_URL=redis://your-redis-host:6379/0 \
  ovalmoney/celery-exporter

Docker Compose示例

yaml
version: '3'
services:
  celery-exporter:
    image: ovalmoney/celery-exporter
    ports:
      - "9540:9540"
    environment:
      - CELERY_EXPORTER_BROKER_URL=redis://redis:6379/0
    depends_on:
      - redis
  redis:
    image: redis:alpine