Skip to content

Add liveness and readiness HTTP endpoints#1239

Draft
emersonian wants to merge 1 commit into
zingolabs:devfrom
zecrocks:be/liveness-readiness
Draft

Add liveness and readiness HTTP endpoints#1239
emersonian wants to merge 1 commit into
zingolabs:devfrom
zecrocks:be/liveness-readiness

Conversation

@emersonian

@emersonian emersonian commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

For container orchestrators like Kubernetes to know if Zaino is alive and synced, ready for end-user traffic.

  • New opt-in HTTP server on a dedicated port (health.listen_addr, disabled by default).
  • Readiness is decided by proximity to the chain tip (blocks-behind plus tip-age), like Zebra. This avoids ready-state flapping when the chain isn't perfectly at the tip.
  • Endpoint names (/livez, /readyz) follow the Kubernetes API-server convention; configuration style ([health] section) mirrors Zebra.

Reference zcash-stack for examples of how we use this in production for Zec.rocks:

Related:

For container orchestrators like Kubernetes to know if Zaino is
alive and synced, ready for end-user traffic.

- New opt-in HTTP server on a dedicated port (health.listen_addr,
  disabled by default).
- Readiness is decided by proximity to the chain tip (blocks-behind
  plus tip-age), like Zebra. This avoids ready-state flapping when
  the chain isn't perfectly at the tip.
- Endpoint names (/livez, /readyz) follow the Kubernetes
  API-server convention; configuration style ([health] section)
  mirrors Zebra.
@zancas

zancas commented Jun 27, 2026

Copy link
Copy Markdown
Member

Moving this to draft until we address #1311

@zancas
zancas marked this pull request as draft June 27, 2026 01:01
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.

3 participants