checkfleet

HashiCorp Consul check

consul — HashiCorp Consul

Raft leader and quorum, critical/warning service checks, and required KV keys.

checkfleet check consul --config checkfleet.yml

Consul cluster health via the HTTP API — read-only.

  • Raft leader: /v1/status/leader empty → BAD (no leader elected).
  • Raft peers: /v1/status/peers count vs expect_peers — below quorum (majority) → BAD, below expected but with quorum → WARN.
  • Service/node health: every check in /v1/health/state/critical → BAD, every one in .../warning → WARN, labelled service@node.
  • KV keys: each key in kv_keys missing (/v1/kv/<key> → 404) → BAD.

Any agent answers cluster-wide, so one endpoint is enough; extras add redundancy (an unreachable one is ERROR). An ACL token can be supplied via token_env (read from the environment, never stored in config).

See Configuration → checks.consul.

See the full module reference for every check, or configuration for the config keys.