VM-Erweiterungen überwachen

In diesem Dokument wird beschrieben, wie Sie VM-Erweiterungen, die von VM Extension Manager auf Ihren Compute Engine-Instanzen verwaltet werden, mit Cloud Monitoring überwachen. Durch das Monitoring des Zustands und des Ressourcenverbrauchs von Erweiterungen können Sie die CPU- und Arbeitsspeichernutzung im Blick behalten und Installations- oder Laufzeitfehler in Ihrer VM-Flotte erkennen.

In diesem Dokument erfahren Sie, wie Sie die folgenden Aufgaben ausführen:

• Verfügbare Messwerte für VM-Erweiterungen prüfen
• Benutzerdefinierte Monitoring-Dashboards erstellen
• Benachrichtigungsrichtlinien einrichten

Hinweis

• 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. Zum Ausführen von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei der Compute Engine authentifizieren:

  Wählen Sie den Tab für die gewünschte Verwendung der Beispiele auf dieser Seite aus:

  Console

  Wenn Sie über die Google Cloud Console auf Google Cloud -Dienste und -APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.

  gcloud

  1. Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an. Nach der Anmeldung initialisieren Sie die Google Cloud CLI mit dem folgenden Befehl:

     gcloud init

     Hinweis: Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die aktuelle Version haben, indem Sie gcloud components update ausführen.
• Legen Sie eine Standardregion und -zone fest.

REST

Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an.

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

Hinweis

Bevor Sie Ihre Erweiterungen überwachen, müssen die folgenden Voraussetzungen erfüllt sein:

• VM-Erweiterungen installieren, indem Sie Erweiterungsrichtlinien erstellen.
• Grundlagen zum VM Extension Manager
• Sehen Sie sich die Aufbewahrungsdauer für Monitoring und die Preise für Monitoring an.

Erforderliche IAM-Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Überwachen von Messwerten, Erstellen von Dashboards und Konfigurieren von Benachrichtigungsrichtlinien benötigen:

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Überwachen von Messwerten, Erstellen von Dashboards und Konfigurieren von Benachrichtigungsrichtlinien benötigen:

• Zum Aufrufen von Messwerten und Dashboards: Monitoring-Betrachter (roles/monitoring.viewer) für das Projekt
• Zum Erstellen und Verwalten von Dashboards und Benachrichtigungsrichtlinien: Monitoring-Bearbeiter (roles/monitoring.editor) für das Projekt

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

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Überwachen von Messwerten, Erstellen von Dashboards und Konfigurieren von Benachrichtigungsrichtlinien erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Messwerte zu überwachen, Dashboards zu erstellen und Benachrichtigungsrichtlinien zu konfigurieren:

• Zum Aufrufen von Dashboards: monitoring.dashboards.get für das Projekt
• Zum Erstellen von Dashboards: monitoring.dashboards.create für das Projekt
• Zum Einrichten von Benachrichtigungen: monitoring.alertPolicies.create für das Projekt

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

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

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Verfügbare Messwerte für VM-Erweiterungen

Die folgenden Messwerte sind in Monitoring verfügbar, um Ihre VM-Erweiterungen zu überwachen:

Messwertname	Messwerttyp	Beschreibung
Status der Erzwingung von VM-Erweiterungen	compute.googleapis.com/vm_extensions/extension/enforcement_status	Der Erzwingungsstatus einer Compute Engine-VM-Erweiterung. Die Labels sind extension_name und status. Eine Liste der Erweiterungsnamen finden Sie unter Unterstützte Erweiterungen. Mögliche Werte für status: ENFORCEMENT_STATE_UNSPECIFIED INSTALLING INSTALL_FAILED INSTALLED ROLLING_BACK ROLLBACK_FAILED ROLLED_BACK INCOMPATIBLE REMOVING SERVICE_DISABLED APPLYING_CONFIG
Status der VM-Erweiterung	compute.googleapis.com/vm_extensions/extension/health_status	Der Integritätsstatus einer VM-Erweiterung. Die Labels sind extension_name und status. Eine Liste der Erweiterungsnamen finden Sie unter Unterstützte Erweiterungen. Mögliche Werte für status: HEALTH_STATUS_UNSPECIFIED STARTING RUNNING STOPPING STOPPED CRASHED
Maximale CPU-Auslastung der VM-Erweiterung	compute.googleapis.com/vm_extensions/extension/cpu/max_usage	Die maximale CPU-Zeit, die die VM-Erweiterung verwendet, ausgedrückt als Prozentsatz.
Maximal verwendete Byte des VM-Erweiterungsspeichers	compute.googleapis.com/vm_extensions/extension/memory/used_bytes	Der maximale Arbeitsspeicher, den die VM-Erweiterung verwendet, in Byte.

Benutzerdefinierte Monitoring-Dashboards erstellen

Sie können Monitoring-Dashboards mit den wichtigsten VM-Erweiterungsdiagrammen für Ihren Anwendungsfall erstellen. So fügen Sie dem Dashboard ein Diagramm hinzu:

1. Wählen Sie in der Google Cloud Console Monitoring aus:

   Zu Monitoring

2. Wählen Sie im Navigationsbereich die Option Dashboards aus.
3. Klicken Sie auf Dashboard erstellen.
4. Klicken Sie auf Widget hinzufügen.
5. Wählen Sie im Fenster Widget hinzufügen unter Daten die Option Messwert aus.
6. Maximieren Sie zum Auswählen eines Messwerts das Menü Messwert auswählen und führen Sie die folgenden Schritte aus:
   1. Wählen Sie für Aktive Ressourcen die Option VM-Instanz aus.
   2. Wählen Sie für Messwertkategorie die Option Vm_extensions aus.
   3. Wählen Sie unter Messwert einen Messwert aus, z. B. VM-Erweiterungs-Integritätsstatus. Eine Liste der verfügbaren Messwerte finden Sie unter Verfügbare Messwerte für VM-Erweiterungen.
   4. Klicken Sie auf Übernehmen.

Sie können dem Dashboard beliebig viele Diagramme hinzufügen. Weitere Informationen finden Sie unter Benutzerdefinierte Dashboards erstellen und verwalten.

Benachrichtigungsrichtlinien einrichten

Mit Monitoring können Sie Benachrichtigungen erstellen und Benachrichtigungen erhalten, wenn ein Messwert einen bestimmten Grenzwert überschreitet. Sie können beispielsweise eine Benachrichtigung erhalten, wenn sich der Systemstatus einer Erweiterung in CRASHED ändert.

So erstellen Sie eine Benachrichtigungsrichtlinie:

1. Wählen Sie in der Google Cloud Console Monitoring aus.

   Zu Monitoring

2. Wählen Sie im Navigationsbereich die Option Benachrichtigungen aus.
3. Klicken Sie auf Richtlinie erstellen.
4. Konfigurieren Sie auf der Seite Benachrichtigungsrichtlinie erstellen die Benachrichtigungsbedingung. Führen Sie dazu die folgenden Schritte aus:
   1. Maximieren Sie zum Auswählen eines Messwerts das Menü Messwert auswählen und führen Sie die folgenden Schritte aus:
      1. Wählen Sie für Aktive Ressourcen die Option VM-Instanz aus.
      2. Wählen Sie für Messwertkategorie die Option Vm_extensions aus.
      3. Wählen Sie für Messwert einen Messwert aus, z. B. VM Extension Enforcement Status. Eine Liste der verfügbaren Messwerte finden Sie unter Verfügbare Messwerte für VM-Erweiterungen.
      4. Klicken Sie auf Übernehmen.
   2. Konfigurieren Sie die Triggerbedingungen, z. B. ob das Label status gleich INSTALL_FAILED ist.
5. Folgen Sie der Anleitung, um Benachrichtigungskanäle hinzuzufügen und die Richtlinie zu benennen.
6. Klicken Sie auf Richtlinie erstellen.

Weitere Informationen finden Sie unter Benachrichtigungsrichtlinien erstellen.

Nächste Schritte

• Informationen zum Prüfen des Roll-out-Fortschritts und des Systemzustands der Erweiterung finden Sie unter Details und Status von VM-Erweiterungen ansehen.
• Informationen zum Abfragen von historischen Erzwingungsereignissen und zum Prüfen von Installations- oder Absturzdatensätzen in Cloud Logging finden Sie unter VM-Erweiterungslogs ansehen.
• Informationen zur Diagnose fehlgeschlagener Roll-outs, zur Prüfung laufender Gastprozesse oder zur Prüfung von Debugging-Logs des Gast-Agents finden Sie unter Fehlerbehebung bei VM-Erweiterungen.
• Informationen zum Ändern von Konfigurationseinstellungen, zum Ändern angepinnter Versionen oder zum Entfernen bereitgestellter Agents finden Sie unter VM-Erweiterungen mithilfe von Erweiterungsrichtlinien verwalten.