Hostwartungsereignis überwachen und planen

Für jede VM-Instanz oder Bare-Metal-Instanz wird eine Hostwartungsrichtlinie verwendet, um das Verhalten der Instanz während einer Wartung zu bestimmen. Bei einigen Instanzen besteht die zusätzliche Option, den Wartungsplan im Voraus einzusehen.

Auf dieser Seite wird erläutert, wie Sie ein Host-Wartungsereignis auf Compute Engine-Instanzen überwachen und planen.

Hinweise

• Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud -Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren.
  <x0A>

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

  Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen von Instanzen und zum Verwalten der Instanzwartung benötigen:

• Compute-Instanzadministrator (Version 1) (roles/compute.instanceAdmin.v1)
• Für schreibgeschützten Zugriff auf Audit-Logs für Systemereignisse: Logbetrachter (roles/logging.viewer)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Erstellen von Instanzen und Verwalten der Instanzwartung erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Beschränkungen

Sie können Benachrichtigungen für das bevorstehende Wartungsereignis einer Instanz nur aufrufen, wenn die Instanz einen Maschinentyp aus einer der folgenden Maschinenfamilien verwendet:

• Beschleunigungsoptimierte Maschinenfamilien:

  • A3

  • A2

  • G2

• Maschinenfamilien für allgemeine Zwecke:

  • C4A

  • C4

  • C3D

  • C3

• Speicheroptimierte Maschinenfamilien:

  • X4

  • M3

  • M2

  • M1

• Speicheroptimierte Maschinenfamilien:

  • Z3

Übersicht über Wartungsbenachrichtigungen

Google sendet Benachrichtigungen über bevorstehende Hostwartungen über verschiedene Methoden. Wenn sich das Wartungsfenster öffnet,führt Google Cloud automatisch eine Wartung für Ihre Instanz aus. Durch Überwachung der bevorstehenden Wartungsfenster Ihrer Instanz können Sie Ihre Arbeitslasten proaktiv darauf vorbereiten, die bevorstehende Wartung mit minimalen Unterbrechungen abzuwickeln.

Compute-Instanzen, die Benachrichtigungen zu Wartungsereignissen unterstützen, haben die folgenden Merkmale:

• Weniger Wartungsereignisse: Im Allgemeinen sollte es bei Instanzen mit wiederkehrenden Wartungsintervallen zu weniger Wartungsereignissen kommen.
• Längere Wartungsbenachrichtigung: Sie werden zu Planungszwecken weit im Voraus über Wartungsereignisse informiert.
• Überwachung und Planung: Mit Cloud Logging können Sie Ihren Wartungsplan im Blick behalten. Mit Vorfällen und Benachrichtigungen können Sie sich auf dem Laufenden halten.
• On-Demand-Wartungssteuerung: Starten Sie die Wartung während des Benachrichtigungszeitraums, um Ihre Instanzen dann zu aktualisieren, wenn es Ihrem Zeitplan entspricht.

Die Informationen zu einem anstehenden Benachrichtigungsereignis werden auf ähnliche Weise wie unten dargestellt:

upcomingMaintenance:{
    "canReschedule":True
    "latestWindowStartTime": "2024-12-01T19:00:01Z"
    "machineType":"x4-megamem-960-metal"
    "maintenanceStatus":"PENDING"
    "type":"SCHEDULED"
    "windowEndTime": "2024-12-01T22:00:00Z"
    "windowStartTime": "2024-12-01T19:00:00Z"
}

Wenn kein Wartungsereignis ansteht, wird stattdessen eine Meldung wie die folgende angezeigt:

{ "error": "no notifications have been received yet, try again later" }

Definitionen des Wartungsstatus

Die folgenden Statusdefinitionen erläutern die Antworten auf Anfragen zur Hostwartung für eine Instanz. Sie enthalten Informationen zum Wartungsereignis. Die Google Cloud CLI, REST und der Metadatenserver verwenden dieselben Antworten:

• canReschedule: gibt an, ob die Wartung während des Benachrichtigungszeitraums für diese Instanz manuell gestartet werden kann.
  • TRUE: eine vom Kunden ausgelöste Wartung kann während des Benachrichtigungszeitraums ausgeführt werden.
  • FALSE: Eine vom Kunden ausgelöste Wartung kann für diese Instanz nicht ausgeführt werden. Dies tritt häufig in dem Zeitraum auf, in dem die Instanz gewartet wird, oder wenn der Instanztyp keine On-Demand-Wartung unterstützt.
• latestWindowStartTime: die späteste Zeit, zu der das Wartungsfenster verschoben werden kann.
• machineType: Der Maschinentyp der Instanz, z. B. x4-megamem-960-metal oder c4-highmem-192.
• maintenanceStatus: Der aktuelle Status des Wartungsereignisses.
  • ONGOING: Der Wartungsvorgang wird ausgeführt.
  • PENDING: Der Wartungsvorgang ist geplant, wurde aber noch nicht gestartet.
• type: Der Typ der auszuführenden Wartung.
  • NONE: Für diese Instanz ist keine Wartung geplant.
  • SCHEDULED: Bei unterbrechender Wartung benachrichtigt Compute Engine die meisten Instanzen mindestens 7 Tage im Voraus. X4-Instanzen werden etwa 60 Tage im Voraus benachrichtigt.
  • UNSCHEDULED: Da es sich bei der Wartung um kritische Updates handelt, versucht Compute Engine, so viel Vorlaufzeit wie möglich zu bieten. Diese ist jedoch in der Regel viel kürzer als bei geplanten Wartungsereignissen.
• windowEndTime: das Ende des Zeitfensters, in dem die Wartung durchgeführt wird.
• windowStartTime: der Beginn des Zeitfensters, in dem die Wartung durchgeführt wird.

Verhalten des Wartungsstatus

Prüfen Sie beim Verwalten von Wartungen die Werte für canReschedule und maintenanceStatus. In Kombination geben diese Felder an, welche Aktionen Sie in Bezug auf die Verschiebung eines Wartungsereignisses ausführen können:

• canReschedule=True und maintenanceStatus=Pending: Sie können das Wartungsereignis für die Instanz vor dem geplanten Start manuell starten.
• canReschedule=False und maintenanceStatus=Ongoing: Die Wartung läuft und kann nicht verschoben werden.
• canReschedule=False und maintenanceStatus=Pending: Ihre Instanz unterstützt keine manuell ausgelösten Wartungsereignisse.

Wartungsbenachrichtigungen ansehen

Sie können Wartungsbenachrichtigungen abrufen, indem Sie Ihre Compute-Instanzen oder den Metadatenserver abfragen oder Cloud Logging verwenden.

Instanzen auf Benachrichtigungen zu Wartungsereignissen prüfen

Mit der Google Cloud CLI, REST oder durch Abfragen des Metadatenservers können Sie prüfen, ob für Ihre Instanz ein bevorstehendes Hostwartungsereignis geplant ist.

gcloud compute instances describe INSTANCE_NAME \
   --zone=ZONE_NAME --format="yaml(resourceStatus.upcomingMaintenance)"

  resourceStatus:
    upcomingMaintenance:
      canReschedule: true
      latestWindowStartTime: '2025-01-15T12:00:01Z'
      machineType: x4-megamem-960-metal
      maintenanceStatus: PENDING
      type: SCHEDULED
      windowEndTime: '2025-01-15T16:00:00Z'
      windowStartTime: '2025-01-15T12:00:00Z'

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME

  upcomingMaintenance:{
    "canReschedule":True
    "latestWindowStartTime": "2023-12-01T19:00:01Z"
    "machineType": "x4-megamem-960-metal"
    "maintenanceStatus":"PENDING"
    "type":"SCHEDULED"
    "windowEndTime": "2023-12-01T22:00:00Z"
    "windowStartTime": "2023-12-01T19:00:00Z"
  }

$ curl http://metadata.google.internal/computeMetadata/v1/instance/upcoming-maintenance?alt=json -H "Metadata-Flavor: Google"

Cloud Logging nach Benachrichtigungen zu Wartungsereignissen durchsuchen

Compute Engine erstellt Systemereignisse in den Cloud-Audit-Logs für eine Instanz für Wartungsereignisse. Sie können sich diese Ereignisse vor, während und nach einem Wartungsereignis mit Cloud Logging und dem Log-Explorer ansehen.

Beispiele für Wartungsbenachrichtigungen

Im Log-Explorer wird eine Benachrichtigung über ein Wartungsereignis für eine Instanz mit Werten wie den folgenden angezeigt:

• methodName: "compute.instances.upcomingMaintenance"
• metadata:
  • maintenanceStatus: "PENDING"
  • machineType: "x4-megamem-960-metal"
  • windowStartTime: "2024-07-23T20:00:00Z"

Wenn die Wartung beginnt, wird in den Logs ein neues Informationsereignis mit Werten ähnlich den folgenden angezeigt:

• methodName: "compute.instances.upcomingMaintenance"
• metadata:
  • maintenanceStatus: "ONGOING"
  • machineType: "x4-megamem-960-metal"
  • windowStartTime: "2024-07-23T20:00:00Z"

Während des Wartungsereignisses wird je nach Konfiguration der Hostwartungsrichtlinie für die Instanz eines der folgenden Systemereignisse in den Audit-Logs protokolliert:

• Bei Instanzen, die für die Verwendung der Live-Migration bei Wartungsereignissen konfiguriert sind, wird ein Systemereignis mit methodName: "compute.instances.migrateOnHostMaintenance" protokolliert.
• Bei Instanzen, die so konfiguriert sind, dass sie während Wartungsereignissen beendet werden, wird ein Systemereignis mit methodName: "compute.instances.terminateOnHostMaintenance" generiert.

Nach der Wartung wird ein neues Informationsereignis in den Audit-Logs mit Werten wie den folgenden angezeigt:

• methodName: "compute.instances.upcomingMaintenance"
• status: { message: "Maintenance window has completed for this instance. All maintenance notifications on the instance have been removed." }

Benachrichtigungen für Hostwartungsbenachrichtigungen konfigurieren

Sie können eine logbasierte Benachrichtigungsrichtlinie einrichten, um nach bestimmten Wartungsbenachrichtigungsereignissen zu suchen und Benachrichtigungen über einen Benachrichtigungschannel zu senden.

Weitere Informationen finden Sie unter Logbasierte Benachrichtigungen konfigurieren und Benachrichtigungskanäle erstellen und verwalten.

Nächste Schritte

• Host-Wartungsrichtlinie festlegen
• Live-Migrationshinweise abrufen
• Host-Wartungsereignis manuell auslösen
• Informationen zum Verwalten von logbasierten Benachrichtigungsrichtlinien mit der Google Cloud -Konsole für Monitoring oder mit der Monitoring API