Systemdiagnosen konfigurieren

Google Distributed Cloud (GDC) mit Air Gap bietet Mechanismen zur Systemdiagnose, um herauszufinden, ob Backend-Instanzen ordnungsgemäß auf Traffic reagieren. In diesem Dokument wird beschrieben, wie Sie Systemdiagnosen für Load Balancer erstellen und verwenden.

Sofern nicht anders angegeben, werden Google Cloud -Systemdiagnosen durch dedizierte Softwareaufgaben implementiert, die gemäß den in einer Systemdiagnoseressource angegebenen Parametern eine Verbindung zu Backends herstellen. Jeder Verbindungsversuch wird als Prüfung bezeichnet. Google Cloud zeichnet den Erfolg oder Misserfolg jeder Prüfung auf.

Der Systemzustand jedes Backends wird durch eine konfigurierbare Anzahl aufeinanderfolgender erfolgreicher oder fehlgeschlagener Prüfungen bestimmt. Sie konfigurieren also die Anzahl der aufeinanderfolgenden erfolgreichen Prüfungen, die erforderlich sind, um ein Backend als fehlerfrei zu kennzeichnen, und die Anzahl der aufeinanderfolgenden Fehler, um es als fehlerhaft zu kennzeichnen.

Dieser Status bestimmt, ob ein Backend neue Anfragen oder Verbindungen empfangen kann. Ein fehlerhaftes Backend, das durch die Systemdiagnose identifiziert wurde, empfängt keinen Traffic über den Load Balancer. Sie definieren die Kriterien für eine erfolgreiche Prüfung. Weitere Informationen finden Sie im Abschnitt Funktionsweise von Systemdiagnosen.

Systemdiagnoseprotokolle

Systemdiagnosen unterstützen die folgenden Protokolle:

  • TCP
  • HTTP
  • HTTPS

Systemdiagnose auswählen

Systemdiagnosen müssen mit dem Typ des Load Balancers und den Backend-Typen kompatibel sein. Berücksichtigen Sie bei der Auswahl einer Systemdiagnose die folgenden Faktoren:

  • Protokoll: Das Protokoll, mit dem GDC die Backends prüft. Die unterstützten Protokolle sind TCP, HTTP und HTTPS. Das TCP-Protokoll ist nützlich für grundlegende Systemdiagnosen, die die Verbindung zu einem Backend prüfen. Die HTTP- und HTTPS-Protokolle bieten dagegen detailliertere Systemdiagnosemechanismen für VMs, auf denen bereits HTTP- oder HTTPS-Arbeitslasten ausgeführt werden.
  • Portspezifikation: Der Port, den GDC mit dem Protokoll verwendet, um den Zustand eines Backends zu prüfen. Sie müssen einen Port für die Systemdiagnose angeben.
  • Kategorie: Systemdiagnosen können global oder zonal sein. Globale Systemdiagnosen erstrecken sich über alle Zonen einer GDC-Bereitstellung, während zonale Systemdiagnosen einer Zone entsprechen.

Funktionsweise von Systemdiagnosen

In den folgenden Abschnitten wird beschrieben, wie Systemdiagnosen funktionieren.

Prüfungen

Wenn Sie eine Systemdiagnose einrichten, definieren oder akzeptieren Sie Standardeinstellungen, die festlegen, wie oft jede Prüfung den Zustand der zugehörigen Endpunkte bewertet. Diese Einstellungen sind entscheidend, da der Load Balancer keine Anfragen mehr an ein Backend weiterleitet, das gemäß den von Ihnen konfigurierten Kriterien als fehlerhaft eingestuft wird. Die Prüfung wird fortgesetzt und der Traffic wird wieder an das Backend gesendet, sobald es wieder als fehlerfrei gilt.

Die Einstellungen für die Systemdiagnose gelten einheitlich für alle Backends in einem Backend-Dienst oder Zielpool und können nicht pro Backend konfiguriert werden.

Konfigurations-Flag Erklärung Standardwert
Prüfintervall

check-interval

Die Zeit (in Sekunden) vom Beginn einer Prüfung bis zum Beginn der nächsten Prüfung durch denselben Prober. 5s (5 Sekunden)
timeoutSec

timeoutSec

Die Zeit in Sekunden, die auf eine Prüfung gewartet werden soll, bevor ein Fehler gemeldet wird. 5s (5 Sekunden)
healthyThreshold

healthyThreshold

Die Anzahl der sequenziellen Testdurchläufe, die bestanden werden müssen, damit der Endpunkt als fehlerfrei eingestuft wird. 2
unhealthyThreshold

unhealthyThreshold

Die Anzahl der aufeinanderfolgenden Prüfungen, die fehlschlagen müssen, damit der Endpunkt als fehlerhaft eingestuft wird. 2

Erfolgskriterien für HTTP- und HTTPS-Systemdiagnosen

Bei HTTP- und HTTPS-Systemdiagnosen ist ein HTTP-200 (OK)-Statuscode für eine erfolgreiche Antwort erforderlich, bevor das Zeitlimit für die Systemdiagnose abläuft. Andere HTTP-Antwortcodes, einschließlich Weiterleitungen (z. B. 301, 302), gelten als fehlerhaft.

Neben der Anforderung eines HTTP-200 (OK)-Antwortcodes können Sie Folgendes tun:

  • Konfigurieren Sie jeden Systemdiagnose-Prober so,dass HTTP-Anfragen an einen bestimmten Anfragepfad anstelle des Standardanfragepfads / gesendet werden.
  • Konfigurieren Sie jeden Systemdiagnose-Prober so, dass er im HTTP-Antworttext nach einem erwarteten Antwortstring sucht. Der erwartete Antwortstring darf nur aus druckbaren ASCII-Zeichen mit einem Byte bestehen, die sich innerhalb der ersten 1.024 Byte des HTTP-Antworttexts befinden.

In der folgenden Tabelle sind gültige Kombinationen der Felder requestPath und response aufgeführt, die für HTTP- und HTTPS-Systemdiagnosen verfügbar sind.

Konfigurations-Flags Prober-Verhalten Erfolgskriterien
Weder RequestPath noch Response angegeben Der Prober verwendet / als Anfragepfad. Nur HTTP-200 (OK)-Antwortcode.
Sowohl RequestPath als auch Response angegeben Der Prober verwendet den konfigurierten Anfragepfad. Der HTTP-Antwortcode 200 (OK) und bis zu den ersten 1.024 ASCII-Zeichen des HTTP-Antworttexts müssen mit dem erwarteten Antwortstring übereinstimmen.
Nur Response angegeben Der Prober verwendet / als Anfragepfad. Der HTTP-Antwortcode 200 (OK) und bis zu den ersten 1.024 ASCII-Zeichen des HTTP-Antworttexts müssen mit dem erwarteten Antwortstring übereinstimmen.
Nur RequestPath angegeben Der Prober verwendet den konfigurierten Anfragepfad. Nur HTTP-200 (OK)-Antwortcode.

Erfolgskriterien für TCP-Systemdiagnosen

Für TCP-Systemdiagnosen gelten die folgenden grundlegenden Erfolgskriterien:

  • Bei TCP-Systemdiagnosen muss ein Prober für die Systemdiagnose vor Ablauf des Zeitlimits für die Systemdiagnose eine TCP-Verbindung zum Backend öffnen.
  • Bei TCP-Systemdiagnosen muss die TCP-Verbindung auf eine der folgenden Arten geschlossen werden:
    • Der Prober für die Systemdiagnose sendet entweder ein FIN- oder ein RST-Paket (Reset).
    • Das Backend sendet ein FIN-Paket.
    • Wenn ein Backend ein TCP-RST-Paket sendet, könnte die Prüfung als nicht erfolgreich eingestuft werden, wenn der Prober für die Systemdiagnose bereits ein FIN-Paket gesendet hat.

Hinweis

Zum Konfigurieren von Systemdiagnoseprüfungen benötigen Sie Folgendes:

  • Sie müssen Inhaber des Projekts sein, für das Sie den Load Balancer konfigurieren. Weitere Informationen finden Sie unter Projekt erstellen.
  • Die erforderlichen Identitäts- und Zugriffsrollen:

    • Bitten Sie Ihren IAM-Admin der Organisation, Ihnen die Rolle „Load Balancer-Administrator“ (load-balancer-admin) zuzuweisen.
    • Bitten Sie für globale ILBs Ihren IAM-Admin der Organisation, Ihnen die Rolle „Global Load Balancer Admin“ (global-load-balancer-admin) zuzuweisen. Weitere Informationen finden Sie unter Vordefinierte Rollenbeschreibungen.

Systemdiagnosen erstellen und verwalten

GDC unterstützt globale und zonale Systemdiagnosen.

HealthCheck API

Sie können ein HealthCheck-Objekt als global oder zonal konfigurieren. Globale HealthCheck-Objekte werden für globale Load-Balancer-Konfigurationen verwendet, während zonale HealthCheck-Objekte für zonale Load-Balancer-Konfigurationen verwendet werden. Beide Typen haben denselben Namen und dieselbe Spezifikation. Sie verwenden jedoch unterschiedliche apiVersion-Werte und API-Server:

Sie können auch die gdcloud CLI verwenden, um Systemdiagnosen zu erstellen und zu verwalten.

Globalen HealthCheck erstellen

Im folgenden Beispiel wird gezeigt, wie Sie mit der API eine Systemdiagnose erstellen:

  kubectl --kubeconfig GLOBAL_ORG_ADMIN_CLUSTER_KUBECONFIG apply -f - <<EOF 
  apiVersion: networking.global.gdc.goog/v1 
  kind: HealthCheck 
  metadata: 
    namespace: PROJECT 
    name: my-hc 
  spec: 
    httpHealthCheck: 
      port: PORT 
      host: HOST 
      requestPath: requestPath 
      response: responseT 
  EOF

Zonale HealthCheck erstellen

Im folgenden Beispiel wird gezeigt, wie Sie mit der API eine Systemdiagnose erstellen:

  kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG apply -f - <<EOF 
  apiVersion: networking.gdc.goog/v1
  kind: HealthCheck
  metadata:
    namespace: PROJECT
    name: my-hc
  spec:
    httpHealthCheck:
      port: PORT
      host: HOST
      requestPath: requestPath 
      response: response 
  EOF 

Informationen zum Verknüpfen einer Systemdiagnose mit einem Load Balancer finden Sie hier:

Konfigurationsprüfung

Prüfen Sie den Zustand Ready des HealthCheck-Objekts, um sicherzustellen, dass die Konfiguration korrekt ist. Diese Bedingung weist auf Konfigurationsfehler hin. Prüfen Sie außerdem, ob die Felder die erforderlichen HealthCheck-Einstellungen korrekt widerspiegeln.

Weitere Nutzungshinweise

Die folgenden Abschnitte enthalten zusätzliche Hinweise zur Verwendung von Systemdiagnosen in Google Cloud.

Zertifikate und Systemdiagnosen

Bei Protokollen wie HTTPS, die Zertifikate auf Ihren Backends vorschreiben,

  • Zertifikate können selbst signiert oder von einer Zertifizierungsstelle ausgestellt sein.
  • Abgelaufene oder zukünftige Zertifikate sind zulässig.

Header

Wenn Sie Systemdiagnosen für HTTP- oder HTTPS-Protokolle konfigurieren, können Sie mit dem Flag --host einen HTTP-Host-Header angeben.

Der Load Balancer fügt die von Ihnen konfigurierten benutzerdefinierten Anfrageheader nur Clientanfragen hinzu, nicht den Systemdiagnoseprüfungen. Wenn Ihr Backend einen bestimmten Header für die Autorisierung erfordert, der im Systemdiagnosepaket fehlt, schlägt die Systemdiagnose möglicherweise fehl.

Beispiel für eine Systemdiagnose

Wenn eine Systemdiagnose mit den folgenden Parametern konfiguriert ist:

  • Intervall: 30 Sekunden
  • Zeitlimit: 5 Sekunden
  • Protokoll: HTTP
  • Fehlerschwellenwert: 2 (Standard)
  • Schwellenwert für Intaktheit: 2 (Standard)

Die Systemdiagnose funktioniert so:

  • Jeder Systemdiagnose-Prober führt folgende Schritte aus:
    1. Alle 30 Sekunden eine HTTP-Verbindung von einer Quell-IP-Adresse zur Backend-Instanz initiieren.
    2. Warten Sie bis zu fünf Sekunden auf die Rückgabe des HTTP-Statuscodes 200 (OK) (das festgelegte Erfolgskriterium für HTTP- und HTTPS-Protokolle).
  • Ein Back-End gilt als fehlerhaft, wenn mindestens ein System für die Systemdiagnoseprüfung folgende Voraussetzungen erfüllt:
    1. Es wird aufgrund einer abgelehnten Verbindung, einer Zeitüberschreitung der Verbindung oder einer Zeitüberschreitung des Sockets bei zwei aufeinanderfolgenden Prüfungen keine HTTP-200 (OK)-Antwort empfangen.
    2. Zwei aufeinanderfolgende Antworten werden empfangen, die nicht den protokollspezifischen Erfolgskriterien entsprechen.
  • Ein Backend gilt als fehlerfrei, wenn mindestens ein System für die Systemdiagnoseprüfung zwei aufeinanderfolgende Antworten empfängt, die den protokollspezifischen Erfolgskriterien entsprechen.

In diesem Beispiel initiiert jeder Prober alle 30 Sekunden eine Verbindung. Zwischen den Verbindungsversuchen eines Probers vergehen 30 Sekunden, unabhängig von der Dauer des Zeitlimits (unabhängig davon, ob die Verbindung ein Zeitlimit überschritten hat oder nicht). Das Zeitlimit muss also immer kleiner oder gleich dem Intervall sein und das Zeitlimit erhöht das Intervall nie.

Beschränkungen

  1. GDC-Systemdiagnosen werden nur für VM-Endpunkte ausgeführt.
  2. Load Balancer mit Systemdiagnosen können nicht mit Pods und VMs als gemischte Backends konfiguriert werden. Ein Load Balancer darf nur Pods oder nur VMs als Endpunkte haben. Derzeit darf ein Load Balancer nur Pods oder nur VMs als Endpunkte enthalten.
  3. Die Veränderbarkeit des Load Balancers und der zugehörigen Systemdiagnose wird noch nicht unterstützt.