Ops-Agent mithilfe von VM Extension Manager-Richtlinien installieren

Mit VM Extension Manager-Richtlinien können Sie den Ops-Agent auf einer Reihe von Compute Engine-VMs installieren. Mit einer Erweiterungsrichtlinie können Sie den Ops-Agent global in Ihrem Google Cloud -Projekt oder in einer bestimmten Zone installieren, die Agent-Version auf dem neuesten Stand halten und eine benutzerdefinierte Konfiguration auf den Agent anwenden.

Hinweis

Führen Sie die folgenden Schritte aus, bevor Sie VM Extension Manager-Erweiterungsrichtlinien zum Verwalten des Ops-Agenten erstellen:

Vorhandene Beobachtbarkeits-Agents entfernen

Bevor Sie eine VM Extension Manager-Richtlinie für den Ops-Agent erstellen, müssen Sie sicherstellen, dass auf der VM keine Instanzen des Ops-Agent oder des Legacy-Monitoring-Agenten und des 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 Beobachtbarkeits-Agent installiert ist, installiert die Richtlinie den Agenten, aber der Agent kann nicht ausgeführt werden, da ein Konflikt erkannt wird.

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

Erforderliche APIs für die Verwendung des Ops-Agents 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 in Ihrem Google Cloud -Projekt aktivieren.

Erforderliche Rollen zum Aktivieren von APIs

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 Inhaberrolle (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

Für die Verwendung des Ops-Agents erforderliche Rollen 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-Agenten finden Sie unter Ops-Agenten autorisieren.

Von VM Extension Manager verwendete API aktivieren

VM Extension Manager verwendet die Compute Engine API. Aktivieren Sie diese API in Ihrem Google Cloud -Projekt, falls sie noch nicht aktiviert ist.

Compute Engine API aktivieren

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, um die Berechtigungen zu erhalten, die Sie zum Erstellen von VM-Erweiterungsrichtlinien benötigen:

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

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Erstellen von 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:

  • So erstellen Sie Erweiterungsrichtlinien: compute.vmExtensionPolicies.create

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 mit der Google Cloud Console oder der Google Cloud CLI (gcloud) erstellen und verwalten. Wenn Sie gcloud 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

Richtlinienkonflikte und ‑prioritäten

Der VM Extension Manager verknüpft jede neue Richtlinie mit einer Priorität. 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-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 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 festzulegen, wie eine Richtlinie auf Ziel-VMs verteilt wird. Es gibt zwei Arten von Roll-out-Plänen:

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

    • Langsamer Roll-out, bei dem der Ops-Agent über einen bestimmten Zeitraum schrittweise in verschiedenen Zonen bereitgestellt wird. Dieser Roll-out-Plan wird empfohlen.

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

    • Schnelles Roll-out, bei dem der Ops-Agent sofort auf allen Ziel-VMs in allen Zonen und Regionen bereitgestellt wird.

      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.

    Sie können benutzerdefinierte Roll-out-Pläne erstellen, indem Sie sie der Gruppe von Roll-out-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.

VM-Erweiterungsrichtlinien zum Installieren des Ops-Agents erstellen

Mit VM Extension Manager erstellen Sie Richtlinien, in denen Sie deklarieren, welche Erweiterungen Sie auf VMs installieren möchten. Der Ops-Agent ist eine der verfügbaren Erweiterungen. Durch die Definition einer Richtlinie können Sie dafür sorgen, dass unterstützte Erweiterungen, einschließlich des Ops-Agents, auf allen VMs installiert und verwaltet werden, die den von Ihnen angegebenen Kriterien entsprechen, z. B. VM-Labels.

Mit Erweiterungsrichtlinien für den Ops-Agenten können Sie Aufgaben wie die folgenden ausführen:

  • Flottenweite Installation: Installieren Sie den Ops-Agenten auf folgenden Systemen:

    • 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 allen Zonen Ihres Google Cloud -Projekts, 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.

In den folgenden Abschnitten finden Sie Beispiele für Richtlinien, mit denen der Ops-Agent nach bestimmten Kriterien installiert wird.

VM Extension Manager unterstützt die Ops-Agent-Version 2.58.0 oder höher, wenn der Ops-Agent über eine Erweiterungsrichtlinie installiert wurde. VM Extension Manager kann keine früheren Versionen des Ops-Agenten, Ops-Agent-Instanzen, die auf andere Weise installiert wurden, oder den Legacy-Monitoring-Agenten oder Logging-Agenten verwalten.

Aktuellen Ops-Agent auf allen VMs installieren

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

Console

Zum Erstellen einer zonalen Richtlinie können Sie die Google Cloud Console verwenden.

  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 lösen. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1.000.
  6. Wählen Sie in der Liste Zone die Zone aus, auf die 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 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 verwendet die Option --version. Wenn Sie die Option --version weglassen, wird mit der Richtlinie die neueste Version installiert und der Ops-Agent aktualisiert, wenn eine neue Version veröffentlicht wird.

Ops-Agent auf allen VMs an eine bestimmte Version anpinnen

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

Console

Zum Erstellen einer zonalen Richtlinie können Sie die Google Cloud Console verwenden.

  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 lösen. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1.000.
  6. Wählen Sie in der Liste Zone die Zone aus, auf die 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 Sie installieren möchten. 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 zu installierende Version des Ops-Agents. Verwenden Sie Version 2.58.0 oder höher.

    Wenn Sie die Option --version weglassen, installiert die Richtlinie die aktuelle Version und aktualisiert den Ops-Agent, wenn eine neue Version veröffentlicht wird, wie im Beispiel gezeigt, in dem die aktuelle Version installiert 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 \
  --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 zu installierende Version des Ops-Agents. Verwenden Sie Version 2.58.0 oder höher.

    Wenn Sie die Option --version weglassen, installiert die Richtlinie die aktuelle Version und aktualisiert den Ops-Agent, wenn eine neue Version veröffentlicht wird, wie im Beispiel gezeigt, in dem die aktuelle Version installiert wird.

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

Ops-Agent auf VMs mit einem bestimmten Label installieren

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

Console

Zum Erstellen einer zonalen Richtlinie können Sie die Google Cloud Console verwenden.

  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 lösen. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1.000.
  6. Wählen Sie in der Liste Zone die Zone aus, auf die 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 des Befehls 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) enthalten, um berücksichtigt zu werden. Wenn Sie die Option --inclusion_labels mehrmals angeben, gilt die Richtlinie für 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 des Befehls 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) enthalten, um berücksichtigt zu werden. Wenn Sie die Option --inclusion_labels mehrmals angeben, gilt die Richtlinie für 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 installieren

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

Console

Zum Erstellen einer zonalen Richtlinie können Sie die Google Cloud Console verwenden.

  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 lösen. Niedrigere Zahlen bedeuten eine höhere Priorität. Der Standardwert ist 1.000.
  6. Wählen Sie in der Liste Zone die Zone aus, auf die 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 des Befehls 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-Agent 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-Agenten 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 zu versuchen, 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 des Befehls 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-Agent 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-Agenten 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 zu versuchen, 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 Agenten nicht manuell neu starten.

Die Konfiguration wird mit der Erweiterungsrichtlinie gespeichert. Nehmen Sie daher keine sensiblen Daten wie Passwörter in die Konfiguration auf. Da die Konfiguration mit der Erweiterungsrichtlinie gespeichert wird, ändert sich die Konfiguration des Agents nicht, wenn Sie die Konfigurationsdatei ändern. Sie müssen die mit der Richtlinie gespeicherte Konfiguration mit dem entsprechenden gcloud-Befehl aktualisieren:

Wenn Sie eine benutzerdefinierte Konfiguration für den Ops-Agenten bereitstellen, kopiert der VM Extension Manager die Konfiguration an den Speicherort, der vom Ops-Agenten für benutzerdefinierte Konfigurationsdateien auf der Ziel-VM 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 von der Erweiterungsrichtlinie überschrieben.

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

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

Verwenden Sie den folgenden gcloud compute global-vm-extension-policies create-Befehl, um eine globale Richtlinie zu erstellen, die die neueste Version des Ops-Agents mit einer höheren Priorität als der Standardpriorität und dem Plan für schnelles Roll-out installiert:

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 auf 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, auf die die Richtlinie angewendet werden soll. Informationen zum Erstellen benutzerdefinierter Roll-out-Pläne finden Sie unter Informationen zu Roll-out-Plänen. 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 mit einem benutzerdefinierten Roll-out-Plan zu erstellen:

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.

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 Console-Seiten, 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 das Label Ops-Agent im Compute Engine- oder Monitoring-Dashboard.

Prüfen, ob der Ops-Agent Telemetriedaten erfasst

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

Nächste Schritte