Skip to content

docs(healthz): correct stale 2s timeout comment — no timeout is set#260

Merged
CryptoJones merged 1 commit into
masterfrom
docs/healthz-correct-timeout-comment
May 19, 2026
Merged

docs(healthz): correct stale 2s timeout comment — no timeout is set#260
CryptoJones merged 1 commit into
masterfrom
docs/healthz-correct-timeout-comment

Conversation

@CryptoJones
Copy link
Copy Markdown
Owner

Summary

Comment-only fix in app/controllers/healthcontroller.js.

The inline comment on the SELECT 1 probe claimed "Sequelize uses pg's query_timeout for this on Postgres. 2s is well over the expected sub-ms response..." but no timeout / query_timeout option is actually passed to sequelize.query() — and the Sequelize options bag at the call site doesn't expose a per-query timeout for postgres anyway.

The comment has been wrong since the original /healthz PR (#4) and likely misled operators looking for a tunable.

What changed

Replaced the misleading comment with:

  • An accurate description of current behavior (probe hangs until orchestrator's own probe timeout fires, typically 5–10s)
  • A pointer to where a real timeout could be added (dialectOptions.statement_timeout in db.config.js) if it ever matters in practice

Test plan

  • npm run lint && npm test — 688 passing
  • Comment-only change

Proudly Made in Nebraska. Go Big Red! 🌽 https://xkcd.com/2347/

The inline comment on the SELECT 1 probe in /healthz claimed
"Sequelize uses pg's query_timeout for this on Postgres. 2s is well
over the expected sub-ms response..." but no `timeout` /
`query_timeout` option is actually passed to `sequelize.query()` —
and the Sequelize options bag at the call site doesn't expose a
per-query timeout for postgres anyway.

The comment has been wrong since the original /healthz PR (#4) and
likely misled operators looking for a tunable. Replace the comment
with an accurate description of the current behavior (the request
hangs until the orchestrator's own probe timeout fires) and a
pointer to how to add a real one if it ever matters
(`dialectOptions.statement_timeout` in db.config.js).

Comment-only change; no behavior change. 688 tests still pass.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@CryptoJones CryptoJones merged commit 244ac8e into master May 19, 2026
3 checks passed
@CryptoJones CryptoJones deleted the docs/healthz-correct-timeout-comment branch May 19, 2026 13:18
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.

1 participant