kuberhealthy
A Kubernetes operator for running synthetic checks as pods. Works great with Prometheus!
What is kuberhealthy?
A Kubernetes operator for running synthetic checks as pods. Works great with Prometheus!
Overview of kuberhealthy
What it is
Kuberhealthy is a Kubernetes operator for synthetic monitoring and continuous validation. It runs short-lived checker pods on a schedule, collects their results, and exposes them via a built-in status UI, a JSON API, and a Prometheus metrics endpoint. The project provides a custom resource definition (CRD) called HealthCheck that allows users to define their monitoring logic as Kubernetes manifests. Kuberhealthy is open source under the Apache-2.0 license and is categorized under Monitoring.
Key features
- Schedules and manages short-lived checker pods for synthetic checks.
- Exposes check results via Prometheus metrics, a JSON API, and a web UI.
- Supports checks written in any language (Go, Python, Rust, bash, etc.) as long as they fit in a container.
- Provides a
HealthCheckCRD so checks can be defined and versioned as Kubernetes manifests. - Includes check client libraries for multiple languages (Go, Python, TypeScript, JavaScript, Rust, Ruby, Java, Bash).
- Works with Helm, Kustomize, and ArgoCD for installation.
Use cases
- Running synthetic monitoring that simulates real user workflows (e.g., log in, create a record, verify it, clean it up).
- Continuous validation of cluster components, such as API availability, database connectivity, or deployment rollouts.
- Packaging monitoring logic alongside applications as Kubernetes manifests for GitOps workflows.
Getting started
Install Kuberhealthy to your cluster using one of the following methods:sh# Helm (recommended)helm install kuberhealthy deploy/helm/kuberhealthy -n kuberhealthy --create-namespace``````sh# Kustomizekubectl apply -k github.com/kuberhealthy/kuberhealthy/deploy/kustomize/base?ref=main``````sh# ArgoCDkubectl apply -f deploy/argocd/kuberhealthy.yamlAfter installation, port-forward the service and open the UI:shkubectl -n kuberhealthy port-forward svc/kuberhealthy 8080:80Then apply a HealthCheck resource or build your own. See the repository README for full details.
License and pricing
Kuberhealthy is open source and licensed under Apache-2.0. Pricing is not stated; it is categorized as open source.
Based on the project's public README and repository metadata.