Getting Started

Quickstart

Install the SDK, attach your queue, and start seeing jobs in the dashboard.

Get monitoring started fast – the SDK auto-detects your queue type and streams job events in real time.

Prereqs

  • Node.js 18+
  • BullMQ, Bull, or Bee-Queue
  • A Queuedash account

Install the SDK

pnpm add @queuedash/sdk
# npm install @queuedash/sdk
# yarn add @queuedash/sdk

Add your API key

  1. In your project, go to API KeysCreate API Key
  2. Copy it (shown once) and store it in your secrets manager
QUEUEDASH_API_KEY=sk_live_...

Attach your queue

BullMQ example:

import { Queue } from "bullmq";
import { Queuedash } from "@queuedash/sdk";
 
const qd = new Queuedash({
  apiKey: process.env.QUEUEDASH_API_KEY,
});
 
const myQueue = new Queue("my-queue", {
  connection: { host: "localhost", port: 6379 },
});
 
qd.attach(myQueue); // that's it

The SDK auto-detects BullMQ, Bull, and Bee-Queue.

Supported queues at a glance

QueueVersionEvents trackedDelayed jobsProgress events
BullMQ4.xadded, waiting, delayed, active, progress, completed, failed, stalled, removedYesYes
Bull4.xactive, progress, completed, failed, removedYesYes
Bee-Queue1.xsucceeded, failed, retryingNoPartial
GroupMQ1.xadded, active, completed, failedYesYes

Next Steps