docs/install/troubleshooting/bullboard.mdx
The Bull Board is a tool that allows you to check issues with scheduling and internal flow runs issues.
To enable the Bull Board UI in your self-hosted installation:
Define these environment variables:
AP_QUEUE_UI_ENABLED: Set to trueAP_QUEUE_UI_USERNAME: Set your desired usernameAP_QUEUE_UI_PASSWORD: Set your desired passwordAccess the UI at /api/ui
We have one main queue called workerJobs that handles all job types. Each job has a jobType field that tells us what it does:
Renews webhooks for pieces that have webhooks channel with expiration like Google Sheets.
Checks external services for new data at regular intervals.
Runs flows when they're triggered.
Processes incoming webhook requests that start flow runs.
Runs flows that were scheduled for later, like paused flows or delayed executions.
Loads dynamic properties for pieces that need them at runtime.
Gets information about pieces when they're being installed or set up.
Checks that flow settings, inputs, or data are correct before running.
Runs special logic before or after triggers fire.
<Info> Failed jobs are not normal and need to be checked right away to find and fix what's causing them. They require immediate investigation as they represent executions that failed for unknown reasons that could indicate system issues. </Info> <Tip> Delayed jobs represent either paused flows scheduled for future execution, upcoming polling job iterations, or jobs being retried due to temporary failures. They indicate an internal system error occurred and the job will be retried automatically according to the backoff policy. </Tip>