Ops-Agent auf einzelnen VMs installieren

Der Ops-Agent erfasst Logs und Messwerte auf Compute Engine-Instanzen und sendet Ihre Logs an Cloud Logging und Ihre Messwerte an Cloud Monitoring.

Hinweise

Prüfen Sie vor der Installation des Agents, ob folgende Komponenten vorhanden sind:

Agent während der VM-Erstellung automatisch installieren

Weitere Informationen finden Sie unter Ops-Agent während der VM-Erstellung installieren.

Agent über die Befehlszeile installieren

Folgen Sie dieser Anleitung, um den Agent über die Befehlszeile zu installieren.

Aktuelle Version des Agents installieren

Führen Sie die folgenden Schritte aus, um die neueste Version des Agents zu installieren.

Linux

  1. Stellen Sie mit SSH oder einem ähnlichen Tool eine Terminalverbindung zu Ihrer VM-Instanz her und prüfen Sie, ob Sie sudo-Zugriff haben.

  2. Wechseln Sie in ein Verzeichnis, auf das Sie Schreibzugriff haben, z. B. Ihr Basisverzeichnis.

  3. Laden Sie das Agent-Installationsskript mit den folgenden Befehlen herunter und führen Sie es aus:

    curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh
    sudo bash add-google-cloud-ops-agent-repo.sh --also-install
    

    Nach der Installation wird der Agent automatisch gestartet.

Windows

  1. Stellen Sie mithilfe von RDP oder einem ähnlichen Tool eine Verbindung zu Ihrer Instanz her und melden Sie sich bei Windows an.

  2. Öffnen Sie ein PowerShell-Terminal mit Administratorberechtigungen. Klicken Sie dazu mit der rechten Maustaste auf das PowerShell-Symbol und wählen Sie Als Administrator ausführen aus.

  3. Führen Sie die folgenden PowerShell-Befehle aus:

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")
    Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall"
    

Bestimmte Version des Agents installieren

Führen Sie die folgenden Schritte aus, um eine bestimmte Version des Agents zu installieren:

Linux

  1. Stellen Sie mit SSH oder einem ähnlichen Tool eine Terminalverbindung zu Ihrer VM-Instanz her und prüfen Sie, ob Sie sudo-Zugriff haben.

  2. Wechseln Sie in ein Verzeichnis, auf das Sie Schreibzugriff haben, z. B. Ihr Basisverzeichnis.

  3. Laden Sie das Agent-Installationsskript herunter:

    curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh
    

    Beim Ausführen des Skripts add-google-cloud-ops-agent-repo.sh können Sie auch die folgenden Flags festlegen:

    • --verbose: Aktiviert das ausführliche Logging während der Skriptausführung.
    • --also-install: Installiert den Agent nach dem Hinzufügen des Agent-Paket-Repositorys.
    • --version: Legt die Agent-Version fest, die vom Skript installiert werden soll. Versionsinformationen finden Sie unter Alle Agent-Versionen auflisten.
    • --uninstall: Deinstalliert den Agent.
    • --remove-repo: Entfernt das entsprechende Agent-Paket-Repository nach der Installation oder Deinstallation des Agents.
    • --dry-run: Löst nur einen Probelauf der Skriptausführung aus und gibt die Befehle aus, die ausgeführt werden sollen.
    • --uninstall-standalone-logging-agent: Deinstalliert den Legacy-Logging-Agent (StackdriverLogging).
    • --uninstall-standalone-monitoring-agent: Deinstalliert den Legacy-Monitoring-Agent (StackdriverMonitoring).

    Weitere Informationen und beispielhafte Nutzung finden Sie in den Skriptkommentaren.

  4. Fügen Sie das Paket-Repository des Agents hinzu und installieren Sie den Agent:

    1. Eine Liste der verfügbaren Agent-Versionen finden Sie unter Alle Agent-Versionen auflisten.

    2. In Produktionsumgebungen empfiehlt es sich, eine Hauptversion anzuhängen, um das Installieren von Hauptversionen zu vermeiden, die möglicherweise abwärtsinkompatible Änderungen enthalten. Zum Anhängen einer Hauptversion führen Sie folgenden Befehl aus:

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.*.*
      

      Beispiel: Der folgende Befehl hängt die 1.xx-Version des Agents an:

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
        --version=1.*.*
      
    3. Führen Sie folgenden Befehl aus, um eine bestimmte Version des Agents zu installieren:

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
      

Sie können das Installationsskript nach erfolgreicher Ausführung löschen.

  • Führen Sie folgenden Befehl aus, um zu prüfen, ob der Agent wie erwartet funktioniert:

    sudo systemctl status google-cloud-ops-agent"*"
    

    Prüfen Sie, ob die Komponenten "Logging-Agent" und "Messwert-Agent" ausgeführt werden.

Wenn Sie Probleme mit der Installation haben, lesen Sie die Informationen auf der Seite Fehlerbehebung.

Windows

  1. Stellen Sie mithilfe von RDP oder einem ähnlichen Tool eine Verbindung zu Ihrer Instanz her und melden Sie sich bei Windows an.

  2. Öffnen Sie ein PowerShell-Terminal mit Administratorberechtigungen. Klicken Sie dazu mit der rechten Maustaste auf das PowerShell-Symbol und wählen Sie Als Administrator ausführen aus.

  3. Laden Sie das Agent-Installationsskript herunter:

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")
    

    Beim Ausführen des Skripts add-google-cloud-ops-agent-repo.ps1 können Sie auch die folgenden Flags festlegen:

    • -Verbose: Aktiviert das ausführliche Logging während der Skriptausführung.
    • -AlsoInstall: Installiert den Agent nach dem Hinzufügen des Agent-Paket-Repositorys.
    • -Version: Legt die Agent-Version fest, die vom Skript installiert werden soll. Versionsinformationen finden Sie unter Alle Agent-Versionen auflisten.
    • -Uninstall: Deinstalliert den Agent.
    • -RemoveRepo: Entfernt das entsprechende Agent-Paket-Repository nach der Installation oder Deinstallation des Agents.
    • -WhatIf: Löst nur einen Probelauf der Skriptausführung aus und gibt die Befehle aus, die ausgeführt werden sollen.
    • -UninstallStandaloneLoggingAgent: Deinstalliert den Legacy-Logging-Agent (StackdriverLogging).
    • -UninstallStandaloneMonitoringAgent: Deinstalliert den Legacy-Monitoring-Agent (StackdriverMonitoring).

    Weitere Informationen und beispielhafte Nutzung finden Sie in den Skriptkommentaren.

  4. Fügen Sie das Paket-Repository des Agents hinzu und installieren Sie den Agent:

    1. Eine Liste der verfügbaren Agent-Versionen finden Sie unter Alle Agent-Versionen auflisten.

    2. In Produktionsumgebungen empfiehlt es sich, eine Hauptversion anzuhängen, um das Installieren von Hauptversionen zu vermeiden, die möglicherweise abwärtsinkompatible Änderungen enthalten. Zum Anhängen einer Hauptversion führen Sie folgenden Befehl aus:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version MAJOR_VERSION.*.*"
      

      Beispiel: Der folgende Befehl hängt die 1.x.x-Version des Agents an:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.*.*"
      
    3. Führen Sie folgenden Befehl aus, um eine bestimmte Version des Agents zu installieren:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version version-number"
      

      Beispiel:

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.0.1"
      

Sie können das Installationsskript nach erfolgreicher Ausführung löschen.

  • Führen Sie folgenden Befehl aus, um zu prüfen, ob der Agent wie erwartet funktioniert:

    Get-Service google-cloud-ops-agent
    

    Der Status des Agents sollte Running sein.

Wenn Sie Probleme mit der Installation haben, lesen Sie die Informationen auf der Seite Fehlerbehebung.

Agent mithilfe der Google Cloud Console installieren

Sie können den Ops-Agent mithilfe der Google Cloud Console über die Cloud Monitoring- oder Compute Engine-Seiten auf einer oder mehreren Compute Engine-VMs installieren.

Cloud Monitoring

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

Zum VM-Instanz-Dashboard

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

In der Ansicht Liste auf dem Tab Inventar im Dashboard werden alle VMs aufgelistet. Wie im folgenden Screenshot gezeigt, enthält die Liste eine Statusspalte für Ihren Agent:

Im Dashboard „VM-Instanzen“ in Monitoring wird der Status von Agents angezeigt.

Die Spalte Agent meldet die folgenden Werte:

  • Nicht erkannt: Entweder ist kein Agent installiert oder er wird nicht ausgeführt. Wenn Sie sich nicht sicher sind, ob Sie einen Agent installiert haben, können Sie die installierte Version abfragen. Wenn Sie den Agent installiert haben, können Sie den Agent neu starten. Wenn Sie den Ops-Agent installiert und gestartet haben, der Status aber weiterhin Nicht erkannt bleibt,: dann wurde der Agent möglicherweise nicht richtig gestartet oder kann keine Messwerte senden.

    Informationen zur Fehlerbehebung bei Startproblemen finden Sie unter Agent ist installiert, wird aber nicht ausgeführt. Informationen zur Fehlerbehebung bei Problemen mit der Messwertaufnahme finden Sie unter Fehlerbehebung: Datenaufnahme. Das allgemeine Script „agent-diagnostics“ und die Systemdiagnosen können ebenfalls hilfreich sein.

  • Ops-Agent: Sie führen den Ops-Agent aus. Wenn neben dem Eintrag kein grünes Häkchen angezeigt wird, ist je nach erkanntem Betriebssystem Ihrer VM ein Agent-Upgrade verfügbar.

    Wenn Sie den Mauszeiger auf den Ops-Agent-Indikator in der Tabelle bewegen, werden Informationen zur Version des Ops-Agents angezeigt. Wenn Sie eine ältere Version ausführen, wird auch eine Empfehlung zum Upgrade Ihres Agents angezeigt.

  • Ausstehend: Der Ops-Agent wird installiert oder aktualisiert.

    Wenn die Installation des Agents länger als zehn Minuten den Status Ausstehend hat, liegt möglicherweise ein Problem mit der Anwendung der Betriebssystemrichtlinie des Ops-Agents oder beim Starten des Agents vor. Informationen zur Fehlerbehebung finden Sie unter Agent-Diagnosetool für Richtlinien zur automatischen Installation.

  • Legacy-Agent: Sie führen den Legacy-Monitoring- oder den Logging-Agent aus. Weitere Informationen zur Umstellung auf den Ops-Agent finden Sie unter Von Legacy-Agents zum Ops-Agent migrieren.

  • Nicht zutreffend: Diese VM ist keine unterstützte Plattform zum Ausführen des Agents.

  • Unbekannt: Die VM wird nicht ausgeführt. Der Status des Agents ist also nicht bekannt.

So installieren Sie den Ops-Agent:

  • Wählen Sie die VM-Instanzen aus, auf denen Sie Agents installieren möchten.
  • Klicken Sie in der Tabelle Instanzen auf die Option Ops-Agent installieren/aktualisieren.

Sie können den Ops-Agent auch über die Seite VM-Details für eine bestimmte VM installieren.

Der Agent wird nach Möglichkeit mithilfe einer Ops-Agent-Betriebssystemrichtlinie installiert. Weitere Informationen finden Sie unter VMs verwalten, die von der Betriebssystemrichtlinie des Ops-Agents abgedeckt werden. Ops-Agent-Betriebssystemrichtlinien werden nicht auf allen Versionen aller Betriebssysteme unterstützt. In diesem Fall wird durch Klicken auf Ops-Agent installieren/aktualisieren eine Reihe von Befehlen bereitgestellt, die in Cloud Shell ausgeführt werden.

Der Ops-Agent erfasst standardmäßig Messwerte und Logs. Sie können dieses Standardverhalten ändern, indem Sie den Ops-Agent konfigurieren.

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. Klicken Sie auf den Namen der VM, auf der Sie den Agent installieren möchten.

  3. Klicken Sie auf den Tab Beobachtbarkeit.

  4. Klicken Sie auf Ops-Agent installieren.

    Der Agent wird nach Möglichkeit mithilfe einer Ops-Agent-Betriebssystemrichtlinie installiert. Weitere Informationen finden Sie unter VMs verwalten, die von der Betriebssystemrichtlinie des Ops-Agents abgedeckt werden. Ops-Agent-Betriebssystemrichtlinien werden nicht auf allen Versionen aller Betriebssysteme unterstützt. In diesem Fall wird durch Klicken auf Ops-Agent installieren/aktualisieren eine Reihe von Befehlen bereitgestellt, die in Cloud Shell ausgeführt werden.

    Der Ops-Agent erfasst standardmäßig Messwerte und Logs. Sie können dieses Standardverhalten ändern, indem Sie den Ops-Agent konfigurieren.

    Wenn die Installation des Agents länger als zehn Minuten den Status Ausstehend hat, liegt möglicherweise ein Problem mit der Anwendung der Betriebssystemrichtlinie des Ops-Agents oder beim Starten des Agents vor. Informationen zur Fehlerbehebung finden Sie unter Agent-Diagnosetool für Richtlinien zur automatischen Installation.

Prüfen Sie, ob der Ops-Agent ausgeführt wird.

Sie haben folgende Möglichkeiten, um zu prüfen, ob der Ops-Agent ausgeführt wird:

  • Dashboard VM-Instanzen: In diesem Dashboard können Sie den Status der Agent-Installation in Ihrer VM-Flotte aufrufen. Der Status kann jedoch ungenau sein, wenn der VM nicht die erforderlichen Zugriffsbereiche vorhanden sind oder das zugehörige Dienstkonto nicht genügend IAM-Rollen hat.

  • gcpdiag: gcpdiag bietet zuverlässigere und robustere Informationen zum Agent-Status als das Dashboard VM-Instanzen und prüft sowohl die Installation des Agents als auch die Übertragung von Telemetriedaten aus der VM. Die Verwendung von gcpdiag hat einige Voraussetzungen und bietet eine bessere Möglichkeit, den Agent-Status zu überwachen.

Dashboard VM-Instanzen verwenden

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

Zum VM-Instanz-Dashboard

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

Prüfen Sie dann, ob in der Spalte Agent für diese VM der Ops-Agent angegeben ist.

gcpdiag verwenden

Informationen zur Verwendung von gcpdiag finden Sie unter Agent-Status mit gcpdiag prüfen.

Optionale Aufgaben

In diesem Abschnitt wird beschrieben, wie Sie allgemeine Wartungsaufgaben durchführen.

HTTP-Proxy konfigurieren

Wenn Sie einen HTTP-Proxy für Proxy-Anfragen an die Logging API und Monitoring API verwenden, gehen Sie so vor:

Linux

  1. Bearbeiten Sie die folgende Konfigurationsdatei (erstellen Sie die Datei, falls sie noch nicht vorhanden ist):

     /etc/systemd/system.conf
    
  2. Fügen Sie der Datei Folgendes hinzu.

     DefaultEnvironment="HTTP_PROXY=http://proxy-ip:proxy-port" "HTTPS_PROXY=http://proxy-ip:proxy-port" "NO_PROXY=http://metadata.google.internal"  # Skip proxy for the local Metadata Server.
    
  3. Laden Sie die Umgebungsvariablen neu:

     sudo systemctl daemon-reload
    
  4. Starten Sie den Agent neu. Dazu führen Sie den folgenden Befehl auf der VM-Instanz aus:

     sudo systemctl restart google-cloud-ops-agent"*"
    

Windows

  1. Wenn Sie einen HTTP-Proxy verwenden, führen Sie den folgenden Befehl über eine Administrator-Eingabeaufforderung aus. Dadurch werden die Umgebungsvariablen HTTP_PROXY und HTTPS_PROXY so festgelegt, dass der Agent Daten über ausgehende HTTPS-Verbindungen senden kann:

    setx HTTP_PROXY http://proxy-ip:proxy-port /m
    setx HTTPS_PROXY http://proxy-ip:proxy-port /m
    setx no_proxy metadata.google.internal /m
    

Agent-Version ermitteln

Führen Sie die folgenden Befehle auf der VM-Instanz aus, um zu ermitteln, welche Ops-Agent-Version auf dem System vorhanden ist:

Google Cloud Console

So rufen Sie die Version Ihres Ops-Agents auf einer VM auf:

  • Suchen Sie den Eintrag für die VM in der Tabelle Instanzen auf der Monitoring-Seite VM-Instanzen. Informationen zur Navigation finden Sie unter Agent mithilfe der Google Cloud Console installieren.

  • Bewegen Sie den Mauszeiger über die Anzeige Ops-Agent im Tabelleneintrag.

CENTOS/RHEL

Führen Sie unter Red Hat oder CentOS Linux folgenden Befehl aus:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-cloud-ops-agent

DEBIAN/UBUNTU

Führen Sie unter Debian oder Ubuntu den folgenden Befehl aus:

dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' google-cloud-ops-agent

SLES/SUSE

Führen Sie unter SUSE den folgenden Befehl aus:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-cloud-ops-agent

WINDOWS

Führen Sie unter Windows den folgenden Befehl aus:

googet installed google-cloud-ops-agent

Agent neu starten

Sie müssen den Ops-Agent neu starten, damit Änderungen in den Konfigurationsdateien wirksam werden. Folgen Sie dieser Anleitung, um den Agent neu zu starten.

LINUX

Führen Sie folgenden Befehl für die Instanz aus:


     sudo systemctl restart google-cloud-ops-agent

Windows

  1. Stellen Sie mithilfe von RDP oder einem ähnlichen Tool eine Verbindung zu Ihrer Instanz her und melden Sie sich bei Windows an.

  2. Öffnen Sie ein PowerShell-Terminal mit Administratorberechtigungen. Klicken Sie dazu mit der rechten Maustaste auf das PowerShell-Symbol und wählen Sie Als Administrator ausführen aus.

  3. Führen Sie den folgenden PowerShell-Befehl aus:

Restart-Service google-cloud-ops-agent -Force

Agent-Upgrade durchführen

Folgen Sie dieser Anleitung, um den Ops-Agent auf die neueste Version zu aktualisieren:

Google Cloud Console

Sie können den Ops-Agent mithilfe der Cloud Monitoring-Installationsanleitung aktualisieren. Weitere Informationen finden Sie unter Agent mithilfe der Google Cloud Console installieren.

Linux

Führen Sie den folgenden Befehl aus, um den Agent auf die neueste Version zu aktualisieren:

sudo bash add-google-cloud-ops-agent-repo.sh --also-install

Führen Sie den folgenden Befehl aus, um den Agent auf den neuesten Point-Release einer bestimmten Hauptversion zu aktualisieren:

sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

So führen Sie ein Upgrade auf die neueste Agent-Version durch:

  1. Stellen Sie mithilfe von RDP oder einem ähnlichen Tool eine Verbindung zu Ihrer Instanz her und melden Sie sich bei Windows an.

  2. Öffnen Sie ein PowerShell-Terminal mit Administratorberechtigungen. Klicken Sie dazu mit der rechten Maustaste auf das PowerShell-Symbol und wählen Sie Als Administrator ausführen aus.

    Copy-Item -Path "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml" -Destination "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.bak"
    
  3. Führen Sie die folgenden PowerShell-Befehle aus, um den installierten Agent zu entfernen und den Installationsbefehl auszuführen:

    googet -noconfirm remove google-cloud-ops-agent
    googet -noconfirm install google-cloud-ops-agent
    

Alle Agent-Versionen auflisten

Führen Sie den folgenden Befehl aus, um die verfügbaren Versionen des Agents aufzulisten:

CENTOS/RHEL

Listen Sie die verfügbaren Versionen des Agents auf:

sudo yum list --showduplicates google-cloud-ops-agent

DEBIAN/UBUNTU

Listen Sie die verfügbaren Versionen des Agents auf:

sudo apt-cache madison google-cloud-ops-agent

SLES/SUSE

Listen Sie die verfügbaren Versionen des Agents auf:

sudo zypper search -s google-cloud-ops-agent

WINDOWS

Listen Sie die verfügbaren Versionen des Agents auf:

googet available google-cloud-ops-agent

Agent deinstallieren

Folgen Sie der nachstehenden Anleitung, um den Ops-Agent und seine Konfigurationsdateien zu entfernen.

Nachdem Sie den Agent deinstalliert haben, kann es bis zu eine Stunde dauern, bis diese Änderung in der Google Cloud Console gemeldet wird.

Linux

Führen Sie dazu diesen Befehl aus:

sudo bash add-google-cloud-ops-agent-repo.sh --uninstall

Wenn Sie das Repository zusätzlich zum Deinstallieren des Agents entfernen möchten, hängen Sie an den vorherigen Befehl --remove-repo an.

Windows

So deinstallieren Sie den Ops-Agent:

  1. Stellen Sie mithilfe von RDP oder einem ähnlichen Tool eine Verbindung zu Ihrer Instanz her und melden Sie sich bei Windows an.

  2. Öffnen Sie ein PowerShell-Terminal mit Administratorberechtigungen. Klicken Sie dazu mit der rechten Maustaste auf das PowerShell-Symbol und wählen Sie Als Administrator ausführen aus.

  3. Führen Sie den folgenden PowerShell-Befehl aus:

    googet -noconfirm remove google-cloud-ops-agent
    

VMs ohne Remote-Paketzugriff

Die Installation des Ops-Agents erfordert Zugriff auf Remote-Paket-Repositories, sowohl für das Agent-Paket als auch (unter Linux) für dessen Abhängigkeiten.

Wenn Sie VPC-SC oder ein privates Netzwerk verwenden, kann sich die Netzwerkkonfiguration auch auf die Installation von Agent-Abhängigkeiten aus vorgelagerten Repositories auswirken. Die Agent-Pakete selbst können über den privaten Google-Zugriff aufgerufen werden. Dies kann mit Privaten Google-Zugriff aktivieren konfiguriert werden.

Wenn die Sicherheitsrichtlinie Ihres VM-Hosts den Zugriff auf Remote-Paket-Repositories verweigert, wird empfohlen, ein benutzerdefiniertes VM-Image mit dem vorinstallierten Agent zu erstellen und die Paketverwaltung in diesem Image zu deaktivieren.

Nächste Schritte