Skip to content

docs: add a dedicated page for the local queue options - #649

Open
Krrishkumar125 wants to merge 1 commit into
graphile:mainfrom
Krrishkumar125:docs/local-queue
Open

Krrishkumar125 wants to merge 1 commit into
graphile:mainfrom
Krrishkumar125:docs/local-queue

Conversation

@Krrishkumar125

Copy link
Copy Markdown

Fixes #585.

The local queue options were only described on the performance page and briefly in the config reference, so this adds a Local queue page covering:

  • size, ttl and refetchDelay (durationMs, threshold, maxAbortThreshold), with defaults taken from src/localQueue.ts / src/main.ts (e.g. the 0.5–1.5× jitter on durationMs, the durationMs <= pollInterval check, the 5 * size abort default, and the warning when size < concurrentJobs)
  • the tradeoffs (locked-but-idle jobs, ignored new-job notifications, crash behaviour)
  • the localQueue:* events for monitoring

The config and performance pages now link to it. Docs only; prettier --check passes.

One thing I noticed while reading the source: the class comment in localQueue.ts says WAITING mode lasts at most getJobBatchTime (30 minutes), but the code uses localQueue.ttl (default 5 minutes). I documented the code's behaviour. Happy to update that comment here too if you'd like.

Documents size, ttl and refetchDelay (durationMs, threshold,
maxAbortThreshold) with their defaults, the tradeoffs of enabling the
local queue, and the events it emits. Links to it from the config and
performance pages.

Fixes graphile#585
Copilot AI balanced review requested due to automatic review settings October 22, 2026 10:40

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Write docs for local queue!

2 participants