Monitoring-Agent auf einzelnen VMs installieren

Dies ist ein Legacy-Agent. Obwohl dieser Agent unter Linux noch unterstützt wird, wird von seiner Verwendung für neue Google Cloud-Arbeitslasten abgeraten.

Stattdessen empfehlen wir die Verwendung des Ops-Agents für neue Google Cloud-Arbeitslasten und die Umstellung Ihrer vorhandenen Compute Engine-VMs auf die Verwendung des Ops-Agents. Der Ops-Agent, der die Erfassung von Messwerten und das Logging in einem einzelnen Agent kombiniert, ist der Ersatz für die Legacy-Agents.

Der Ops-Agent wird aktiv weiterentwickelt. Es kann jedoch einige Anwendungsfälle geben, die er nicht unterstützt. Wenn der Ops-Agent Ihren Anwendungsfall nicht unterstützt, können Sie weiterhin den Monitoring-Agent unter Linux verwenden.

Für den Legacy-Monitoring-Agent wird es keine neue Feature-Entwicklung und keine Unterstützung für neue Betriebssysteme geben.

Unter Windows wird dringend davon abgeraten, den Legacy-Monitoring-Agent zu verwenden. Der Legacy-Monitoring-Agent unter Windows wird nicht unterstützt und alle seine Features sind im Ops-Agent verfügbar. Für das Monitoring von Windows-Instanzen wird dringend die Verwendung des Ops-Agents empfohlen. Wenn Sie jedoch den Legacy-Logging-Agent unter Windows ausführen und Messwerte erfassen müssen, müssen Sie den Legacy-Monitoring-Agent verwenden. Sie können den Ops-Agent und einen Legacy-Agent nicht auf derselben Maschine ausführen.

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

Hinweis

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

Eine unterstützte VM-Instanz in einem Google Cloud-Projekt oder Amazon Web Services-Konto (AWS-Konto).
- Mindestens 250 MB an residentem Arbeitsspeicher (RSS) werden zum Ausführen des Monitoring-Agents empfohlen.
Achten Sie außerdem darauf, dass auf der VM ein unterstütztes Betriebssystem ausgeführt wird.
Anmeldedaten für die VM-Instanz, um die Kommunikation mit Cloud Logging oder Cloud Monitoring zu autorisieren. Compute Engine-VM-Instanzen haben standardmäßig die korrekten Anmeldedaten. Wenn eines der nachfolgenden Szenarien auf Sie zutrifft, verfügen Sie möglicherweise nicht über die richtigen Anmeldedaten. Folgen Sie dann den Schritten unter Agent autorisieren:
- Sie führen AWS EC2-VM-Instanzen aus und müssen auf den VMs Autorisierungsdaten installieren, bevor Sie den Agent installieren.
- Sie führen sehr alte Compute Engine-Instanzen oder Compute Engine-Instanzen aus, die ohne die Standardanmeldedaten erstellt wurden.
Führen Sie die Schritte unter Anmeldedaten für Compute Engine prüfen aus, um zu prüfen, ob Sie die richtigen Anmeldedaten haben.
Gehen Sie für AWS-Nutzer so vor:
1. Verbinden Sie Ihr AWS-Konto mit einer Google Cloud. Informationen zu diesem Vorgang finden Sie unter Messwerte aus AWS-Konten erfassen.
  
  Hinweis: Wenn Sie Ihr AWS-Konto mit einer Google Cloud verbinden, erstellen Sie ein AWS-Connector-Projekt. Damit diese Projekte leicht identifiziert werden können, empfehlen wir, dass Ihre AWS-Connector-Projekte einer Namenskonvention folgen.
2. Weitere Informationen finden Sie im Abschnitt Google Cloud-Projekte für AWS EC2-VM-Instanzen.
Preisinformationen finden Sie unter Preise für Google Cloud Observability.
Wenn Sie VMs verwenden, die keinen Zugriff auf Remote-Paket-Repositories haben, lesen Sie die Informationen unter VMs ohne Remote-Paketzugriff.

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

Stellen Sie mit SSH oder einem ähnlichen Tool eine Terminalverbindung zu Ihrer VM-Instanz her und prüfen Sie, ob Sie sudo-Zugriff haben.
Wechseln Sie in ein Verzeichnis, auf das Sie Schreibzugriff haben, z. B. Ihr Basisverzeichnis.
Laden Sie das Agent-Installationsskript mit den folgenden Befehlen herunter und führen Sie es aus:
```
curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
sudo bash add-monitoring-agent-repo.sh --also-install
```
Nach der Installation wird der Agent automatisch gestartet.

Windows

Stellen Sie mithilfe von RDP oder einem ähnlichen Tool eine Verbindung zu Ihrer Instanz her und melden Sie sich bei Windows an.
Ö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.

Führen Sie die folgenden PowerShell-Befehle aus:

(New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe")
& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe"

Bestimmte Version des Agents installieren

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

Linux

Stellen Sie mit SSH oder einem ähnlichen Tool eine Terminalverbindung zu Ihrer VM-Instanz her und prüfen Sie, ob Sie sudo-Zugriff haben.
Wechseln Sie in ein Verzeichnis, auf das Sie Schreibzugriff haben, z. B. Ihr Basisverzeichnis.
Laden Sie das Agent-Installationsskript herunter:
```
curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
```
Beim Ausführen des Skripts add-monitoring-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.
Weitere Informationen und beispielhafte Nutzung finden Sie in den Skriptkommentaren.
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-monitoring-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*
```
  Führen Sie beispielsweise folgenden Befehl aus, um die 6.x.x des Agents anzuheften:
```
sudo bash add-monitoring-agent-repo.sh --also-install \
  --version=6.*.*
```
3. Führen Sie folgenden Befehl aus, um eine bestimmte Version des Agents zu installieren:
```
sudo bash add-monitoring-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
```
Agent-Dienst starten
```
sudo service stackdriver-agent start
```

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 service stackdriver-agent status
```
Der Status des Agents sollte OK sein.

Sie können auch die Logs untersuchen, um zu prüfen, ob Fehler vorliegen:
```
sudo grep collectd /var/log/{syslog,messages} | tail
```

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

Windows

Stellen Sie mithilfe von RDP oder einem ähnlichen Tool eine Verbindung zu Ihrer Instanz her und melden Sie sich bei Windows an.
Ö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.

Hinweis: Auf VM-Instanzen mit Windows wird nur die neueste Version des Agents unterstützt. Es wird nicht empfohlen, frühere Versionen zu installieren.
1. Führen Sie die folgenden PowerShell-Befehle aus:
```
(New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe")
& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe"
```
Alternativ können Sie die folgende URL aufrufen, um das Installationsprogramm des Agents herunterzuladen und auszuführen:

https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe

Achtung: Sie müssen das Installationsprogramm in ein Verzeichnis außerhalb des Systemverzeichnisses herunterladen, z. B. C:\Users\[USERNAME]. Das Installationsprogramm wird aus Sicherheitsgründen nicht aus Systemverzeichnissen und dem Verzeichnis C:\ ausgeführt.
Wenn Sie das Installationsprogramm in ein Systemverzeichnis heruntergeladen haben, verschieben Sie es vor dem Ausführen in ein anderes Verzeichnis.
Hinweis: Das Agent-Installationsprogramm unterstützt auch die Option /S (silent), die in Installationsskripts verwendet werden kann.

Wenn Sie den Agent automatisch installieren möchten, hängen Sie beim Aufruf des Installationsprogramms die Option /S an:
```
& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S
```
Achtung: Die automatische Installation ist ein asynchroner Vorgang. Wenn der Installationsbefehl beendet ist, ist der Agent noch nicht installiert. Sie können prüfen, ob die Installation erfolgreich war, indem Sie nach dem Dienst StackdriverMonitoring suchen.
Hinweis: Der Agent wird vom Installationsprogramm standardmäßig im Verzeichnis "C:\Programme (x86)\Stackdriver\Google Cloud ObservabilityAgent" abgelegt. Sie können das Verzeichnis während der Installation ändern.

Verwenden Sie im automatischen Modus die Option /D, um das Installationsverzeichnis anzugeben. Beispiel:
```
& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S /D="C:\Stackdriver\Google Cloud Observability\"
```
Sie können das Installationsprogramm nach erfolgreichem Abschluss löschen.

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

Agent-Informationen mithilfe der Google Cloud Console aufrufen

Statusinformationen zum Agent finden Sie auf dem vorkonfigurierten Monitoring-Dashboard VM-Instanzen. So erreichen Sie dieses Dashboard:

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

Optionale Aufgaben

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

Monitoring-Agent konfigurieren

Informationen zum Anpassen der Agent-Konfiguration finden Sie im Abschnitt zum Konfigurieren des Monitoring-Agents.

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

Bearbeiten Sie die folgende Konfigurationsdatei (erstellen Sie die Datei, falls sie noch nicht vorhanden ist):
- Bearbeiten Sie für Agent-Versionen ab 6.0.0 Folgendes:
```
/etc/default/stackdriver-agent
```
- Bearbeiten Sie für Agent-Versionen vor 6.0.0 die entsprechende Datei für Ihr Betriebssystem:
  
  Bearbeiten Sie für Debian und Ubuntu:
```
/etc/default/stackdriver-agent
```
  Bearbeiten Sie für CentOS und SLES:
```
/etc/default/stackdriver-collectd
```
  Hinweis: Wenn diese Datei nicht existiert, erstellen Sie sie.

Fügen Sie der Datei Folgendes hinzu.

 export http_proxy="http://proxy-ip:proxy-port"
 export https_proxy="http://proxy-ip:proxy-port"
 export no_proxy=169.254.169.254  # Skip proxy for the local Metadata Server.

Starten Sie den Agent neu. Dazu führen Sie den folgenden Befehl auf der VM-Instanz aus:
```
 sudo service stackdriver-agent restart
```

Windows

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 169.254.169.254 /m
```

Agent-Version ermitteln

Die Version des Monitoring-Agents auf Ihrem System können Sie ermitteln, indem Sie auf Ihrer VM-Instanz folgende Befehle ausführen:

AMAZON LINUX AMI/CENTOS/RHEL

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

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' stackdriver-agent

DEBIAN/UBUNTU

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

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

SLES/SUSE

Führen Sie unter SUSE den folgenden Befehl aus:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' stackdriver-agent

WINDOWS

Unter Windows gibt es derzeit keine Möglichkeit, die Version des Monitoring-Agents festzustellen.

Agent neu starten

Sie müssen den Monitoring-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 service stackdriver-agent restart

Windows

Stellen Sie mithilfe von RDP oder einem ähnlichen Tool eine Verbindung zu Ihrer Instanz her und melden Sie sich bei Windows an.
Ö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.
Führen Sie den folgenden PowerShell-Befehl aus:

Restart-Service -Name StackdriverMonitoring

Agent-Upgrade durchführen

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

Linux

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

sudo bash add-monitoring-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-monitoring-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

Installieren Sie den neuesten Agent wie im Abschnitt Unter Windows installieren auf dieser Seite beschrieben, um ein Upgrade auf die aktuelle Agent-Version durchzuführen. Das Installationsprogramm fordert Sie auf, die vorherige Version des Agents zu deinstallieren.

Alle Agent-Versionen auflisten

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

AMAZON LINUX AMI/CENTOS/RHEL

Listen Sie die verfügbaren Versionen des Agents auf:

sudo yum list --showduplicates stackdriver-agent

DEBIAN/UBUNTU

Listen Sie die verfügbaren Versionen des Agents auf:

sudo apt-cache madison stackdriver-agent

SLES/SUSE

Listen Sie die verfügbaren Versionen des Agents auf:

sudo zypper search -s stackdriver-agent

WINDOWS

Das Installieren früherer Versionen des Agents unter Windows wird nicht unterstützt.

Agent deinstallieren

Folgen Sie der nachstehenden Anleitung, um den Monitoring-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-monitoring-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

Wählen Sie in der Systemsteuerung von Windows Programm deinstallieren aus. Der Monitoring-Agent sollte in der Liste der deinstallierbaren Programme aufgeführt sein. Sie können uninstall.exe auch in dem Verzeichnis ausführen, in dem Sie den Monitoring-Agent installiert haben.

Informationen zu Google Cloud-Projekten für AWS EC2-VM-Instanzen

Wenn sich die Dokumentation auf das mit der VM-Instanz verknüpfte Google Cloud-Projekt bezieht, ist damit bei EC2-VM-Instanzen das AWS-Connector-Projekt gemeint, das mit Ihrem AWS-Konto verknüpft ist.

Wenn Sie Ihr AWS-Konto mit einer Google Cloud verbinden, erstellen Sie ein AWS-Connector-Projekt. Informationen zu diesem Vorgang finden Sie unter Messwerte aus AWS-Konten erfassen.

Führen Sie einen der folgenden Schritte aus, um auf das AWS-Connector-Projekt für ein AWS-Konto zuzugreifen:

Verwenden Sie die Projektauswahl der Google Cloud Console, um die Projekte zu ermitteln, die den Namenskonventionen für Ihr AWS-Connector-Projekt entsprechen, und wählen Sie dann das spezifische Projekt für Ihr AWS-Konto aus.
Ermitteln Sie das Google Cloud-Projekt, dessen Messwertbereich Ihre AWS-Kontomesswerte enthält, und wählen Sie dieses Projekt in der Projektauswahl der Google Cloud Console aus. Rufen Sie für dieses Google Cloud-Projekt die Seite Monitoring auf und wählen Sie die Seite Einstellungen aus. Auf der Seite Einstellungen werden die AWS-Connector-Projekte aufgelistet. Verwenden Sie die Projektauswahl der Google Cloud Console, um auf das AWS-Connector-Projekt zuzugreifen.

VMs ohne Remote-Paketzugriff

Die Installation des Monitoring-Agents erfordert Zugriff auf Remote Package 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

Logs, die der Agent mithilfe seiner Standardkonfiguration an Cloud Logging sendet.