blog · release

bunqueue v2.1.1

Prometheus + Grafana Monitoring Stack, monitoring Documentation.

egeominotti

To install bunqueue v2.1.1

bun add bunqueue@2.1.1

npm install bunqueue@2.1.1

To upgrade bunqueue

bun add bunqueue@latest

Prometheus + Grafana Monitoring Stack

Complete observability setup:

• Docker Compose profile for one-command monitoring deployment
• Pre-configured Prometheus scraping with 5s interval
• Comprehensive Grafana dashboard with 6 panel rows:
  • Overview: Waiting, Delayed, Active, Completed, DLQ, Workers, Cron, Uptime
  • Throughput: Jobs/sec graphs, queue depth over time
  • Success/Failure: Rate gauges, completed vs failed charts
  • Workers: Count, throughput, utilization gauge
  • Webhooks & Cron: Status and lifetime totals
  • Alerts: Visual indicators for DLQ, failure rate, backlog, workers
• 8 pre-configured Prometheus alert rules:
  • BunqueueDLQHigh - DLQ > 100 for 5m (critical)
  • BunqueueHighFailureRate - Failure > 5% for 5m (warning)
  • BunqueueQueueBacklog - Waiting > 10k for 10m (warning)
  • BunqueueNoWorkers - No workers with waiting jobs (critical)
  • BunqueueServerDown - Server unreachable (critical)
  • BunqueueLowThroughput - < 1 job/s for 10m (warning)
  • BunqueueWorkerOverload - Utilization > 95% (warning)
  • BunqueueJobsStuck - Active jobs, no completions (warning)

Monitoring Documentation

New guide at /guide/monitoring/

Changes

• Docker Compose now supports --profile monitoring for optional stack

Thanks to 1 contributor!

• @egeominotti

---

← bunqueue v2.1.0 · Release on GitHub · Commits since v2.1.0 · Full changelog · All posts