checkfleet

gRPC services check

grpc — gRPC services

The gRPC Health Checking Protocol over HTTP/2 and TLS — SERVING, NOT_SERVING or UNKNOWN.

checkfleet check grpc --config checkfleet.yml

gRPC Health Checking Protocol (grpc.health.v1.Health/Check) over HTTP/2 + TLS, with the protobuf messages encoded by hand — no gRPC library dependency. (Plaintext h2c isn’t supported; TLS endpoints only.)

  • SERVING → OK; NOT_SERVING / SERVICE_UNKNOWN → BAD; UNKNOWN → WARN.
  • grpc-status 12 (UNIMPLEMENTED, no health service) → WARN; 5 (NOT_FOUND, unknown service) → BAD.
  • Connection/handshake failure → ERROR.

Set service to check a specific gRPC service, or leave empty for whole-server health. insecure_skip_verify for internal self-signed endpoints.

See Configuration → checks.grpc.

See the full module reference for every check, or configuration for the config keys.