Synthetic monitoring for Kubernetes: prove your cluster actually works by continuously running the real workflows your applications depend on.

Welcome to Kuberhealthy: Synthetic Monitoring for Kubernetes.

Kuberhealthy is a CNCF sandbox operator that turns continuous process verification into a first-class Kubernetes concern. Instead of waiting for a real user to discover that deployments are stuck, DNS is broken, or a node can no longer provision containers, Kuberhealthy runs synthetic checks — small checker pods that perform the actual workflow, observe the result, and report pass or fail. You describe a check as a custom resource, Kuberhealthy schedules it on an interval, and the outcome flows out as a JSON status page and Prometheus metrics that plug straight into your alerting. This book starts with the problem synthetic monitoring solves and the core idea of running tests as pods, then works through the operator's architecture, the KuberhealthyCheck custom resource, the catalog of built-in checks, the reporting protocol that lets you write custom checks in any language, the observability surface, and finally the operational practices that make Kuberhealthy a dependable early-warning system for your clusters.

This title is part of the ShriIra library and is free to read in full, right here — our small contribution to making world-class knowledge easy to reach.

A note on reading it: open the Contents menu at the top of the reader to jump between chapters, use the Aa menu to set a comfortable text size, theme (light, sepia, or night), and single- or two-page layout. Your place is saved automatically, so you can always pick up where you left off.

We hope it serves you well.

— Shriira Press

Contents

1. Chapter 1 — Why Synthetic Monitoring
2. Chapter 2 — Checks as Pods
3. Chapter 3 — Architecture
4. Chapter 4 — The KuberhealthyCheck Resource
5. Chapter 5 — The Built-in Checks
6. Chapter 6 — Writing Custom Checks
7. Chapter 7 — Kuberhealthy in Practice