# bunqueue v2.1.1

Prometheus + Grafana Monitoring Stack, monitoring Documentation.

Canonical: https://bunqueue.dev/blog/bunqueue-v2-1-1/

---

<!-- Generated from changelog.md by docs/scripts/generate-release-posts.ts. Edit the changelog and regenerate. -->

Prometheus + Grafana Monitoring Stack, monitoring Documentation.

![](https://github.com/egeominotti.png?size=64) [egeominotti](https://github.com/egeominotti)

#### To install bunqueue v2.1.1

```bash title="bun"
bun add bunqueue@2.1.1
```

```bash title="npm"
npm install bunqueue@2.1.1
```

#### To upgrade bunqueue

```bash
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](https://github.com/egeominotti)

---

[← bunqueue v2.1.0](https://bunqueue.dev/blog/bunqueue-v2-1-0/) · [Release on GitHub](https://github.com/egeominotti/bunqueue/releases/tag/v2.1.1) · [Commits since v2.1.0](https://github.com/egeominotti/bunqueue/compare/v2.1.0...v2.1.1) · [Full changelog](https://bunqueue.dev/changelog/) · [All posts](https://bunqueue.dev/blog/)