Health Check Plugins

Mon, 01 Jan 2024 00:00:00 +0000

Health Check Plugins

Health check plugins allow Krkn to continuously monitor the health of your services and infrastructure during chaos experiments. They run in background threads alongside the chaos scenario, detecting outages, tracking downtime duration, and collecting telemetry data.

Overview

The health check system uses a plugin architecture:

HealthCheckFactory — automatically discovers and loads all plugins from the krkn.health_checks package
AbstractHealthCheckPlugin — base class all plugins must extend
Plugins run in separate threads and write telemetry to a shared queue
The factory tracks all active plugin instances and provides lifecycle management (increment_all_iterations, stop_all)

Exit Codes

Code	Meaning
`0`	Success — all health checks passed
`2`	Critical alert detected during the run
`3`	Health check failure (e.g. `exit_on_failure: true` triggered)

Built-in Plugins

HTTP Health Check (`health_checks`)

Monitors HTTP endpoints by making periodic GET requests. Tracks status changes, measures downtime duration, and records telemetry for each state transition.

Health-Checks on Krkn

Health Check Plugins

Health Check Plugins

Overview

Exit Codes

Built-in Plugins

HTTP Health Check (health_checks)

HTTP Health Check (`health_checks`)