Synthetic Monitoring
Monitors
gRPC Monitor - Check gRPC Service Health
6 min
the grpc monitor enables continuous health checks for grpc services by invoking specified rpc methods and validating responses creating a new grpc monitor navigate to synthetic monitoring > monitors click add new select grpc check grpc service health from the monitor type dropdown basic settings host\ port enter the grpc server’s host and port in the format hostname\ port to monitor monitor name provide a descriptive name for the grpc monitor check interval define the frequency at which the monitor sends requests to the grpc service timeout set the maximum allowed time to receive a response before marking the check as failed monitoring locations select one or more geographic locations from which the health check requests will be performed notification settings select one or more notification channels to receive alerts if the grpc service becomes unhealthy or unresponsive grpc configuration service specify the fully qualified name of the grpc service to call (e g , package servicename ) method specify the rpc method within the chosen service (e g , methodname ) payload (json) provide the request message in json format although grpc uses binary protobuf, the monitor converts this json payload automatically to protobuf for the request use plaintext (no tls) enable this option to disable ssl/tls encryption, sending requests in plaintext assertions configure assertions to validate different aspects of the grpc responses status code checks the grpc specific status code returned by the server (distinct from http status codes) response time (ms) measures the total time taken for the grpc request and response cycle in milliseconds response body validates the entire response message returned by the grpc server json body (json path) allows inspection of specific fields within the json converted response using jsonpath expressions header checks grpc metadata sent as request/response headers trailer validates grpc trailers—metadata sent after the response body metrics metrics available to be monitored in dashboard section metric name type description labels kloudmate synthetic check grpc response time gauge time taken for the grpc call check id, check name, check type, target, workspace id, location kloudmate synthetic check grpc status code gauge the grpc status code returned by the service check id, check name, check type, target, workspace id, location, grpc method kloudmate synthetic check request duration gauge the total time taken for the primary operation of the check (e g , http request, dns query, grpc call) check id, check name, check type, target, workspace id, location related resources docid\ vgetlvoyfezxy8cq2ccsu