Queues Dashboard

The Bull Board is a tool that allows you to check issues with scheduling and internal flow runs issues.

​

Setup BullBoard

To enable the Bull Board UI in your self-hosted installation:

1. Define these environment variables:

   • AP_QUEUE_UI_ENABLED: Set to true
   • AP_QUEUE_UI_USERNAME: Set your desired username
   • AP_QUEUE_UI_PASSWORD: Set your desired password

2. Access the UI at /api/ui

​

Common Issues

​

Scheduling Issues

If a scheduled flow is not triggering as expected:

1. Check the repeatableJobs queue in BullBoard to verify the job exists
2. Verify the job status is not “failed” or “delayed”
3. Check that the cron expression or interval is configured correctly
4. Look for any error messages in the job details

​

Flow Stuck in “Running” State

If a flow appears stuck in the running state:

1. Check the oneTimeJobs queue for the corresponding job
2. Look for:
   • Jobs in “delayed” state (indicates retry attempts)
   • Jobs in “failed” state (indicates execution errors)
3. Review the job logs for error messages or timeouts
4. If needed, you can manually remove stuck jobs through the BullBoard UI

​

Queue Overview

We maintain four main queues in our system:

​

Scheduled Queue (repeatableJobs)

Contains both polling and delayed jobs.

​

One-Time Queue (oneTimeJobs)

Handles immediate flow executions that run only once

​

Webhook Queue (webhookJobs)

Handles incoming webhook triggers

​

Users Interaction Queue (usersInteractionJobs)

Handles operations that are directly initiated by users, including: • Installing pieces • Testing flows • Loading dropdown options • Executing triggers • Executing actions