Registry / devops / bull-arena

bull-arena

JSON →
library4.9.2jsnpmunverified

A web-based GUI for monitoring and managing Redis-backed job queues for Bee Queue, Bull, and BullMQ. Built on Express, can be run standalone or mounted as middleware. Current stable version: 4.9.2. Released irregularly. Differentiators: single UI for multiple queue libraries, supports Bee, Bull, and BullMQ; provides job filtering, pagination, detail views, and retry/restart actions; easy to embed into existing Express apps.

npm install bull-arena
INSTALL
IMPORT
SIG · BULL-ARENA
B
bull-arena
devopsjavascriptv4.9.2
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

Arena
import Arena from 'bull-arena'
const Arena = require('bull-arena').default
Default export is a function. CommonJS require works: const Arena = require('bull-arena'). If using ESM, import Arena from 'bull-arena' works. Do not use .default.
Arena
const Arena = require('bull-arena')
const { Arena } = require('bull-arena')
Arena is default export, not named.
Arena (with Bull)
const Bull = require('bull'); const Arena = require('bull-arena')({ Bull, queues: [...] })
Arena({}); // missing Bull import
Must pass queue library instance to Arena options. For Bull, pass Bull property. For Bee, pass Bee property. For BullMQ, pass BullMQ property.

Mounts Arena as Express middleware for monitoring a Bull queue.

const Arena = require('bull-arena'); const Bull = require('bull'); const express = require('express'); const app = express(); const arena = Arena({ Bull, queues: [ { name: 'my-queue', hostId: 'My Server', type: 'bull', redis: { host: process.env.REDIS_HOST || 'localhost', port: process.env.REDIS_PORT || 6379, } } ] }); app.use('/', arena); app.listen(3000, () => console.log('Arena running on port 3000'));
Debug
Known issues
breakingIn v4 and above, the 'type' field is required for each queue definition. Previously defaulted to 'bull'.
fix
Add 'type': 'bull' or 'type': 'bee' to each queue object.
affects: >=4.0.0
gotchaIf using BullMQ, must pass 'BullMQ' property to Arena options (not 'Bull').
fix
Use { BullMQ } instead of { Bull } in Arena options.
affects: >=4.0.0
gotchaRedis configuration is per-queue; if multiple queues share same Redis, still need to provide connection details for each.
fix
Duplicate redis config across queue objects or use a shared helper.
affects: >=4.0.0
deprecatedThe 'customCssPath' and 'customJsPath' options are deprecated and may be removed in future versions.
fix
Use a reverse proxy or serve custom files separately.
affects: >=4.0.0
Errors
Common errors & fixes
TypeError: Arena is not a function
Using named import instead of default import in ESM.
fix
Use `import Arena from 'bull-arena'` or `const Arena = require('bull-arena')`.
Error: Missing 'name' property in queue definition
Queue object missing required 'name' key.
fix
Add 'name' to each queue object.
Error: Cannot find module 'bull'
Bull library not installed or not passed to Arena.
fix
Install bull and pass it as `Bul` property to Arena options.
Upgrade
Version history
4.9.2latest on npm
Audit
Dependencies
expressrequiredWeb server framework
redisoptionalRedis client (used by Bee)
ioredisoptionalRedis client (used by Bull/BullMQ)
bee-queueoptionalOptional: Bee queue library if monitoring Bee
bulloptionalOptional: Bull queue library if monitoring Bull
bullmqoptionalOptional: BullMQ queue library if monitoring BullMQ
Agent activity
4 hits · last 30 days
node
4
Resources
bull-arena — npm install bull-arena · libregistry