Clusterbenachrichtigungen

In diesem Dokument wird beschrieben, wie in Google Kubernetes Engine (GKE) standardmäßig Clusterbenachrichtigungen in Cloud Logging (und optional in Pub/Sub) veröffentlicht werden, wenn bestimmte Ereignisse in Ihren GKE-Clustern auftreten. Diese Benachrichtigungen enthalten Informationen zu Ereignissen, die für Ihre Clusterkonfiguration relevant sind, z. B. geplante, verfügbare oder laufende Upgrades, Sicherheitsbulletins und Termine für das Ende des Supports. Informationen dazu, wie Sie diese Logs in Cloud Logging finden, finden Sie hier.

GKE veröffentlicht auch Benachrichtigungen zu diesen Ereignissen als Nachrichten in von Ihnen konfigurierten Pub/Sub-Themen. Sie können diese Benachrichtigungen über ein Pub/Sub-Abo erhalten, den Dienst von Drittanbietern einbinden und nach den Benachrichtigungstypen filtern, die Sie erhalten möchten. Weitere Informationen zum Einrichten von Clusterbenachrichtigungen mit Pub/Sub finden Sie unter Clusterbenachrichtigungen über Pub/Sub empfangen.

Zusätzlich zu Clusternachrichtigungen bietet GKE auch Benachrichtigungen für die Roll-out-Sequenzierung mit benutzerdefinierten Phasen ausschließlich in Cloud Logging.

Vorteile

Clusterbenachrichtigungen bieten folgende Vorteile:

  • Sie werden benachrichtigt, wenn Sicherheitsbulletins speziell für Ihre Cluster ausgegeben werden. Dadurch erhalten Sie genaue Risiko- und Wirkungsinformationen.
  • Sie werden benachrichtigt, wenn eine neue GKE-Version für Ihren Cluster verfügbar ist. So können Sie Tests und Qualifikationen besser planen und einen reibungslosen und prognostizierten Upgradeprozess gewährleisten. Bisher mussten Sie die GKE-Versionshinweise oder die GKE API prüfen, um zu ermitteln, wann eine neue GKE-Version veröffentlicht wurde.
  • Sie werden benachrichtigt, wenn entweder GKE oder ein Nutzer Clusterupgrades initiiert und wenn der Upgradevorgang abgeschlossen ist. Dadurch erhalten Sie einen besseren Einblick in die Hintergrundvorgänge Ihres Clusters.
  • Sie werden benachrichtigt, wenn in Ihrem Cluster eine GKE-Nebenversion ausgeführt wird, deren Supportende erreicht ist oder bevorsteht.

  • Sie können auswählen, ob Sie Cloud Logging oder Pub/Sub verwenden möchten:

    • Clusterbenachrichtigungen werden standardmäßig an Cloud Logging gesendet. Sie können alle Funktionen von Cloud Logging verwenden, einschließlich Abfragen und Anzeigen von Logs und Konfigurieren von logbasierten Benachrichtigungsrichtlinien.
    • Pub/Sub ist sehr erweiterbar, sodass Sie die Verarbeitung eingehender Benachrichtigungen flexibel gestalten können. Sie können beispielsweise Slack integrieren, um Benachrichtigungen an einen Slack-Kanal weiterzuleiten, oder Cloud Run-Funktionen initialisieren, um benutzerdefinierte Prozesse auszuführen. Wenn benutzerdefinierte Prozesse erforderlich sind, z. B. das Orchestrieren eines Staging-Vorgangs für den Produktionsworkflow zum Testen und Zertifizierung eines Upgrades, können Sie diese Workflows mithilfe der Benachrichtigung automatisch auslösen.

Benachrichtigungen zur Roll-out-Sequenzierung informieren Sie über Folgendes:

  • Der Fortschritt eines Roll-outs in einer Roll-out-Sequenz mit benutzerdefinierten Phasen. Die Benachrichtigungen informieren Sie über den Status eines Roll-outs, sodass Sie die Leistung Ihrer Cluster und Arbeitslasten überwachen und bei Bedarf Maßnahmen ergreifen können.
  • Wenn eine Roll-out-Sequenz mit benutzerdefinierten Phasen falsch konfiguriert ist, müssen Sie sie korrigieren.

Arten von Upgradebenachrichtigungen

GKE sendet die folgenden Clusterbenachrichtigungstypen:

Wenn Sie Clustermitteilungen in Cloud Logging ansehen, können Sie die Funktionen von Cloud Logging verwenden, um die Logs zu filtern. Wenn Sie Pub/Sub verwenden, können Sie die empfangenen Benachrichtigungen filtern, sodass Sie nur bei relevanten Ereignissen benachrichtigt werden.

GKE sendet die folgenden Benachrichtigungstypen für die Roll-out-Sequenzierung mit benutzerdefinierten Phasen:

SecurityBulletinEvent

Wenn GKE ein Sicherheitsbulletin ausgibt, das sich direkt auf Ihre Clusterkonfiguration oder -version bezieht, sendet GKE eine SecurityBulletinEvent-Benachrichtigung mit Informationen zur Sicherheitslücke, die Auswirkungen und gegebenenfalls Maßnahmen, die Sie ergreifen können.

UpgradeAvailableEvent

Wenn eine neue Version in einer Release-Version verfügbar ist, sendet GKE eine UpgradeAvailableEvent-Benachrichtigung an Cluster in dieser Release-Version, um die Cluster zu informieren, dass jetzt eine neue Version verfügbar ist. Diese Benachrichtigung informiert Sie eine Woche im Voraus über Patchversionen und mindestens zwei bis vier Wochen im Voraus über Nebenversionen (je nach Kanal). Weitere Informationen finden Sie unter In einem Kanal verfügbare Versionen.

Bei Clustern, die sich nicht auf einer Release-Version befinden, sendet GKE UpgradeAvailableEvent-Benachrichtigungen für neue Versionen, auf die Cluster aktualisiert werden können (Patches auf der aktuellen Nebenversion und der nächsten Nebenversion).

Wenn Sie Windows Server-Knotenpools verwenden, werden Informationen zur Windows-Version als Teil der Benachrichtigung UpgradeAvailableEvent gesendet.

UpgradeEvent

Wenn Sie oder GKE ein Upgrade initiieren, sendet GKE eine UpgradeEvent-Benachrichtigung, damit Sie wissen, dass ein Upgrade begonnen hat. Im Idealfall sollten Sie den Benachrichtigungstyp UpgradeAvailableEvent verwenden, um das bevorstehende Upgrade zu kennen, damit Sie entweder ein Upgrade im Voraus ausführen oder erforderliche Maßnahmen ergreifen können, z. B. die Einrichtung von Wartungsfenstern.

Die UpgradeEvent-Benachrichtigung wird zu Beginn des Upgradevorgangs gesendet. Die Vorgangs-ID wird in der Nachricht übergeben.

Bei zweistufigen Nebenupgrades der Steuerungsebene mit Rollback-Sicherheit sendet GKE diese Benachrichtigung, wenn das binäre Upgrade und das Upgrade der emulierten Version gestartet werden. Weitere Informationen zu den wichtigsten Details, die GKE bereitstellt, finden Sie unter Inhalt der Benachrichtigung für zweistufige Upgrades.

UpgradeInfoEvent

GKE sendet eine UpgradeInfoEvent-Benachrichtigung für verschiedene Ereignistypen, die in den nächsten Abschnitten beschrieben werden.

Weitere Informationen zum Filtern nach einem bestimmten Typ von UpgradeInfoEvent finden Sie unter UpgradeInfoEvent-Clusterbenachrichtigungen filtern.

Geplante Clusterupgrades

Wenn GKE ein Clusterupgrade plant, sendet GKE Ihnen 72 bis 96 Stunden im Voraus eine Benachrichtigung. Weitere Informationen zum Aktivieren geplanter Clusterupgrades finden Sie unter Benachrichtigungen zu geplanten Clusterupgrades erhalten.

Upgradevorgang ist abgeschlossen

Wenn GKE den Vorgang zum automatischen oder manuellen Upgrade der Steuerungsebene oder der Knoten eines Clusters abgeschlossen hat, sendet GKE eine Benachrichtigung, um Sie darüber zu informieren, dass der Vorgang abgeschlossen ist. Der Vorgang wird mit einem der folgenden Status abgeschlossen:

  • SUCCEEDED: Die Steuerungsebene oder die Knoten wurden von GKE erfolgreich aktualisiert.
  • FAILED: GKE konnte die Steuerungsebene oder die Knoten nicht aktualisieren.
  • CANCELED: Die GKE hat den Upgradevorgang aus technischen oder geschäftlichen Gründen abgebrochen oder Sie haben den Upgradevorgang abgebrochen.

Verwenden Sie die Benachrichtigung, um den Erfolg eines Upgradevorgangs zu bestätigen.

Inhalt der Benachrichtigung zu zweistufigen Upgrades

Bei zweistufigen Nebenversionsupgrades der Steuerungsebene mit Rollback-Sicherheit sendet GKE diese Benachrichtigung einmal nach Abschluss des binären Upgrades, also wenn die Übergangszeit beginnt, und noch einmal nach Abschluss des emulierten Versionsupgrades. Diese Benachrichtigungen enthalten je nach Status des zweistufigen Upgrades die folgenden Informationen:

  • Die erste Version
  • Die Zielversion
  • Die erste emulierte Version
  • Die emulierte Zielversion

Nebenversion, deren Supportzeitraum abgelaufen ist oder bald abläuft

Wenn in Ihrem Cluster eine GKE-Nebenversion ausgeführt wird, die sich dem Ende des Standardsupports oder dem Ende des erweiterten Supports nähert oder einen dieser Meilensteine erreicht hat, sendet GKE Benachrichtigungen, dass Sie die Steuerungsebene oder die Knoten Ihres Clusters auf die nächste unterstützte Nebenversion aktualisieren müssen. Wenn Sie eine unterstützte Nebenversion verwenden, erhalten Sie weiterhin Sicherheitspatches, Fehlerkorrekturen und Support. GKE sendet 30 Tage vor dem Ende des Supports eine Benachrichtigung und eine weitere Benachrichtigung am Ende des Supports, wenn auf Ihrem Cluster weiterhin die Nebenversion ausgeführt wird.

GKE sendet Benachrichtigungen auf Clusterebene, obwohl mehrere Komponenten Ihres Clusters betroffen sein können und Ihr Cluster gleichzeitig verschiedene Nebenversionen ausführen kann. Wenn die Nebenversion das Ende des Standardsupports erreicht und Sie Zeit benötigen, um sich auf ein Upgrade auf eine unterstützte Version vorzubereiten, können Sie zur erweiterten Release-Version wechseln, um Langzeitsupport zu erhalten. Andernfalls plant GKE automatische Upgrades am Ende des Supports. Diese Benachrichtigungen sollen Ihnen helfen, sich auf die Durchsetzung dieser Richtlinien zum Ende des Supports vorzubereiten.

Eine Benachrichtigung enthält die folgenden Details:

  • Der betroffene Cluster.
  • Die aktuelle Version, die nicht mehr oder demnächst nicht mehr unterstützt wird.
  • Das Enddatum des Supports.

Weitere Informationen zum Zeitplan für die Unterstützung von GKE-Nebenversionen finden Sie unter Lebenszyklus von GKE-Nebenversionen.

Neue Patchversionen werden während des erweiterten Supports auf einen neuen Container-Optimized OS-Meilenstein umgestellt

Wenn Ihr Cluster während des erweiterten Supportzeitraums für die Release-Version „Erweitert“ registriert ist und der von der GKE-Nebenversion verwendete Container-Optimized OS-Meilenstein vor der Nebenversion das Ende des Supports erreicht, sendet GKE eine Clusterbenachrichtigung. Die GKE sendet diese Benachrichtigung, wenn die erste Patchversion, die den neuen Meilenstein verwendet, im erweiterten Kanal verfügbar ist.

Diese Benachrichtigung enthält die folgenden Details:

  • Der betroffene Cluster.
  • Die Patchversion, die den neuen Meilenstein verwendet.
  • Die vorhandenen und neuen Meilensteine.
  • Wie GKE automatische Patchupgrades für die Knoten pausiert.

Die Patchversion, die den neuen Meilenstein verwendet, wird schließlich zum Ziel für das automatische Upgrade des Clusters und automatische Knoten-Upgrades werden pausiert. Clusteradministratoren müssen entscheiden, welche der folgenden nächsten Schritte sie ausführen möchten:

  • Aktualisieren Sie die Clusterknoten manuell auf die nächste Patchversion, die den nächsten Container-Optimized OS-Meilenstein verwendet.
  • Führen Sie ein manuelles Upgrade des Clusters auf die nächste Nebenversion durch.
  • Verzichten Sie auf Patchupgrades, bis die GKE den Cluster gegen Ende des erweiterten Supports auf die nächste Nebenversion aktualisiert.

Weitere Informationen finden Sie unter Der Container-Optimized OS-Meilenstein erreicht das Ende des Supports vor dem Ende des erweiterten Supports für die Nebenversion.

Störende Ereignisse während eines Knotenpool-Upgrades

Wenn in einem Knotenpool während eines Knotenpool-Upgrades bestimmte Arten von störenden Ereignissen auftreten, sendet GKE eine Benachrichtigung, um Sie über dieses Ereignis zu informieren.

Die GKE sendet eine Clusterbenachrichtigung für die folgenden Arten von störenden Ereignissen:

Diese Benachrichtigung enthält die folgenden Details:

  • Der Knoten, der von diesem Unterbrechungsereignis betroffen ist.
  • Die Pods, die von diesem Störungsereignis betroffen sind.
  • Der Vorgang, der den Node-Drain ausgelöst hat.
  • Das PDB-Zeitlimit, bevor die Pods endgültig gelöscht wurden.

RolloutEvent

GKE sendet Benachrichtigungen, wenn die folgenden Ereignisse für die Einführung einer GKE-Version in einer Roll-out-Sequenz mit benutzerdefinierten Phasen auftreten:

  • ROLLOUT_CREATED: Ein neuer Roll-out wurde erstellt.
  • ROLLOUT_STAGE_TRANSITION: Eine Phase im Roll-out ist in einen neuen Status übergegangen.
  • ROLLOUT_BLOCKED: Der Roll-out wird blockiert, weil eine Steuerungsebene oder ein Knotenpool nicht für ein Upgrade infrage kommt.
  • ROLLOUT_AUTO_PAUSED: Das Roll-out wurde von der GKE automatisch pausiert.
  • ROLLOUT_AUTO_RESUMED: Das Roll-out wurde nach einer Pause automatisch fortgesetzt.
  • ROLLOUT_CANCELLATION_WARNING: Das Roll-out wurde zu lange pausiert und wird in sieben Tagen automatisch abgebrochen, wenn es nicht fortgesetzt wird.
  • ROLLOUT_AUTO_CANCELLED: Das Roll-out wurde von GKE automatisch abgebrochen.
  • ROLLOUT_COMPLETED: Das Roll-out wurde erfolgreich abgeschlossen.

RolloutSequenceEvent

Die GKE sendet Benachrichtigungen für die folgenden Situationen für eine Roll-out-Sequenz mit benutzerdefinierten Phasen:

  • SEQUENCE_MISCONFIGURED: Die Roll-out-Sequenz ist falsch konfiguriert. Das bedeutet, dass die GKE mit der aktuellen Konfiguration keine Upgrades in der Sequenz durchführen kann.
  • SEQUENCE_DEACTIVATION_WARNING: Eine Warnung, dass die GKE die Roll-out-Sequenz deaktiviert, wenn die Fehlkonfiguration nicht behoben wird.

Clusterbenachrichtigungen in Cloud Logging ansehen

Die folgende Anleitung gilt sowohl für Clusterbenachrichtigungen als auch für Benachrichtigungen zur Roll-out-Sequenzierung.

Informationen zum Aufrufen von Logs für GKE-Cluster finden Sie unter Auf Logs zugreifen.

Wenn Sie diese Logs nicht speichern möchten, können Sie einen Ausschlussfilter konfigurieren.

Verwenden Sie den folgenden Filter, um Logs in Cloud Logging aufzurufen und alle Arten von Clusternachrichtigungen zu sehen:

logName=projects/PROJECT_ID/logs/container.googleapis.com%2Fnotifications

Ersetzen Sie dabei PROJECT_ID durch die ID Ihres Projekts in Google Cloud .

Rufen Sie Logs mit dem folgenden Filter auf, um einen bestimmten Clusterbenachrichtigungstyp wie UpgradeEvent zu sehen:

jsonPayload.@type=type.googleapis.com/google.container.v1beta1.NOTIFICATION_TYPE

Ersetzen Sie NOTIFICATION_TYPE durch den Benachrichtigungstyp für Cluster für die Logs, die Sie aufrufen möchten.

UpgradeInfoEvent-Clusterbenachrichtigungen filtern

Rufen Sie Logs mit dem folgenden Filter auf, um eine bestimmte UpgradeInfoEvent zu sehen, z. B. die Benachrichtigung, dass ein Upgradevorgang abgeschlossen ist:

jsonPayload.@type=type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent
jsonPayload.eventType=EVENT_TYPE

Ersetzen Sie EVENT_TYPE durch einen der folgenden Werte:

Benachrichtigungen an Pub/Sub filtern

Sie können Clusterbenachrichtigungen filtern, damit Sie in Pub/Sub nur die gewünschten Benachrichtigungen erhalten. Sie können die Filterung für Benachrichtigungen an Pub/Sub auf eine der folgenden Arten anwenden:

Informationen zum Aufrufen und Filtern von Benachrichtigungen in Cloud Logging finden Sie unter Clusterbenachrichtigungen in Cloud Logging ansehen.

Benachrichtigungen an Pub/Sub in GKE filtern

Sie können die Filterung für Pub/Sub für einen oder mehrere verfügbare Benachrichtigungstypen einrichten, wenn Sie Clusterbenachrichtigungen aktivieren. Geben Sie dazu Werte für filter im Flag --notification-config an. filter verwendet eine durch einen senkrechten Strich ( | ) getrennte Liste der Benachrichtigungstypen, die Sie erhalten möchten.

Wenn Sie beispielsweise filter="UpgradeEvent|SecurityBulletinEvent" angeben, wird GKE angewiesen, Benachrichtigungen nur für die Benachrichtigungstypen UpgradeEvent und SecurityBulletinEvent zu senden.

Das Filtern von Benachrichtigungen mit filter bietet folgende Vorteile:

  • Einfacher zu verwenden, da Sie nach dem Benachrichtigungstyp filtern, ohne eine bestimmte Syntax zu verwenden.
  • Ausgefilterte Benachrichtigungen werden nie an Pub/Sub gesendet. Daher werden Ihnen keine Gebühren für nicht zugestellte Nachrichten berechnet.
  • Sie können die Filterkonfiguration jederzeit bearbeiten.

Eine Anleitung zum Filtern von Benachrichtigungen in GKE finden Sie unter Clusterbenachrichtigungen über Pub/Sub erhalten.

Das Filtern von Benachrichtigungen in GKE hat keine Auswirkungen darauf, welche Logs in Cloud Logging angezeigt werden.

Benachrichtigungen in Pub/Sub filtern

Pub/Sub unterstützt das Filtern von Nachrichten in Ihrem Abo mithilfe einer Filtersyntax. Wenn Sie diese Methode verwenden, liefert GKE alle Benachrichtigungstypen an Ihr Pub/Sub-Thema. Pub/Sub filtert Nachrichten basierend auf Ihrer Abokonfiguration und stellt die Nachrichten bereit, die Sie erhalten möchten.

Sie können beispielsweise mit der folgenden Syntax in Ihrem Abo nach UpgradeEvent- und UpgradeAvailableEvent-Benachrichtigungen filtern:

attributes.type_url = "type.googleapis.com/google.container.v1beta1.UpgradeEvent" OR "type.googleapis.com/google.container.v1beta1.UpgradeAvailableEvent"

Für nicht zugestellte Nachrichten fallen weiterhin Gebühren an, die von Ihrem Abo gefiltert wurden. Sie können die Filter nach der Konfiguration des Abos nicht mehr ändern. Die Filtersyntax ist jedoch erweiterbarer als das Filtern in GKE.

Weitere Informationen zum Filtern von Pub/Sub-Abos finden Sie unter Nachrichten filtern.

Benachrichtigungen zu Clustern in Cloud Logging

Sie können logbasierte Benachrichtigungen konfigurieren, um Benachrichtigungen zu erhalten, wenn bestimmte Clusterereignisse auftreten. Im folgenden Abschnitt finden Sie ein einfaches Beispiel für das Einrichten einer logbasierten Benachrichtigung. Weitere Beispiele finden Sie im Repository mit Beispielen für Monitoring-Dashboards.

Logbasierte Benachrichtigung erstellen

So erstellen Sie eine Benachrichtigung für eine bestimmte Art der Verbraucherinformation: In den folgenden Schritten wird UpgradeEvent als Beispiel verwendet.

  1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

  2. Geben Sie im Feld Abfrage die folgende Abfrage ein, um nach der ausgewählten Art der Verbraucherinformation zu filtern:

    resource.type="RESOURCE_TYPE"
log_id("container.googleapis.com/notifications")
jsonPayload.@type="type.googleapis.com/google.container.v1beta1.NOTIFICATION_TYPE"

    Ersetzen Sie Folgendes:

    • RESOURCE_TYPE: der Ressourcentyp, nach dem Sie filtern möchten, z. B. gke_cluster ODER gke_nodepool oder eine Kombination.
    • NOTIFICATION_TYPE: Der Cluster-Benachrichtigungstyp, für den Sie eine Benachrichtigung erhalten möchten, z. B. UpgradeEvent.

    Für einige Benachrichtigungstypen ist eine zusätzliche Filterung erforderlich. Wenn Sie beispielsweise nach einem bestimmten Typ von UpgradeInfoEvent filtern möchten, fügen Sie Ihrer Abfrage den Filter jsonPayload.eventType hinzu. In der folgenden Beispielabfrage wird nach UpgradeInfoEvent gefiltert, wobei der Ereignistyp UPGRADE_LIFECYCLE ist:

    resource.type="RESOURCE_TYPE"
log_id("container.googleapis.com/notifications")
jsonPayload.@type="type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent"
jsonPayload.eventType="UPGRADE_LIFECYCLE"

    Weitere Informationen zum Filtern von UpgradeInfoEvent finden Sie unter UpgradeInfoEvent-Clusterbenachrichtigungen filtern.

  3. Klicken Sie im Menü Aktionen auf Logbenachrichtigung erstellen.

  4. Geben Sie auf der Seite Benachrichtigungsdetails einen Namen für die Benachrichtigungsrichtlinie ein und klicken Sie auf Weiter.

    Im Abschnitt Logeinträge für Benachrichtigungen definieren ist Ihre Abfrage bereits vorab ausgefüllt.

  5. Klicken Sie im Abschnitt Loglabels extrahieren auf Label hinzufügen. Durch das Extrahieren von Log-Labels werden Ihre Benachrichtigungen informativer. Bei einem UpgradeEvent können Sie beispielsweise die aktuelle und die Zielversion eines Upgrades angeben, indem Sie die folgenden Labels hinzufügen:

    • CurrentVersion: jsonPayload.currentVersion
    • TargetVersion: jsonPayload.targetVersion

  6. Klicken Sie auf Weiter.

  7. Konfigurieren Sie die Benachrichtigungshäufigkeit und die Dauer für das automatische Schließen und klicken Sie dann auf Weiter.

  8. Wählen Sie im Bereich Wer soll benachrichtigt werden? die Benachrichtigungskanäle aus, über die Sie die Benachrichtigungen erhalten möchten, und klicken Sie dann auf Speichern.

Nachdem Sie die Benachrichtigung konfiguriert haben, enthalten Benachrichtigungen für ein UpgradeEvent die Labels CurrentVersion und TargetVersion, die wertvollen Kontext direkt in der Benachrichtigung bereitstellen.

Pub/Sub-Nachrichten verarbeiten

Pub/Sub-Nachrichten enthalten zwei Felder: data (String) und attributes (String-zu-String-Zuordnung).

Bei GKE-Benachrichtigungen enthält das Feld data menschenlesbare Informationen. Das Feld attributes enthält allgemeine Benachrichtigungsinformationen wie den Benachrichtigungstyp, Ihre Projekt-ID, den Clusternamen und den Clusterstandort. Das Feld attributes.payload ist ein JSON-parsbarer String, der bestimmte Benachrichtigungsinformationen enthält, z. B. die Details eines Sicherheitsbulletins.

Benachrichtigungen enthalten immer die folgenden Attribute:

Attribut Beschreibung Beispiel
project_id Die Projektnummer des Clusters. 123456789
cluster_location Der Standort des Clusters. us-central1-c
cluster_name Der Name des Clusters. example-cluster
type_url Die Art der Benachrichtigung. type.googleapis.com/google.container.v1beta1.UpgradeEvent
payload Ein JSON-parsbarer String mit benachrichtigungsspezifischen Informationen. 
{ "resourceType":"MASTER",
  "operation":"operation-1595889094437-87b7254a",
  "operationStartTime":"2020-07-27T22:31:34.437652293Z",
  "currentVersion":"1.15.12-gke.2",
  "targetVersion":"1.15.12-gke.9"}

GKE sendet immer beta-Benachrichtigungstypen. Sie können jedoch die Nutzlast parsen, damit der entsprechende GA-Benachrichtigungstyp angezeigt wird, sofern verfügbar.

Beispiele für Clusterbenachrichtigungen

Zusätzlich zum Text im Feld data hat jede Nachricht, die GKE an Cloud Logging oder Pub/Sub sendet, bestimmte Werte in den Feldern attributes.type_url und attributes.payload. Die folgenden Tabellen enthalten Beispiele für die Informationen, die Sie für jeden Benachrichtigungstyp erhalten können:

SecurityBulletinEvent

Die Ausgabe sieht für eine SecurityBulletinEvent-Nachricht in etwa so aus:

Attribute
type_url type.googleapis.com/google.container.v1beta1.SecurityBulletinEvent
payload 
{    "resourceTypeAffected":"RESOURCE_TYPE_CONTROLPLANE",
         "bulletinId":"GCP-2021-001",
         "cveIds":[
            "CVE-2021-3156"
         ],
         "severity":"Medium",
         "briefDescription":"A vulnerability was recently discovered in the Linux utility sudo, described in CVE-2021-3156, that may allow an attacker with unprivileged local shell access on a system with sudo installed to escalate their privileges to root on the system.",
         "affectedSupportedMinors":["1.18", "1.19"],
         "patchedVersions":["1.18.9-gke.1900", "1.19.9-gke.1900"],
         "suggestedUpgradeTarget":"1.19.9-gke.1900",
         "bulletinUri":"https://docs.cloud.google.com/kubernetes-engine/security-bulletins#gcp-2021-001"
      }

UpgradeAvailableEvent

Die Ausgabe sieht für eine UpgradeAvailableEvent-Nachricht in etwa so aus:

Attribute
type_url type.googleapis.com/google.container.v1beta1.UpgradeAvailableEvent
payload 
{ "version":"1.17.15-gke.800",
  "resourceType":"MASTER",
  "releaseChannel":{"channel":"RAPID"},
  "windowsVersions": [
    {
      "imageType": "WINDOWS_SAC",
      "osVersion": "10.0.18363.1198",
      "supportEndDate": {
        "day": 10,
        "month": 5,
        "year": 2022
      }
    },
    {
      "imageType": "WINDOWS_LTSC",
      "osVersion": "10.0.17763.1577",
      "supportEndDate": {
        "day": 9,
        "month": 1,
        "year": 2024
      }
    }
  ]
}

UpgradeEvent

Die Ausgabe sieht für eine UpgradeEvent-Nachricht in etwa so aus:

Attribute
type_url type.googleapis.com/google.container.v1beta1.UpgradeEvent
payload 
{ "resourceType":"MASTER",
  "operation":"operation-1595889094437-87b7254a",
  "operationStartTime":"2020-07-27T22:31:34.437652293Z",
  "currentVersion":"1.15.12-gke.2",
  "targetVersion":"1.15.12-gke.9"}

Diese Ausgabe stellt eine Benachrichtigung für ein einstufiges Upgrade der Steuerungsebene dar. Bei zweistufigen Upgrades enthält die Benachrichtigung andere Informationen. Weitere Informationen zu den verschiedenen Arten von Upgrades der Steuerungsebene finden Sie unter Upgrade der Steuerungsebene des Clusters.

UpgradeInfoEvent

Die Ausgabe sieht in etwa so aus wie die folgende UpgradeInfoEvent-Nachricht, die angezeigt wird, wenn ein Upgradevorgang abgeschlossen ist, z. B. für ein Knotenpool-Upgrade:

Attribute
type_url type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent
payload 
{ "currentVersion":"1.31.1-gke.1846000",
  "endTime":"2024-11-06T17:12:54.111640650Z",
  "operation":"operation-1730912205658-de2f88a8-6290-4718-b2c1-fb19611060b8",
  "resource":"projects/PROJECT_ID/locations/CLUSTER_LOCATION/clusters/CLUSTER_NAME/nodePools/NODE_POOL_NAME",
  "resourceType":"NODE_POOL"
  "startTime":"2024-11-06T16:56:45.658321844Z",
  "state":"SUCCEEDED",
  "targetVersion":"1.31.1-gke.2105000"}

Diese Ausgabe unterscheidet sich von Benachrichtigungen für Upgrades der Steuerungsebene, bei denen die Meldungen für eine Nebenversion am oder kurz vor dem Ende des Supports, wenn neue Patchversionen während des erweiterten Supports zu neuen Container-Optimized OS-Meilensteinen werden oder für störende Ereignisse während eines Knotenpool-Upgrades ausgegeben werden.

Benachrichtigung zu geplanten Clusterupgrades

Wenn ein Cluster-Upgrade geplant ist und Benachrichtigungen für geplante Upgrades aktiviert sind, sendet GKE eine UpgradeInfoEvent-Ausgabe, die der folgenden für ein geplantes Upgrade der Steuerungsebene ähnelt:

Attribute
type_url type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent
payload 
{
  "insertId": "[...]",
  "jsonPayload": {
    "description": "Your cluster control plane will be upgraded to 1.32.9-gke.1239000 after 2025-12-13 12:46 UTC",
    "startTime": "2025-12-13T12:46:37.380970854Z",
    "targetVersion": "1.32.9-gke.1239000",
    "@type": "type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent",
    "currentVersion": "1.31.14-gke.1081000",
    "eventType": "UPGRADE_LIFECYCLE",
    "state": "SCHEDULED",
    "resourceType": "MASTER"
  },
  "resource": {
    "type": "gke_cluster",
    "labels": {
      "cluster_name": "CLUSTER_NAME",
      "location": "LOCATION",
      "project_id": "PROJECT_ID"
    }
  },
  "timestamp": "2025-12-10T12:46:37.989407414Z",
  "severity": "NOTICE",
  "logName": "projects/PROJECT_ID/logs/container.googleapis.com%2Fnotifications",
  "receiveTimestamp": "2025-12-10T12:46:38.007312354Z"
}

GKE sendet für geplante Knotenupgrades eine Ausgabemeldung ähnlich der folgenden:

Attribute
type_url type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent
payload 
{
  "insertId": "[...]",
  "jsonPayload": {
    "description": "Your cluster node pools will be upgraded to 1.32.9-gke.1239000 (or latest target patch) after 2025-12-13 12:46 UTC: NODE_POOL_1, NODE_POOL_2, [...] and 23 more.",
    "startTime": "2025-12-13T12:46:37.380970854Z",
    "targetVersion": "1.32.9-gke.1239000",
    "@type": "type.googleapis.com/google.container.v1beta1.UpgradeInfoEvent",
    "currentVersion": "1.31.14-gke.1081000",
    "eventType": "UPGRADE_LIFECYCLE",
    "state": "SCHEDULED",
    "resource": "projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_NAME/nodePools/NODE_POOL_1",
    "resourceType": "NODE_POOL"
  },
  "resource": {
    "type": "gke_nodepool",
    "labels": {
      "cluster_name": "CLUSTER_NAME",
      "location": "LOCATION",
      "nodepool_name": "NODE_POOL_NAME",
      "project_id": "PROJECT_ID"
    }
  },
  "timestamp": "2025-12-10T12:46:37.989407414Z",
  "severity": "NOTICE",
  "logName": "projects/PROJECT_ID/logs/container.googleapis.com%2Fnotifications",
  "receiveTimestamp": "2025-12-10T12:46:38.007312354Z"
}

Bei geplanten Knotenupgrades, die nach dem Ziel des automatischen Upgrades gruppiert sind, listet GKE bis zu 10 Knotenpools alphabetisch auf. Detaillierte Informationen werden nur für den ersten Knotenpool bereitgestellt. Wenn mehr als 10 Knotenpools geplant sind, zeigt GKE die Anzahl der verbleibenden nicht aufgeführten Pools an (z. B. 33 Upgrades insgesamt in diesem Beispiel).

Nächste Schritte