gRPC

Überblick

Der gRPC-Monitor ruft die Standardmethode grpc.health.v1.Health/Check an Ihrem Dienst auf und liest dessen Serving-Status zurück. Anders als eine TCP-Prüfung auf demselben Port belegt das, dass der gesamte Stapel funktioniert — TCP, TLS, HTTP/2 und gRPC selbst — und dass der Dienst sagt, er bediene Anfragen.

Verfügbar ab dem Tarif Pro.

Format des Ziels

Das Ziel des Monitors wird als eine Zeichenfolge geschrieben:

[schema://]host:port[/dienst]

Teil	Bedeutung
Schema	grpcs oder https → TLS. grpc oder http → Klartext. Weggelassen → TLS bei Port 443, sonst Klartext.
host:port	Wo der Dienst lauscht. Ohne Port werden 443 für TLS und 80 für Klartext verwendet.
/dienst	Optionaler Dienstname, der in der Health-Anfrage mitgeschickt wird. Weglassen für die Gesamtgesundheit des Servers, gemäß Health-Checking-Protokoll.

Beispiele:

grpcs://api.example.com:443              Gesamtgesundheit des Servers, über TLS
grpcs://api.example.com/orders.v1.Orders ein bestimmter Dienst
grpc://internal.svc:9090                 Klartext, im Cluster
api.example.com:443                      TLS aus dem Port abgeleitet

Wie ein Ergebnis zustande kommt

Health-Antwort	Ergebnis
SERVING	Up
NOT_SERVING	Down, mit dem gemeldeten Status im Fehler
SERVICE_UNKNOWN	Down — der Name in /dienst ist auf diesem Server nicht registriert
Unimplemented	Up — der Server hat über gRPC geantwortet, bietet aber keinen Health-Dienst an. Transport, HTTP/2 und gRPC-Stapel funktionieren, und genau das behauptet eine Verfügbarkeitsprüfung; das Fehlerfeld hält es fest, damit Sie es im Ereignisprotokoll sehen.
Verbindungs-, TLS- oder Zeitüberschreitungsfehler	Down

Wiederholungsfenster und Mehrheitsregel greifen danach genau wie bei jedem anderen Monitor — siehe Status & Verfügbarkeit.

Einstellungen

Einstellung	Beschreibung	Standard
Ziel	[schema://]host:port[/dienst]	—
Port	Überschreibt den Port aus dem Ziel	aus dem Ziel
Intervall	Prüffrequenz	kürzestes Ihres Tarifs
Zeitbudget	Festes Prüfbudget (nicht konfigurierbar)	5 s
Regionen	Von wo aus die Prüfung läuft	eine, gemäß Ihrem Tarif

Anwendungsfälle

• Interne APIs — Ein gRPC-Backend, das keine HTTP-Oberfläche zum Prüfen hat.
• Service Meshes — Bestätigen, dass ein bestimmter Dienstname registriert und bedienend ist, nicht nur, dass der Port Verbindungen annimmt.
• TLS-Terminierung — Ein Klartext-Ziel grpc:// und ein grpcs:// auf demselben Dienst sagen Ihnen, ob ein Problem im Transport oder in der Anwendung liegt.

Private Dienste

Ein gRPC-Dienst, der aus dem Internet nicht erreichbar ist, wird von einem Private Agent aus überwacht — die Prüfung ist identisch, nur der ausführende Agent ändert sich. Öffentliche Regionen weisen Ziele ab, die auf private Adressen auflösen.

Messwerte

Die gesamte Aufrufdauer (Verbindung + TLS + Health-Aufruf) wird bei jeder Prüfung erfasst und speist dieselben Latenzdiagramme, Perzentile und Alarme wie ein HTTP-Monitor.