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

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

  • Flottenweite Installation: Installieren Sie den Ops-Agent auf den folgenden Instanzen:

    • Alle VMs in einer oder mehreren Zonen in Ihrem Google Cloud -Projekt.
    • Alle VMs weltweit (in Ihrem Google Cloud Projekt).
    • Eine Teilmenge von VMs in einer Zone, die durch Labels identifiziert werden.
    • Eine Teilmenge von VMs in verschiedenen Zonen in Ihrem Google Cloud -Projekt, die durch Labels identifiziert werden.

  • Versionsverwaltung:

    • Halten Sie den Ops-Agent auf dem neuesten Stand.
    • Ops-Agent-Version an einen bestimmten Release anpinnen

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

Mit 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 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 Versionen des Legacy-Monitoring-Agents oder Logging-Agents verwaltet werden.

Sie können zonale VM-Erweiterungsrichtlinien mit derGoogle Cloud -Konsole oder der Google Cloud CLI (gcloud) erstellen und verwalten. Sie können globale Richtlinien für VM-Erweiterungen mit gcloud erstellen und verwalten.

Hinweis

Bevor Sie mit der Verwendung von VM Extension Manager-Erweiterungsrichtlinien 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.

Für die Verwendung des Ops-Agents erforderliche APIs aktivieren

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.

Rollen, die zum Aktivieren von APIs erforderlich sind

Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Rolle „Inhaber“ (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen

APIs aktivieren

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.

Erforderliche Rollen für die Verwendung von VM Extension Manager zuweisen

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, aufzurufen, 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 die gcloud CLI verwenden möchten, müssen Sie zuerst die Google Cloud CLI installieren.

Führen Sie den folgenden Befehl aus, um die installierten Komponenten aufzurufen:

gcloud components list

Führen Sie den folgenden Befehl aus, um zu prüfen, ob Sie die aktuelle 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 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. Die Ausführung des Agents schlägt jedoch fehl, 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 weisen auf höhere Prioritäten hin. Die Standardpriorität ist 1000. Eine VM kann von mehreren Richtlinien für eine Erweiterung wie den Ops-Agent 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 lösen, die auf eine VM angewendet werden. Weitere Informationen zum Lösungsprozess finden Sie unter Richtlinienpriorität und Konfliktlösung.

Roll-out-Pläne für globale Richtlinien

Globale Richtlinien von VM Extension Manager verwenden einen Roll-out-Plan, um zu bestimmen, wie eine Richtlinie auf Ziel-VMs verteilt wird. Es gibt zwei Arten von Rollout-Plänen:

  • Vordefinierte Rollout-Pläne: Es gibt zwei vordefinierte Rollout-Pläne, die durch den Wert ausgewählt werden, der mit der Option --rollout-predefined-plan für gcloud CLI-Befehle verwendet wird.

    • Langsame Einführung: Der Ops-Agent wird über einen bestimmten Zeitraum hinweg schrittweise in verschiedenen Zonen bereitgestellt. Dieser Roll-out-Plan wird empfohlen.

      Geben Sie diesen Roll-out-Plan mit der Option --rollout-predefined-plan=slow_rollout an.

    • Schnelles Roll-out: Der Ops-Agent wird sofort auf allen Ziel-VMs in allen Zonen und Regionen bereitgestellt.

      Geben Sie diesen Roll-out-Plan mit der Option --rollout-predefined-plan=fast_rollout an.

  • Benutzerdefinierte Roll-out-Pläne, die mit der Option --rollout-custom-plan für gcloud CLI-Befehle angegeben werden.

    Erstellen Sie benutzerdefinierte Rollout-Pläne, indem Sie sie der Gruppe von Rollout-Plänen in Ihrem Google Cloud -Projekt hinzufügen. Weitere Informationen finden Sie in der Compute Engine API-Methode rolloutPlans.insert.

Weitere Informationen zu Roll-out-Plänen finden Sie unter Roll-out-Pläne für globale Richtlinien.

Neuesten Ops-Agent auf allen VMs installieren

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

Console

Sie können eine zonale Richtlinie mit der Google Cloud Console erstellen.

  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

Sie können die gcloud CLI verwenden, um eine zonale oder globale Richtlinie zu erstellen.

Zonal

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

gcloud 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.

Der Befehl gcloud 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.

Global

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

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.

Der Befehl gcloud compute global-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 an eine bestimmte Version anpinnen

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

Console

Sie können eine zonale Richtlinie mit der Google Cloud Console erstellen.

  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

Sie können die gcloud CLI verwenden, um eine zonale oder globale Richtlinie zu erstellen.

Zonal

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

gcloud 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, wie im Beispiel Neueste Version installieren gezeigt.

Global

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

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --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.
  • 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, wie im Beispiel Neueste Version installieren gezeigt.

Eine Liste der Ops-Agent-Versionen finden Sie auf der Seite mit den Releases des Ops-Agents auf GitHub.

Ops-Agent auf VMs mit einem bestimmten Label installieren

So erstellen Sie eine Richtlinie, mit der die neueste Version des Ops-Agents auf den VMs in einer Zone oder global installiert wird, die ein bestimmtes Label haben:

Console

Sie können eine zonale Richtlinie mit der Google Cloud Console erstellen.

  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. 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

Sie können die gcloud CLI verwenden, um eine zonale oder globale Richtlinie zu erstellen.

Zonal

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

gcloud 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 in einem Selektor angegebenen Labels (logisches UND) haben, 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.

Global

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

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --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.
  • 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 in einem Selektor angegebenen Labels (logisches UND) haben, 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 benutzerdefinierter Konfiguration auf allen VMs installieren

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

Console

Sie können eine zonale Richtlinie mit der Google Cloud Console erstellen.

  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.
    3. Geben Sie im Feld Inhalt der Konfigurationsdatei den YAML-Konfigurationsstring für den Ops-Agenten ein.
  8. Klicken Sie auf Erstellen.

gcloud

Sie können die gcloud CLI verwenden, um eine zonale oder globale Richtlinie zu erstellen.

Zonal

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

gcloud 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 Konfigurations-YAML 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 formatiertes 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 compute zone-vm-extension-policies update.

Global

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

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --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.
  • 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 Konfigurations-YAML 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 formatiertes 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 compute global-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 KI‑Agenten nicht manuell neu starten.

Die Konfiguration wird in 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 entsprechenden gcloud-Befehl 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 mit Erweiterungsrichtlinien installieren .

Ops-Agent mit einem schnellen Rollout-Plan mit höherer Priorität installieren (nur global)

Wenn Sie eine globale Richtlinie erstellen möchten, mit der die aktuelle Version des Ops-Agents mit einer höheren als der Standardpriorität und dem Roll-out-Plan für die schnelle Einführung installiert wird, verwenden Sie den folgenden gcloud compute global-vm-extension-policies create-Befehl:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=fast_rollout \
  --priority=500

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.

Ops-Agent in einer Teilmenge von Zonen in einem Google Cloud -Projekt installieren (nur global)

Wenn Sie eine globale Richtlinie erstellen möchten, die nur für eine Teilmenge von Zonen in einemGoogle Cloud -Projekt gilt, müssen Sie einen benutzerdefinierten Roll-out-Plan verwenden, in dem die Zonen angegeben sind, in denen die Richtlinie angewendet werden soll. Informationen zum Erstellen benutzerdefinierter Roll-out-Pläne finden Sie unter Roll-out-Pläne. Wenn Sie eine Reihe von Zonen angeben möchten, verwenden Sie beim Erstellen des Roll-out-Plans das Feld locationSelector.includedLocations.

Verwenden Sie den folgenden gcloud compute global-vm-extension-policies create-Befehl, um eine Erweiterungsrichtlinie zu erstellen, die einen benutzerdefinierten Roll-out-Plan verwendet:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/CUSTOM_PLAN_NAME

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • CUSTOM_PLAN_NAME: Der Name, der Ihrem benutzerdefinierten Roll-out-Plan zugeordnet ist.

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, führt VM Extension Manager die Änderungen in der Regel innerhalb einer Minute auf allen anwendbaren VMs aus. 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

Sie können eine zonale Richtlinie mit der Google Cloud Console erstellen.

  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 folgende Schritte aus:
    1. Wählen Sie in der Liste Erweiterung die Option 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

Sie können die gcloud CLI verwenden, um eine zonale oder globale Richtlinie zu erstellen.

Zonal

Verwenden Sie den Befehl gcloud 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 aus der Anfrage weglassen, werden daher auf ihre Standardwerte zurückgesetzt, anstatt vorhandene Werte aus der geänderten Richtlinie beizubehalten.

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 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.
  • VERSION: Die Version des Ops-Agents, die installiert werden soll. Verwenden Sie Version 2.58.0 oder höher. Eine Liste der Versionen finden Sie auf der Seite mit den Releases des Ops-Agents auf GitHub.

    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, wie im Beispiel Neueste Version installieren gezeigt.

Global

Verwenden Sie den Befehl gcloud compute global-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 aus der Anfrage weglassen, werden daher auf ihre Standardwerte zurückgesetzt, anstatt vorhandene Werte aus der geänderten Richtlinie beizubehalten.

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

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --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.
  • VERSION: Die Version des Ops-Agents, die installiert werden soll. Verwenden Sie Version 2.58.0 oder höher. Eine Liste der Versionen finden Sie auf der Seite mit den Releases des Ops-Agents auf GitHub.

    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, wie im Beispiel Neueste Version installieren gezeigt.

Konfiguration des Ops-Agenten auf allen VMs ändern

So ändern Sie die Konfiguration des Ops-Agents:

Console

Sie können eine zonale Richtlinie mit der Google Cloud Console erstellen.

  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 folgende Schritte aus:
    1. Wählen Sie in der Liste Erweiterung die Option Google Cloud's Extension for Ops Agent aus.
    2. Geben Sie im Feld Inhalt der Konfigurationsdatei den YAML-Konfigurationsstring für den Ops-Agenten ein.
    3. Klicken Sie auf Fertig.
  5. Klicken Sie auf Speichern.

gcloud

Sie können die gcloud CLI verwenden, um eine zonale oder globale Richtlinie zu erstellen.

Zonal

Verwenden Sie den Befehl gcloud compute zone-vm-extension-policies update mit der Option --config-from-file oder --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 aus der Anfrage weglassen, werden daher auf ihre Standardwerte zurückgesetzt, anstatt vorhandene Werte aus der geänderten Richtlinie beizubehalten.

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

gcloud 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 Konfigurations-YAML 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 formatiertes YAML in der Befehlszeile einzugeben.

Global

Verwenden Sie den Befehl gcloud compute global-vm-extension-policies update mit der Option --config-from-file oder --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 aus der Anfrage weglassen, werden daher auf ihre Standardwerte zurückgesetzt, anstatt vorhandene Werte aus der geänderten Richtlinie beizubehalten.

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

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --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.
  • 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 Konfigurations-YAML 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 formatiertes 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 KI‑Agenten nicht manuell neu starten.

Die Konfiguration wird in 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 entsprechenden gcloud-Befehl 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.

Vorhandene globale Richtlinie auf neue Zonen ausweiten (nur global)

Wenn VMs in neuen Zonen erstellt werden, nachdem eine globale Richtlinie erstellt und eingeführt wurde, wendet VM Extension Manager die Richtlinie nicht automatisch auf die VMs in den neuen Zonen an. Wenn Sie die VMs in neue Zonen aufnehmen möchten, müssen Sie die globale Richtlinie noch einmal bereitstellen.

Verwenden Sie den Befehl gcloud compute global-vm-extension-policies update und geben Sie die Option --rollout-retry-uuid=UUID an, um ein globales Richtlinien-Roll-out neu zu starten.

Angenommen, Sie haben eine globale Richtlinie mit dem folgenden Befehl erstellt und eingeführt:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml"

Wenn Sie die Richtlinie auf VMs ausweiten möchten, die in bisher nicht verwendeten Zonen erstellt wurden, starten Sie die Einführung mit dem folgenden Befehl neu:

gcloud compute global-vm-extension-policies update test-policy POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml" \
  --rollout-retry-uuid=UUID

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • UUID: Eine Universally Unique Identifier (UUID), die die Wiederholungsanfrage identifiziert. Sie können einen beliebigen UUID-Generator verwenden, um eine UUID zu erstellen. Weitere Informationen finden Sie unter Roll-out wiederholen .

Globale Richtlinie aktualisieren, um eine Reihe von Zonen auszuschließen (nur global)

Wenn Sie die Zonen aktualisieren möchten, auf die eine globale Richtlinie angewendet wird, die einige Zonen in einemGoogle Cloud -Projekt ausschließt, müssen Sie einen neuen benutzerdefinierten Rollout-Plan verwenden, in dem die Zonen angegeben sind, in denen die Richtlinie angewendet werden soll. Informationen zum Erstellen benutzerdefinierter Roll-out-Pläne finden Sie unter Roll-out-Pläne. Wenn Sie eine Reihe von Zonen angeben möchten, verwenden Sie beim Erstellen des Roll-out-Plans das Feld locationSelector.includedLocations.

Verwenden Sie den folgenden gcloud compute global-vm-extension-policies update-Befehl, um eine Erweiterungsrichtlinie zu aktualisieren, die einen benutzerdefinierten Roll-out-Plan verwendet:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
  --rollout-retry-uuid=UUID

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.
  • NEW_CUSTOM_PLAN_NAME: Der Name, der mit Ihrem aktualisierten benutzerdefinierten Roll-out-Plan verknüpft ist.
  • UUID: Eine Universally Unique Identifier (UUID), die die Wiederholungsanfrage identifiziert. Sie können einen beliebigen UUID-Generator verwenden, um eine UUID zu erstellen. Weitere Informationen finden Sie unter Roll-out wiederholen .

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 für eine VM gilt 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, wird das Löschen des Agents durch den VM Extension Manager übersprungen. 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

Zonal

Verwenden Sie den Befehl gcloud compute zone-vm-extension-policies delete, um die VM-Erweiterungsrichtlinie zu löschen, mit der der Ops-Agent verwaltet wird:

gcloud 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.

Global

Verwenden Sie den Befehl gcloud compute global-vm-extension-policies delete, um die globale VM-Erweiterungsrichtlinie zu löschen, mit der der Ops-Agent verwaltet wird:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=slow_rollout

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.

Wenn Sie ein bereits gestartetes Roll-out zum Löschen beschleunigen möchten, geben Sie einen neuen Löschbefehl mit dem fast_rollout-Plan aus. Sie müssen auch die Option --rollout-retry-uuid=UUID angeben:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=fast_rollout \
  --rollout-retry-uuid=UUID

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.

  • UUID: Ein Universally Unique Identifier (UUID), der die Wiederholungsanfrage identifiziert. Sie können einen beliebigen UUID-Generator verwenden, um eine UUID zu erstellen. Weitere Informationen finden Sie unter Roll-out wiederholen .

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. Wenn Sie Details zu einer bestimmten Erweiterungsrichtlinie aufrufen möchten, klicken Sie auf den Namen der Richtlinie.

gcloud

Zonal

VM-Erweiterungsrichtlinien auflisten

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

gcloud 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 den Sortier- und Filteroptionen finden Sie unter gcloud compute zone-vm-extension-policies list.

Benannte VM-Erweiterungsrichtlinie beschreiben

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

gcloud 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.

Global

Globale VM-Erweiterungsrichtlinien auflisten

Verwenden Sie den Befehl gcloud compute global-vm-extension-policies list, um Informationen zu globalen VM-Erweiterungsrichtlinien aufzulisten:

gcloud compute global-vm-extension-policies list \
  --project=PROJECT_ID \
  --page-size=PAGE_SIZE_INTEGER

Ersetzen Sie im Befehl die folgenden Variablen:

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

Benannte globale VM-Erweiterungsrichtlinie beschreiben

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

gcloud compute global-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID

Ersetzen Sie im Befehl die folgenden Variablen:

  • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
  • PROJECT_ID: Die Kennung des Projekts.

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 wurde 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 vom VM Extension Manager installiert und verwaltet wird, wird er nicht vom Systemverwaltungsdienst des Betriebssystems verwaltet, d. h. systemd unter Linux oder dem 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 von VMs 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 der Ops-Agent auf einer VM aufgrund einer Richtlinie mit der Priorität 1.000 nicht gestartet werden 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:

    Zonal 

    gcloud 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.

    Global 

    gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml \
  --rollout-predefined-plan=fast_rollout

    Ersetzen Sie im Befehl die folgenden Variablen:

    • POLICY_NAME: Ein Name für die VM-Erweiterungsrichtlinie.
    • PROJECT_ID: Die Kennung des Projekts.

    Nachdem der Ops-Agent durch die neue Richtlinie 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.

Debug-Log des Gast-Agents 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 compute zone-vm-extension-policies-Befehle schlagen fehl

Wenn ein gcloud 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 gewähren beschrieben werden.

Die Erweiterungsrichtlinie wird 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 über die 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: Verwenden Sie eine der folgenden Methoden, um nach Logeinträgen vom Gast-Agent zu suchen:

Log-Explorer

  1. Rufen Sie in der Google Cloud Console das und 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. Informationen zu den nächsten Schritten finden Sie unter Die Installation des Ops-Agents über die Erweiterungsrichtlinie schlägt fehl.

Wenn Sie Protokolle 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 einer der folgenden Fälle eintritt:

  • Der Gast-Agent ist nicht auf der VM installiert. So diagnostizieren und beheben Sie dieses Problem:

    1. Prüfen Sie, ob auf der VM eines der Betriebssysteme ausgeführt wird, die für die Compute Engine-Gastumgebung unterstützt werden.

    2. Sehen Sie sich die auf der VM installierten Pakete an, um zu prüfen, ob google-guest-agent enthalten ist.

    3. Wenn google-guest-agent nicht installiert ist, installieren Sie den Gast-Agent.

  • Der Gast-Agent ist installiert, aber veraltet. So diagnostizieren und beheben Sie dieses Problem:

    1. Gastumgebung validieren, um die Version des google-guest-agent-Pakets zu ermitteln. Für VM Extension Manager ist Version 20241209.01 oder höher erforderlich.

    2. Wenn die Version von google-guest-agent älter als 20241209.01 ist, aktualisieren Sie die Gastumgebung.

  • Das Betriebssystem der VM wird vom VM Extension Manager nicht unterstützt. Weitere Informationen finden Sie unter Unterstützte Betriebssysteme.

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, der Agentenstatus ist jedoch „nicht erkannt“. Das Problem könnte ein Fehler in Ihrer benutzerdefinierten Konfiguration sein. Suchen Sie in den Debug-Logs des Gast-Agents nach Konfigurationsfehlern.

Debug-Logging 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 das und 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 Informationen unter Ops-Agent konfigurieren. Informationen zur Struktur einer Ops-Agent-Konfigurationsdatei.

  • Aktualisieren Sie die Erweiterungsrichtlinie mit der korrigierten Konfiguration.

Linux-systemctl status- und Windows-Get-Service-Befehle 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 vom VM Extension Manager installiert und verwaltet wird, wird er nicht vom Systemverwaltungsdienst des Betriebssystems verwaltet, d. h. systemd unter Linux oder dem Windows Service Manager unter Windows.

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

Linux-systemctl restart- und Windows-Restart-Service-Befehle 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 vom VM Extension Manager installiert und verwaltet wird, wird er nicht vom Systemverwaltungsdienst des Betriebssystems verwaltet, d. h. systemd unter Linux oder dem 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 vom VM Extension Manager verwalteten Ops-Agent beenden oder neu starten möchten, müssen Sie den Agenten 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