Ops-Agent auf einzelnen VMs 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"
   

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. Informationen zu Versionen 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. Informationen zu Versionen 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.

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:

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 Der 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 auch 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. Betriebssystemrichtlinien des Ops-Agents werden nicht von 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 Agenten 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. Betriebssystemrichtlinien des Ops-Agents werden nicht von 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.

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
   

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

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

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
   

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

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