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 HealthCheck CRD 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/kuberhealthykuberhealthy.svg)](https://yunodb.com/tools/kuberhealthykuberhealthy?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/kuberhealthykuberhealthy?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/kuberhealthykuberhealthy.svg" alt="Featured on YunoDB" height="20"></a>