Checkmate
Uptime monitoring

gRPC monitors

Check gRPC service health.

gRPC monitors call the standard gRPC Health Checking Protocol on a target service and report whether it responds SERVING.

Create a gRPC monitor

  1. Open Uptime and click Create monitor.
  2. Pick gRPC as the monitor type.
  3. Fill in:
    • Host — the server host (for example api.example.com or 127.0.0.1).
    • Port — the gRPC port (typically 50051).
    • Service name — the service to check (leave blank to check overall server health).
  4. Set the check interval and click Create monitor.

What "up" means

Checkmate connects to the server and calls grpc.health.v1.Health/Check with the given service name. The monitor is up only when the server replies with status SERVING. Any other status (NOT_SERVING, UNKNOWN, SERVICE_UNKNOWN) or a connection error is treated as down.

The target service must implement the grpc.health.v1.Health service. Most gRPC libraries ship a default implementation.

Docker monitors

Monitor Docker container status and health.

WebSocket monitors

Check that a WebSocket endpoint accepts connections.

On this page

Create a gRPC monitorWhat "up" means