grpc-ecosystem/grpc-health-probe

Health v2 · maintenance only

Adoption not part of the score

1572 stars · 210 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A command-line utility that queries gRPC services implementing the gRPC Health Checking Protocol and exits with success or failure based on the SERVING status. It is designed primarily for Kubernetes exec probes but works anywhere, with support for TLS, timeouts, and custom metadata.

Use cases

• health-check gRPC services in Kubernetes exec probes
• verify a gRPC server is serving before deploying
• add liveness and readiness probes to gRPC apps on older Kubernetes versions
• script gRPC health checks with connect and RPC timeouts
• check gRPC service health over TLS
• monitor gRPC endpoints outside Kubernetes

When to choose

• you run gRPC services on Kubernetes versions without native gRPC health checking
• you need TLS, custom metadata, or fine-grained timeout tuning for health checks
• you want a simple static binary for scripted gRPC health checks outside Kubernetes

When to avoid

• you are on modern Kubernetes with built-in native gRPC health checking support
• your services do not implement the gRPC Health Checking Protocol v1
• you need rich monitoring dashboards rather than a binary pass/fail probe

Facets

cli-tool · maturity maintenance

cli monitoring rpc developer-tools monitoring apis windows cli grpc health-check kubernetes-probes exec-probe golang devops containers linux macos kubernetes docker

Member repositories

For agents

markdown · JSON · MCP: product_card(name="grpc-ecosystem/grpc-health-probe")