Commands icon
If icon
SlackIncomingWebhook icon
Schedule icon

HashiCorp Consul Autopilot Raft Quorum and Cluster Health Sentinel

Audits HashiCorp Consul Autopilot for Raft quorum health and voter commit index synchronization to prevent cluster brain-split.

Categories
CloudInfrastructure

How it works

This workflow connects to the HashiCorp Consul Operator API (/v1/operator/autopilot/health) using an ACL token to inspect cluster Autopilot health. Autopilot continuously assesses Raft consensus health, server member stability, voter synchronization, and cluster failure tolerance (how many server node failures the cluster can withstand before quorum loss). If Healthy == false or failure tolerance drops to 0, service registration, key-value lookups, and Connect service mesh routing are at imminent risk of total outage. This workflow triggers alerts before consensus collapses.

What you get

  • Real-time detection of degraded Raft consensus in HashiCorp Consul clusters.
  • Prevents catastrophic cluster quorum loss and split-brain scenarios.
  • Clear visibility into failure tolerance and server node readiness.

Who it's for

  • Platform Engineers and Infrastructure SREs operating HashiCorp Consul.
  • Network Architects managing service discovery and Connect service mesh.

Why orchestrate this with Kestra

  • Continuous Core Infrastructure Monitoring: Proactively monitors critical consensus engines.
  • Secure ACL Integration: Automatically passes secret tokens using Kestra secret store.
  • Instant Team Escalation: Delivers incident notifications with quorum metrics directly to Slack.

Prerequisites

  • Consul server with Autopilot enabled and operator read ACL token.
  • Secrets CONSUL_HTTP_TOKEN and SLACK_WEBHOOK configured in Kestra.

Quick start

  1. Import the blueprint.
  2. Input Consul server URL.
  3. Run the workflow to inspect Autopilot health.

How to extend

  • Query /v1/operator/raft/configuration to view specific server node IP addresses and voter statuses.
  • Alert when Raft commit index lag exceeds 100 transactions between leader and followers.

Links

See How

New to Kestra?

Use blueprints to kickstart your first workflows.