okerx/bullmq-monitor repository overview

⁠BullMQ Prometheus Exporter Docker Image

okerx/bullmq-monitor is a lightweight Docker image for exposing BullMQ queue metrics in Prometheus format.

It connects to Redis, discovers BullMQ queues automatically, and serves a /metrics endpoint that can be scraped by Prometheus, Grafana, and other monitoring systems.

⁠Keywords

BullMQ, Prometheus exporter, Redis monitoring, queue metrics, Docker, observability, Grafana, Node.js job queue monitoring

⁠Why Use This Image?

• Monitor BullMQ queue metrics with Prometheus
• Discover queues automatically from Redis
• Run as a simple Docker container
• Integrate with Grafana dashboards and alerting
• Track queue health, throughput, and backlog in production

⁠Supported Tags

• latest
• v* release tags, for example v1.2.3

⁠Quick Start

⁠Pull the image

docker pull okerx/bullmq-monitor:latest

⁠Run the container

docker run --rm \
  -p 3030:3030 \
  -e REDIS_URL=redis://host.docker.internal:6379 \
  okerx/bullmq-monitor:latest

The exporter listens on:

• http://localhost:3030/metrics
• http://localhost:3030/healthz

⁠Environment Variables

⁠Prometheus Scrape Config

scrape_configs:
  - job_name: bullmq
    static_configs:
      - targets:
          - localhost:3030

⁠Example Use Cases

• BullMQ queue monitoring in Docker and Kubernetes
• Prometheus and Grafana dashboards for job queues
• Alerting on queue backlog, stuck jobs, or processing slowdowns
• Redis-backed background worker observability

⁠Security Notes

• Keep Redis on a trusted private network
• Use Redis authentication in production
• Restrict access to the /metrics endpoint if queue names or counts are sensitive

⁠Source Code

GitHub repository:

okerx/bullmq-metrics⁠