Ops-Agent mithilfe von VM Extension Manager-Richtlinien installieren und verwalten

Sie können den Ops-Agent auf einer Reihe von Compute Engine-VMs in einer bestimmten Zone mithilfe von VM Extension Manager-Richtlinien installieren und verwalten. Mit diesen Richtlinien können Sie beispielsweise die folgenden Aufgaben ausführen:

  • Flottenweite Installation: Installieren Sie den Ops-Agent auf allen VMs in einer Zone oder auf einer Teilmenge von VMs, die durch Labels in einer Zone identifiziert werden.

  • Versionsverwaltung:

    • Halten Sie den Ops-Agent auf dem neuesten Stand.
    • Die Ops-Agent-Version an eine bestimmte Version anpinnen

  • Konfigurationsverwaltung: Wenden Sie eine benutzerdefinierte Konfiguration auf den Ops-Agent auf allen VMs an, die von einer Richtlinie verwaltet werden.

Mit dem VM Extension Manager erstellen Sie Richtlinien, in denen Sie angeben, welche Erweiterungen auf VMs installiert werden sollen. Der Ops-Agent ist eine der verfügbaren Erweiterungen. Mit VM Extension Manager-Richtlinien kann der Ops-Agent in Version 2.58.0 oder höher verwaltet werden, wenn der Ops-Agent mit dem VM Extension Manager installiert wurde. Mit diesen Richtlinien können keine Versionen des Ops-Agents vor Version 2.58.0, Ops-Agent-Instanzen, die auf andere Weise installiert wurden, oder eine Version des Legacy-Monitoring-Agents oder Logging-Agents verwaltet werden.

Sie können VM-Erweiterungsrichtlinien über die Google Cloud Console oder die Google Cloud CLI (gcloud) erstellen und verwalten.

Hinweise

Bevor Sie mit der Verwendung von Richtlinien für VM Extension Manager-Erweiterungen beginnen, müssen Sie Folgendes tun:

Unterstützte Betriebssysteme ansehen

Bevor Sie versuchen, den Ops-Agenten mit VM Extension Manager-Richtlinien zu verwalten, prüfen Sie, ob Ihr Zielbetriebssystem mit dem Ops-Agenten und dem VM Extension Manager kompatibel ist.

VM Extension Manager unterstützt alle Betriebssysteme, die vom Ops-Agent unterstützt werden, mit Ausnahme von SUSE Linux Enterprise Server (SLES) und Ubuntu. Weitere Informationen zu den vom Ops-Agent unterstützten Betriebssystemen finden Sie unter Betriebssysteme.

Wenn Ihr Betriebssystem sowohl vom Ops-Agent als auch vom VM Extension Manager unterstützt wird, folgen Sie der Anleitung in diesem Dokument.

Aktivieren der für die Verwendung des Ops-Agents erforderlichen APIs

Wenn Sie den Ops-Agent zum Schreiben von Logs und Messwerten verwenden möchten, müssen Sie die Cloud Logging API und die Cloud Monitoring API für Ihr Google Cloud -Projekt aktivieren.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Erforderliche Rollen für die Verwendung des Ops-Agents zuweisen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Dienstkonto zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Schreiben von Logs und Messwerten mit dem Ops-Agent benötigen:

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.

Weitere Informationen zu Rollen und zum Ops-Agent finden Sie unter Ops-Agent autorisieren.

Rollen zuweisen, die für die Verwendung von VM Extension Manager erforderlich sind

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, damit Sie die Berechtigungen zum Erstellen, Aufrufen, Ändern und Löschen von VM-Erweiterungsrichtlinien erhalten:

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, Aufrufen, Ändern und Löschen von VM-Erweiterungsrichtlinien erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um VM-Erweiterungsrichtlinien zu erstellen, anzusehen, zu ändern und zu löschen:

  • So erstellen Sie Erweiterungsrichtlinien: compute.vmExtensionPolicies.create
  • So rufen Sie Erweiterungsrichtlinien auf: compute.vmExtensionPolicies.list
  • So rufen Sie die Details einer Erweiterungsrichtlinie auf: compute.vmExtensionPolicies.get
  • So ändern Sie Erweiterungsrichtlinien: compute.vmExtensionPolicies.update
  • So löschen Sie Erweiterungsrichtlinien: compute.vmExtensionPolicies.delete

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

Weitere Informationen zu IAM-Rollen und ‑Berechtigungen in Compute Engine finden Sie unter Compute Engine-Rollen und ‑Berechtigungen.

Google Cloud CLI installieren

Sie können VM-Erweiterungsrichtlinien über die Google Cloud Console oder die Google Cloud CLI (gcloud) erstellen und verwalten. Wenn Sie gcloud verwenden möchten, müssen Sie es zuerst installieren. Führen Sie dazu die folgenden Schritte aus:

  1. Installieren Sie das Google Cloud CLI, falls noch nicht geschehen.

    Für die in diesem Dokument beschriebenen Erweiterungsrichtlinien wird die Befehlsgruppe beta verwendet.

  1. Falls noch nicht geschehen, installieren Sie die Komponente beta der gcloud CLI, indem Sie den folgenden Befehl ausführen:

    gcloud components install beta

    Prüfen Sie mit dem folgenden Befehl, ob die Komponente beta installiert ist:

    gcloud components list

    Wenn Sie die Komponente beta bereits installiert haben, prüfen Sie, ob Sie die neueste Version haben:

    gcloud components update

Alle Observability-Agents deinstallieren

Bevor Sie eine VM Extension Manager-Richtlinie zum Verwalten des Ops-Agent auf einer VM erstellen, prüfen Sie, ob auf der VM bereits Instanzen des Ops-Agent oder des Legacy-Monitoring-Agents und des Legacy-Logging-Agent vorhanden sind. Das Ausführen des Ops-Agents und der Legacy-Agents auf derselben VM kann dazu führen, dass doppelte Logs oder Konflikte bei der Messwertaufnahme entstehen.

Wenn Sie eine Erweiterungsrichtlinie verwenden, um den Ops-Agent auf einer VM zu installieren, auf der bereits ein anderer Observability-Agent installiert ist, wird der Agent durch die Richtlinie installiert. Der Agent kann jedoch nicht ausgeführt werden, da ein Konflikt erkannt wird.

Wie Sie vorhandene Agents entfernen, hängt davon ab, wie sie installiert wurden.

Ops-Agent durch Erstellen von VM-Erweiterungsrichtlinien installieren

Erstellen Sie VM-Erweiterungsrichtlinien, um den Ops-Agent automatisch auf einer Reihe von Compute Engine-VMs zu installieren und zu verwalten. Durch das Definieren einer Richtlinie können Sie dafür sorgen, dass bestimmte Erweiterungen wie der Ops-Agent auf allen VMs installiert und gewartet werden, die von Ihnen angegebene Kriterien wie VM-Labels erfüllen.

Richtlinienkonflikte und Prioritäten

VM Extension Manager weist jeder neuen Richtlinie eine Priorität zu. Niedrigere Zahlen stehen für höhere Prioritäten. Die Standardpriorität ist 1.000. Eine VM kann von mehreren Richtlinien für eine Erweiterung wie den Ops-Agenten abgedeckt werden, aber nur eine Richtlinie für die Ops-Agent-Erweiterung ist auf der VM wirksam.

VM Extension Manager verwendet Prioritäten, um Konflikte zwischen Richtlinien zu beheben, die auf eine VM angewendet werden. Weitere Informationen zum Lösungsprozess finden Sie unter Richtlinienpriorität und Konfliktlösung.

Neuesten Ops-Agent auf allen VMs in einer Zone installieren

So erstellen Sie eine Richtlinie, mit der die neueste Version des Ops-Agents auf allen VMs in einer Zone installiert und der Ops-Agent aktualisiert wird, wenn eine neue Version veröffentlicht wird:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Erweiterungsrichtlinien auf:

    Zu den Erweiterungsrichtlinien

    Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.

  2. Klicken Sie auf + Erstellen.
  3. Geben Sie im Feld Name einen Namen für die Richtlinie ein.
  4. Optional: Geben Sie im Feld Beschreibung eine Beschreibung für die Richtlinie ein.
  5. Geben Sie im Feld Priorität eine Prioritätsnummer an, um Konflikte zwischen Richtlinien zu beheben. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1.000.

  6. Wählen Sie in der Liste Zone die Zone aus, in der Sie diese Richtlinie anwenden möchten.

  7. Klicken Sie im Bereich Erweiterungen verwalten auf Erweiterung hinzufügen und gehen Sie so vor:

    1. Wählen Sie in der Liste Erweiterung die Option Google Cloud's Extension for Ops Agent aus.
    2. Lassen Sie das Feld Version leer.

  8. Klicken Sie auf Erstellen.

gcloud

Verwenden Sie den folgenden Befehl gcloud beta compute zone-vm-extension-policies create, um die Richtlinie zu erstellen:

gcloud beta compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.

Die gcloud beta compute zone-vm-extension-policies-create akzeptiert die Option --version. Wenn Sie die Option --version weglassen, wird mit der Richtlinie die neueste Version installiert und der Ops-Agent wird aktualisiert, wenn eine neue Version veröffentlicht wird.

Ops-Agent auf allen VMs in einer Zone auf eine bestimmte Version festlegen

So erstellen Sie eine Richtlinie, mit der eine bestimmte Version des Ops-Agents auf allen VMs in einer Zone installiert wird:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Erweiterungsrichtlinien auf:

    Zu den Erweiterungsrichtlinien

    Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.

  2. Klicken Sie auf + Erstellen.
  3. Geben Sie im Feld Name einen Namen für die Richtlinie ein.
  4. Optional: Geben Sie im Feld Beschreibung eine Beschreibung für die Richtlinie ein.
  5. Geben Sie im Feld Priorität eine Prioritätsnummer an, um Konflikte zwischen Richtlinien zu beheben. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1.000.

  6. Wählen Sie in der Liste Zone die Zone aus, in der Sie diese Richtlinie anwenden möchten.

  7. Klicken Sie im Bereich Erweiterungen verwalten auf Erweiterung hinzufügen und gehen Sie so vor:

    1. Wählen Sie in der Liste Erweiterung die Option Google Cloud's Extension for Ops Agent aus.
    2. Wählen Sie in der Liste Version die Version aus, die installiert werden soll. Verwenden Sie Version 2.58.0 oder höher.

  8. Klicken Sie auf Erstellen.

gcloud

Verwenden Sie den folgenden Befehl gcloud beta compute zone-vm-extension-policies create, um die Richtlinie zu erstellen:

gcloud beta compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent
  --version=ops-agent=VERSION

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.

  • VERSION: Die Version des Ops-Agents, die installiert werden soll. Verwenden Sie Version 2.58.0 oder höher.

    Wenn Sie die Option --version weglassen, wird mit der Richtlinie die neueste Version installiert und der Ops-Agent wird aktualisiert, wenn eine neue Version veröffentlicht wird. Das Beispiel für die Installation der neuesten Version zeigt, wie das funktioniert.

Eine Liste der Ops-Agent-Versionen finden Sie auf der Seite „Releases“ auf GitHub.

Ops-Agent auf VMs in einer Zone mit einem bestimmten Label installieren

So erstellen Sie eine Richtlinie, mit der die neueste Version des Ops-Agents auf den VMs in einer Zone mit einem bestimmten Label installiert wird:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Erweiterungsrichtlinien auf:

    Zu den Erweiterungsrichtlinien

    Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.

  2. Klicken Sie auf + Erstellen.
  3. Geben Sie im Feld Name einen Namen für die Richtlinie ein.
  4. Optional: Geben Sie im Feld Beschreibung eine Beschreibung für die Richtlinie ein.
  5. Geben Sie im Feld Priorität eine Prioritätsnummer an, um Konflikte zwischen Richtlinien zu beheben. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1.000.

  6. Wählen Sie in der Liste Zone die Zone aus, in der Sie diese Richtlinie anwenden möchten.

  7. Klicken Sie im Bereich Erweiterungen auf Erweiterung hinzufügen und gehen Sie so vor:

    1. Wählen Sie in der Liste Erweiterung die Option Google Cloud's Extension for Ops Agent aus.
    2. Lassen Sie das Feld Version leer.

  8. Wählen Sie im Abschnitt Ziel-VM-Instanzen die VMs für die Richtlinie aus. Wenn Sie VMs mit bestimmten Labels auswählen möchten, klicken Sie auf Labels hinzufügen und fügen Sie das Schlüssel/Wert-Paar hinzu.

  9. Klicken Sie auf Erstellen.

gcloud

Verwenden Sie die Option --inclusion-labels für den Befehl gcloud beta compute zone-vm-extension-policies create, um eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren anzugeben:

gcloud beta compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.

  • KEY1=VALUE1,KEY2=VALUE2: Eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Einschlusslabels für einen Selektor definieren. VMs müssen alle im Selektor angegebenen Labels haben (logisches UND), damit sie berücksichtigt werden. Wenn Sie die Option --inclusion_labels mehrmals angeben, richtet sich die Richtlinie an die VMs, die mit allen Labels in einem der Selektoren übereinstimmen (logisches ODER). Wenn Sie diese Option weglassen, gilt die Richtlinie für alle VMs in der angegebenen Zone.

Ops-Agent mit einer benutzerdefinierten Konfiguration auf allen VMs in einer Zone installieren

So erstellen Sie eine Richtlinie, mit der die neueste Version des Ops-Agents auf allen VMs in einer Zone installiert wird und die eine benutzerdefinierte Konfiguration für den Ops-Agent bereitstellt:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Erweiterungsrichtlinien auf:

    Zu den Erweiterungsrichtlinien

    Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.

  2. Klicken Sie auf + Erstellen.
  3. Geben Sie im Feld Name einen Namen für die Richtlinie ein.
  4. Optional: Geben Sie im Feld Beschreibung eine Beschreibung für die Richtlinie ein.
  5. Geben Sie im Feld Priorität eine Prioritätsnummer an, um Konflikte zwischen Richtlinien zu beheben. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1.000.

  6. Wählen Sie in der Liste Zone die Zone aus, in der Sie diese Richtlinie anwenden möchten.

  7. Klicken Sie im Bereich Erweiterungen auf Erweiterung hinzufügen und gehen Sie so vor:

    1. Wählen Sie in der Liste Erweiterung die Option Google Cloud's Extension for Ops Agent aus.
    2. Lassen Sie das Feld Version leer.
    3. Geben Sie im Feld Inhalt der Konfigurationsdatei den YAML-Konfigurationsstring für den Ops-Agent ein.

  8. Klicken Sie auf Erstellen.

gcloud

Verwenden Sie die Option --config-from-file für den Befehl gcloud beta compute zone-vm-extension-policies create, um eine Konfigurationsdatei anzugeben:

gcloud beta compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.

  • OPS_AGENT_CONFIG_PATH: Der Pfad zu einer Datei, die den YAML-Konfigurationsstring für den Ops-Agenten enthält. Diese Datei muss in der Umgebung vorhanden sein, in der Sie den gcloud-Befehl ausführen.

    Die YAML-Konfiguration für den Ops-Agent kann lang sein. Die Konfiguration in eine Datei zu schreiben und die Datei an die gcloud CLI zu übergeben, ist viel weniger fehleranfällig als der Versuch, korrekt formatierte YAML in der Befehlszeile einzugeben. Wenn Sie diese Datei nach dem Erstellen der Richtlinie ändern, wird die Richtlinie nicht aktualisiert. Verwenden Sie zum Aktualisieren einer Richtlinie den Befehl gcloud beta compute zone-vm-extension-policies update.

Wenn Sie beim Erstellen oder Aktualisieren einer Erweiterungsrichtlinie eine benutzerdefinierte Konfiguration für den Ops-Agenten angeben, wird der Ops-Agent mit der benutzerdefinierten Konfiguration bereitgestellt. Sie müssen den Agent nicht manuell neu starten.

Die Konfiguration wird mit der Erweiterungsrichtlinie gespeichert. Geben Sie daher keine vertraulichen Daten wie Passwörter in der Konfiguration an. Da die Konfiguration in der Erweiterungsrichtlinie gespeichert ist, wird die Konfiguration des Agents durch Ändern der Konfigurationsdatei nicht geändert. Sie müssen die mit der Richtlinie gespeicherte Konfiguration mit dem Befehl gcloud beta compute zone-vm-extension-policies update aktualisieren.

Wenn Sie eine benutzerdefinierte Konfiguration für den Ops-Agent bereitstellen, kopiert der VM Extension Manager die Konfiguration auf der Ziel-VM an den Speicherort, der vom Ops-Agent für nutzerdefinierte Konfigurationsdateien verwendet wird:

  • Linux: /etc/google-cloud-ops-agent/config.yaml
  • Windows: C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

Wenn auf der VM eine config.yaml-Datei vorhanden ist, wird sie durch die Erweiterungsrichtlinie überschrieben.

Allgemeine Informationen zum Erstellen von VM-Erweiterungsrichtlinien mit derGoogle Cloud Console und der gcloud CLI finden Sie unter VM-Erweiterungen durch Erstellen von Erweiterungsrichtlinien installieren .

Ops-Agent durch Aktualisieren von VM-Erweiterungsrichtlinien verwalten

Wenn Sie ändern möchten, wie eine Richtlinie den Ops-Agent verwaltet, aktualisieren Sie die Richtlinie. Wenn Sie eine Richtlinie aktualisieren, werden die Änderungen vom VM Extension Manager in der Regel innerhalb einer Minute auf alle anwendbaren VMs angewendet. Wenn Sie Einschlusslabels ändern, wird der Ops-Agent möglicherweise auf neuen VMs installiert oder von vorhandenen VMs deinstalliert, je nachdem, ob die VMs den aktualisierten Labels entsprechen.

In den folgenden Abschnitten wird beschrieben, wie Sie den Ops-Agenten verwalten, um Folgendes zu tun:

Angepinnte Version des Ops-Agents auf allen VMs in einer Zone aktualisieren

So ändern Sie die angepinnte Version des Ops-Agents auf allen VMs in einer Zone:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Erweiterungsrichtlinien auf:

    Zu den Erweiterungsrichtlinien

    Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.

  2. Wählen Sie die Richtlinie aus, die Sie aktualisieren möchten.
  3. Klicken Sie auf Bearbeiten.
  4. Führen Sie im Abschnitt Erweiterungen verwalten die folgenden Schritte aus:
    1. Wählen Sie Google Cloud's Extension for Ops Agent aus.
    2. Ändern Sie das Feld Version. Verwenden Sie Version 2.58.0 oder höher.
    3. Klicken Sie auf Fertig.
  5. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl gcloud beta compute zone-vm-extension-policies update mit der Option --version, um die angepinnte Agent-Version zu ändern.

Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Anfrage als vollständiger Ersatz behandelt. Alle optionalen Felder, die Sie weglassen, werden auf ihre Standardwerte zurückgesetzt. Vorhandene Werte aus der geänderten Richtlinie werden nicht beibehalten.

Verwenden Sie den folgenden Befehl, um die Version des Ops-Agents zu ändern, die auf allen VMs in einer Zone durch eine Richtlinie installiert ist:

gcloud beta compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent
  --version=ops-agent=VERSION

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.

Konfiguration des Ops-Agents auf allen VMs in einer Zone ändern

So ändern Sie die Konfiguration des Ops-Agents auf allen VMs in einer Zone:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Erweiterungsrichtlinien auf:

    Zu den Erweiterungsrichtlinien

    Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.

  2. Wählen Sie die Richtlinie aus, die Sie aktualisieren möchten.
  3. Klicken Sie auf Bearbeiten.
  4. Führen Sie im Abschnitt Erweiterungen verwalten die folgenden Schritte aus:
    1. Wählen Sie Google Cloud's Extension for Ops Agent aus.
    2. Ändern Sie das Feld Inhalt der Konfigurationsdatei.
    3. Klicken Sie auf Fertig.
  5. Klicken Sie auf Speichern.

gcloud

Verwenden Sie gcloud beta compute zone-vm-extension-policies update mit der Option --config-from-file oder der Option --config, um eine neue Konfiguration anzugeben.

Wenn Sie eine Richtlinie mit gcloud aktualisieren, wird die Anfrage als vollständiger Ersatz behandelt. Alle optionalen Felder, die Sie weglassen, werden auf ihre Standardwerte zurückgesetzt. Vorhandene Werte aus der geänderten Richtlinie werden nicht beibehalten.

Verwenden Sie den folgenden Befehl, um die Konfiguration des Ops-Agent zu ändern, der auf allen VMs in einer Zone installiert ist:

gcloud beta compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.

  • OPS_AGENT_CONFIG_PATH: Der Pfad zu einer Datei, die den YAML-Konfigurationsstring für den Ops-Agenten enthält. Diese Datei muss in der Umgebung vorhanden sein, in der Sie den gcloud-Befehl ausführen.

    Die YAML-Konfiguration für den Ops-Agent kann lang sein. Die Konfiguration in eine Datei zu schreiben und die Datei an die gcloud CLI zu übergeben, ist viel weniger fehleranfällig als der Versuch, korrekt formatierte YAML in der Befehlszeile einzugeben.

Wenn Sie beim Erstellen oder Aktualisieren einer Erweiterungsrichtlinie eine benutzerdefinierte Konfiguration für den Ops-Agenten angeben, wird der Ops-Agent mit der benutzerdefinierten Konfiguration bereitgestellt. Sie müssen den Agent nicht manuell neu starten.

Die Konfiguration wird mit der Erweiterungsrichtlinie gespeichert. Geben Sie daher keine vertraulichen Daten wie Passwörter in der Konfiguration an. Da die Konfiguration in der Erweiterungsrichtlinie gespeichert ist, wird die Konfiguration des Agents durch Ändern der Konfigurationsdatei nicht geändert. Sie müssen die mit der Richtlinie gespeicherte Konfiguration mit dem Befehl gcloud beta compute zone-vm-extension-policies update aktualisieren.

Wenn Sie eine benutzerdefinierte Konfiguration für den Ops-Agent bereitstellen, kopiert der VM Extension Manager die Konfiguration auf der Ziel-VM an den Speicherort, der vom Ops-Agent für nutzerdefinierte Konfigurationsdateien verwendet wird:

  • Linux: /etc/google-cloud-ops-agent/config.yaml
  • Windows: C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

Wenn auf der VM eine config.yaml-Datei vorhanden ist, wird sie durch die Erweiterungsrichtlinie überschrieben.

Allgemeine Informationen zur Verwaltung von VM-Erweiterungsrichtlinien mit derGoogle Cloud Console und der gcloud CLI finden Sie unter Erweiterungen durch Aktualisieren einer VM-Erweiterungsrichtlinie ändern.

Ops-Agent durch Löschen von VM-Erweiterungsrichtlinien deinstallieren

Wenn Sie den Ops-Agent deinstallieren möchten, löschen Sie die VM-Erweiterungsrichtlinie, mit der der Agent verwaltet wird. Wenn eine andere aktive Richtlinie mit niedrigerer Priorität auf eine VM angewendet wird und auch den Ops-Agent verwaltet, bleibt der Agent basierend auf der Richtlinie mit niedrigerer Priorität auf dieser VM installiert.

VM Extension Manager entfernt den Ops-Agent innerhalb einer Minute nach dem Löschen der Richtlinie von allen zugänglichen VMs. Wenn eine VM nicht zugänglich ist, überspringt der VM Extension Manager das Löschen des Agents. Wenn die VM wieder verfügbar ist, wird der Agent vom VM Extension Manager entfernt.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Erweiterungsrichtlinien auf:

    Zu den Erweiterungsrichtlinien

    Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.

  2. Wählen Sie die Richtlinie aus, die Sie löschen möchten.
  3. Klicken Sie auf Löschen.
  4. Klicken Sie im Bestätigungsdialogfeld auf Löschen.

gcloud

Verwenden Sie zum Löschen der VM-Erweiterungsrichtlinie, mit der der Ops-Agent verwaltet wird, den Befehl gcloud beta compute zone-vm-extension-policies delete:

gcloud beta compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.

Informationen zu VM-Erweiterungsrichtlinien abrufen

Sie können die folgenden Informationen zu vorhandenen VM-Erweiterungsrichtlinien abrufen:

  • Eine Liste aller Richtlinien in Ihrem Google Cloud Projekt.
  • Konfigurationsinformationen zu einer bestimmten Richtlinie.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Erweiterungsrichtlinien auf:

    Zu den Erweiterungsrichtlinien

    Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.

    Auf dieser Seite werden alle VM-Erweiterungsrichtlinien in Ihrem Projekt aufgeführt.
  2. Klicken Sie auf den Namen einer Richtlinie, um die Details zu einer bestimmten Erweiterungsrichtlinie aufzurufen.

gcloud

VM-Erweiterungsrichtlinien auflisten

Verwenden Sie gcloud beta compute zone-vm-extension-policies list, um Informationen zu allen VM-Erweiterungsrichtlinien in einer Zone aufzulisten:

gcloud beta compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE_INTEGER

Ersetzen Sie im Befehl die folgenden Variablen:

  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.
  • PAGE_SIZE_INTEGER: Die Anzahl der Richtlinien, die pro Seite aufgelistet werden sollen, z. B. 2. Weitere Informationen zu Sortier- und Filteroptionen finden Sie unter gcloud beta compute zone-vm-extension-policies list.

Benannte VM-Erweiterungsrichtlinie beschreiben

Verwenden Sie gcloud beta compute zone-vm-extension-policies describe, um die Konfiguration einer benannten Richtlinie in einer Zone abzurufen:

gcloud beta compute zone-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • ZONE: Die Zielzone, z. B. us-central1-f.

Allgemeine Informationen zum Abrufen von Informationen zu VM-Erweiterungsrichtlinien mit derGoogle Cloud Console und der gcloud CLI finden Sie unter Erweiterungsrichtlinien ansehen.

Installation des Ops-Agents prüfen

In diesem Abschnitt wird Folgendes beschrieben:

Status oder Version einer Ops-Agent-Installation prüfen

Verwenden Sie eine der folgendenGoogle Cloud -Konsolenseiten, um den Status oder die Version des Ops-Agents zu ermitteln:

Compute Engine

  1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf:

    Zu Seite VM-Instanzen

    Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.

  2. Wählen Sie eine VM aus der Liste aus.
  3. Klicken Sie auf den Tab Beobachtbarkeit.

Cloud Monitoring

  1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf:

    Zur Seite VM-Instanzen

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Wählen Sie die Listenansicht aus.

Wenn der Ops-Agent auf der VM installiert ist und Logs und Messwerte erfasst, wird der Status des Agents mit einem grünen Häkchen neben dem Label Ops-Agent gekennzeichnet.

Wenn Sie die Version des installierten Agents ermitteln möchten, bewegen Sie den Mauszeiger auf dem Compute Engine- oder Monitoring-Dashboard auf das Label Ops-Agent.

Prüfen, ob der Ops-Agent Telemetriedaten erfasst

Wenn der Ops-Agent erfolgreich installiert wurde und korrekt ausgeführt wird, sendet er Messwerte an Cloud Monitoring und Logs an Cloud Logging.

Von einer Erweiterungsrichtlinie installierten Ops-Agent neu starten

Wenn der Ops-Agent installiert und vom VM Extension Manager verwaltet wird, wird er nicht vom Systemverwaltungsdienst des Betriebssystems verwaltet, d. h. von systemd unter Linux oder vom Windows Service Manager unter Windows. Daher funktionieren Linux-systemctl-Befehle und Windows-*-Service-Befehle nicht mit einem Ops-Agent, der über eine Erweiterungsrichtlinie installiert wurde.

So starten Sie einen Ops-Agent neu, der über eine Erweiterungsrichtlinie installiert wurde:

  • Erstellen Sie die Richtlinie neu.

    1. Löschen Sie die Richtlinie. Wenn Sie die Richtlinie löschen, wird der Ops-Agent beendet und deinstalliert.

    2. Erstellen Sie eine neue Richtlinie. Durch die neue Richtlinie wird der Ops-Agent installiert und gestartet.

  • Verwenden Sie eine temporäre Richtlinie mit höherer Priorität. Wenn die ursprüngliche Richtlinie eine große Anzahl von VMs betrifft, Sie den Ops-Agent aber nur auf einer kleinen Anzahl neu starten möchten, fügen Sie diesen VMs ein Label hinzu und konfigurieren Sie die neue Richtlinie so, dass sie nach dem Label gefiltert wird.

    Wenn beispielsweise eine Richtlinie mit der Priorität 1000 den Ops-Agent auf einer VM nicht starten konnte, können Sie der VM ein Label wie status=failed hinzufügen. Erstellen Sie dann eine neue Richtlinie mit einer höheren Priorität, z. B. 500. Ein Google Cloud CLI-Befehl könnte beispielsweise so aussehen:

    gcloud beta compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml

    Ersetzen Sie im Befehl die folgenden Variablen:

    • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
    • PROJECT_ID: Die Kennung des Projekts.
    • ZONE: Die Zielzone, z. B. us-central1-f.

    Nachdem der Ops-Agent mit der neuen Richtlinie erfolgreich installiert wurde, löschen Sie die Richtlinie und entfernen Sie das Label von den VMs. Der Ops-Agent bleibt auf der VM installiert, da die ursprüngliche Richtlinie weiterhin aktiv ist.

Gast-Agent-Fehlerbehebungsprotokoll auf der VM aktivieren

VM Extension Manager-Richtlinien verwenden den Compute Engine-Gast-Agent, um den Ops-Agent als VM-Erweiterung zu verwalten. Informationen zum Aktivieren des Debug-Loggings für den Gast-Agent finden Sie unter Debug-Logs für den Gast-Agent ansehen.

Fehlerbehebung bei Erweiterungsrichtlinien

In diesem Abschnitt finden Sie Informationen zur Fehlerbehebung bei der Verwendung von Erweiterungsrichtlinien zum Verwalten des Ops-Agents:

Informationen zur Fehlerbehebung beim Ops-Agent finden Sie unter Fehlerbehebung beim Ops-Agent.

gcloud beta compute zone-vm-extension-policies-Befehle schlagen fehl

Wenn ein gcloud beta compute zone-vm-extension-policies-Befehl fehlschlägt, enthält die Antwort Vorschläge zur Fehlerbehebung. Korrigieren Sie alle Fehler in den Befehls-Flags oder ‑Argumenten, die in der Fehlermeldung vorgeschlagen werden.

Wenn in der Ausgabe des Befehls unzureichende IAM-Berechtigungen erwähnt werden, sehen Sie sich die erforderlichen Rollen und Berechtigungen an, die unter Erforderliche Rollen zum Verwenden von VM Extension Manager zuweisen beschrieben werden.

Die Erweiterungsrichtlinie wurde erstellt, aber der Ops-Agent-Status ist „nicht erkannt“

Sie haben eine Erweiterungsrichtlinie erstellt, aber der Ops-Agent zeigt auf der VM den Status „nicht erkannt“ an.

Der Ops-Agent wird möglicherweise als „nicht erkannt“ angezeigt, wenn einer der folgenden Fälle eintritt:

  • Der Ops-Agent kann aufgrund der Erweiterungsrichtlinie nicht installiert werden.
  • Bei einem installierten Ops-Agent tritt ein Fehler auf, der die Ausführung verhindert.

In den folgenden Abschnitten wird beschrieben, wie Sie diese Fälle diagnostizieren.

Prüfen, ob der Ops-Agent durch die Richtlinie installiert wurde

VM Extension Manager-Richtlinien verwenden den Compute Engine-Gast-Agent, um den Ops-Agent als VM-Erweiterung zu verwalten.

So ermitteln Sie, ob der Ops-Agent über die Erweiterungsrichtlinie installiert wurde:

Log-Explorer

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

    Zum Log-Explorer

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Geben Sie die folgende Abfrage ein und klicken Sie auf Abfrage ausführen:

    log_id("GCEGuestAgentManager")

Linux

Führen Sie den folgenden Befehl auf der Compute Engine-VM aus:

journalctl -u google-guest-agent-manager

Windows

Führen Sie den folgenden Befehl auf der Compute Engine-VM aus:

Get-Eventlog -Source google_guest_agent_manager -LogName Application

Wenn Sie Logs mit einem String wie Failed to install plugin "ops-agent-plugin" ... sehen oder die Abfrage keine Logs zurückgibt, konnte der Ops-Agent aufgrund der Erweiterungsrichtlinie nicht installiert werden. Weitere Informationen finden Sie unter Ops-Agent kann aufgrund einer Erweiterungsrichtlinie nicht installiert werden.

Wenn Sie Logs mit einem String wie Successfully installed plugin "ops-agent_nnnnnnnn" sehen, wurde der Ops-Agent durch die Erweiterungsrichtlinie erfolgreich installiert. Informationen zu den nächsten Schritten finden Sie unter Installierter Ops-Agent wird nicht erkannt.

Der Ops-Agent wird nicht über die Erweiterungsrichtlinie installiert

Eine Erweiterungsrichtlinie ist möglicherweise nicht wirksam, wenn eine der folgenden Bedingungen zutrifft:

Der installierte Ops-Agent hat den Status „Nicht erkannt“

Der Ops-Agent kann den Status „nicht erkannt“ haben, wenn eine der folgenden Bedingungen zutrifft:

Prüfen, ob die Ops-Agent-Konfiguration gültig ist

Sie haben eine benutzerdefinierte Konfiguration für den Ops-Agent bereitgestellt, indem Sie eine Erweiterungsrichtlinie erstellt oder aktualisiert haben, aber der Agentenstatus ist „nicht erkannt“. Das Problem könnte ein Fehler in Ihrer benutzerdefinierten Konfiguration sein. Verwenden Sie die Debug-Logs des Gast-Agents, um nach Konfigurationsfehlern zu suchen.

Debug-Protokollierung für Gast-Agent aktivieren

Informationen zum Aktivieren des Debug-Loggings für den Gast-Agent finden Sie unter Debug-Logs für den Gast-Agent ansehen.

Debug-Logs prüfen

Log-Explorer

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

    Zum Log-Explorer

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Geben Sie die folgende Abfrage ein und klicken Sie auf Abfrage ausführen:

    severity>=DEBUG log_id("GCEGuestAgentManager") "The agent config file is not valid"

Linux

Führen Sie den folgenden Befehl auf der Linux Compute Engine-VM aus:

journalctl -u google-guest-agent-manager | grep "The agent config file is not valid"

Windows

Führen Sie den folgenden Befehl auf der Windows Compute Engine-VM aus:

Get-Eventlog -Source google_guest_agent_manager -LogName Application | Where-Object {$_.Message -like "*The agent config file is not valid*"}

Wenn Sie Logs mit dem String The agent config file is not valid sehen, ist die benutzerdefinierte Konfiguration für den Ops-Agent, die Sie beim Erstellen oder Aktualisieren der Erweiterungsrichtlinie angegeben haben, ungültig.

So beheben Sie das Problem:

  • Korrigieren Sie die Konfiguration anhand der Anleitung Ops-Agent konfigurieren. Informationen zur Struktur einer Ops-Agent-Konfigurationsdatei.

  • Aktualisieren Sie die Erweiterungsrichtlinie mit der korrigierten Konfiguration.

Linux-Befehle systemctl status und Windows-Befehle Get-Service funktionieren nicht mit dem Ops-Agent

Sie führen einen Befehl wie sudo systemctl status google-cloud-ops-agent"*" aus, aber es werden keine Informationen zurückgegeben.

Wenn der Ops-Agent installiert und vom VM Extension Manager verwaltet wird, wird er nicht vom Systemverwaltungsdienst des Betriebssystems verwaltet, d. h. von systemd unter Linux oder vom Windows Service Manager unter Windows.

So rufen Sie Statusinformationen für einen Ops-Agent auf, der vom VM Extension Manager verwaltet wird:

Linux-Befehle systemctl restart und Windows-Befehle Restart-Service funktionieren nicht mit dem Ops-Agent

Sie führen einen Befehl wie sudo systemctl restart google-cloud-ops-agent aus, aber der Ops-Agent wird nicht neu gestartet.

Wenn der Ops-Agent installiert und vom VM Extension Manager verwaltet wird, wird er nicht vom Systemverwaltungsdienst des Betriebssystems verwaltet, d. h. von systemd unter Linux oder vom Windows Service Manager unter Windows. Daher können Sie den Ops-Agent nicht manuell beenden oder starten. Befehle wie die folgenden funktionieren nicht mit dem Ops-Agent:

  • Linux: sudo systemctl [stop|start|restart]
  • Windows: Stop-Service, Start-Service, Restart-Service

Wenn Sie einen von VM Extension Manager verwalteten Ops-Agent beenden oder neu starten möchten, müssen Sie den Agent deinstallieren, indem Sie die Erweiterungsrichtlinie löschen. Weitere Informationen zum Beenden oder Neustarten des Ops-Agents finden Sie unter Von einer Erweiterungsrichtlinie installierten Ops-Agent neu starten.

Zusätzliche Informationen zur Fehlerbehebung

Weitere Informationen zur Fehlerbehebung bei der Erstellung und Verwendung von VM Extension Manager-Richtlinien finden Sie unter Fehlerbehebung bei VM-Erweiterungen.

Weitere Informationen zur Fehlerbehebung beim Ops-Agent finden Sie unter Fehlerbehebung beim Ops-Agent.

Kontingent

Informationen zur Anzahl der Erweiterungsrichtlinien, die Sie in einem Google Cloud Projekt erstellen können, finden Sie unter Quota.

Preise

Informationen zu den Kosten für die Verwendung von VM Extension Manager finden Sie unter Preise.

Wenn Sie den Ops-Agent installieren, werden Ihnen möglicherweise die Messwerte, Logs oder Traces in Rechnung gestellt, die der Agent an Ihr Google Cloud -Projekt sendet. Preisinformationen finden Sie unter Google Cloud Observability-Preise.

Nächste Schritte