Cloud Logging-Agent auf einzelnen VMs installieren

Der Logging-Agent streamt Logs von VM-Instanzen und ausgewählten Drittanbieter-Softwarepaketen an Cloud Logging. Es empfiehlt sich, den Logging-Agent auf allen VM-Instanzen auszuführen.

In den VM-Images für Compute Engine und Amazon Elastic Compute Cloud (EC2) ist der Logging-Agent nicht enthalten. Führen Sie deshalb die folgenden Schritte aus, um ihn auf diesen Instanzen zu installieren. Der Agent ist mit Linux und Microsoft Windows kompatibel.

Wenn die VMs in Google Kubernetes Engine oder App Engine ausgeführt werden, ist der Agent bereits im VM-Image enthalten. Sie können diese Seite dann überspringen.

Wenn Sie spezielle Logging-Arbeitslasten ausführen, für die im Vergleich zum standardmäßigen Cloud Logging-Agent ein höherer Durchsatz und/oder eine höhere Ressourceneffizienz erforderlich ist, sollten Sie den Ops-Agent verwenden.

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

    • Bei der Installation des Logging-Agents werden mindestens 250 MiB Arbeitsspeicher benötigt, 1 GiB wird jedoch 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 enthalten die richtigen Anmeldedaten in der Regel standardmäßig. 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 für AWS-Konten ansehen.

    2. Weitere Informationen finden Sie im Abschnitt Google Cloud-Projekte für AWS EC2-VM-Instanzen.

  • Preisinformationen finden Sie unter Preise für die Operations-Suite von Google Cloud.

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

Neueste 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. Ausführen:

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

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/windows/StackdriverLogging-v1-17.exe", "${env:UserProfile}\StackdriverLogging-v1-17.exe")
    & "${env:UserProfile}\StackdriverLogging-v1-17.exe"
    

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-logging-agent-repo.sh
    

    Beim Ausführen des Skripts add-logging-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.
    • --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. Informationen zum Auflisten der verfügbaren Agent-Versionen sowie zur Auswahl der zu installierenden Version 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-logging-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.*.*
      

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

      sudo bash add-logging-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-logging-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
      
  5. Agent-Dienst neu starten

    Ein Neustart ist erforderlich, damit die Konfigurationen, die von den oben genannten Catch-all-Paketen installiert werden, wirksam werden.

    sudo service google-fluentd restart
    

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 google-fluentd status
    

    Der Status des Agents sollte OK sein.

  • Sie können auch die Logs untersuchen, um zu prüfen, ob Fehler vorliegen:

    tail /var/log/google-fluentd/google-fluentd.log
    

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.

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

      (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-17.exe", "${env:UserProfile}\StackdriverLogging-v1-17.exe")
      & "${env:UserProfile}\StackdriverLogging-v1-17.exe"
      

    Alternativ können Sie die folgende URL aufrufen, um das Installationsprogramm des Agents herunterzuladen und auszuführen:

    https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-17.exe

    Wenn Sie den Agent automatisch installieren möchten, hängen Sie beim Aufruf des Installationsprogramms die Option /S an:

    & "${env:UserProfile}\StackdriverLogging-v1-17.exe" /S
    

    Verwenden Sie im automatischen Modus die Option /D, um das Installationsverzeichnis anzugeben. Beispiel:

    & "${env:UserProfile}\StackdriverLogging-v1-17.exe" /S /D="C:\Stackdriver\Logging\"
    

    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 mithilfe der Google Cloud Console installieren

Sie können den Agent auf einer oder mehreren Compute Engine-VMs über das vorkonfigurierte Monitoring-Dashboard VM-Instanzen installieren.

So erreichen Sie dieses Dashboard:

  1. Wählen Sie in der Cloud Console Ihr Google Cloud-Projekt aus.

    Zur Cloud Console

  2. Wählen Sie im Navigationsbereich Monitoring aus.

  3. Wählen Sie im Navigationsbereich „Monitoring“ die Option Dashboards aus.

  4. Suchen Sie in der Tabelle der Dashboards nach dem Eintrag VM-Instanzen und klicken Sie auf den Namen.

Auf dem Tab Inventar im Dashboard VM-Instanzen werden alle VMs aufgelistet. Wie im folgenden Screenshot gezeigt, ist eine Statusspalte für den Agent enthalten:

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

Die Spalte Agent meldet die folgenden Werte:

  • Nicht erkannt: Sie haben keinen Agent installiert. Wenn Cloud Monitoring keine auf der Compute Engine-Instanz installierten Agents erkennt, können Sie einen Agent so installieren:

    • Wählen Sie die VM-Instanzen aus, auf denen Sie Agents installieren möchten.
    • Klicken Sie auf die Option Agents installieren in der Tabelle Instanzen, was im Dashboard einen Installationsworkflow auslöst, und folgen Sie der Anleitung. Der Ops-Agent ist der Standard-Agent, der installiert wird. Der Installationsworkflow enthält jedoch einen Link zum Installieren der Legacy-Agents.

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

  • Ops-Agent: Sie führen den Ops-Agent aus.

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

  • VM angehalten: Die VM wird nicht ausgeführt, sodass der Status des Agents nicht bekannt ist.

Optionale Aufgaben

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

Strukturiertes Logging aktivieren

Wenn Sie das Installationsskript auf einer Linux-VM ausführen, installiert das Skript standardmäßig das Paket google-fluentd-catch-all, wenn das Flag --also-install vorhanden ist. Führen Sie die folgenden Schritte aus, um zum strukturierten Logging zu wechseln.

  1. Sichern Sie alle lokalen Änderungen in /etc/google-fluentd/config.d/.

  2. Führen Sie je nach Linux-Distribution einen der folgenden Befehle aus:

    • YUM:

      sudo yum remove -y google-fluentd-catch-all-config
      sudo yum install -y google-fluentd-catch-all-config-structured
      sudo service google-fluentd restart
      
    • APT:

      sudo apt-get remove -y google-fluentd-catch-all-config
      sudo apt-get install -y google-fluentd-catch-all-config-structured
      sudo service google-fluentd restart
      

Informationen zum strukturierten Logging finden Sie im Leitfaden Strukturiertes Logging.

Agent konfigurieren

Der Agent ist vorkonfiguriert, um bestimmte bekannte Log-Speicherorte zu überwachen. Unter Linux werden diese Speicherorte im Paket google-fluentd-catch-all-config beschrieben, das automatisch vom Installationsskript übernommen wird. Unter Windows überwacht der Agent standardmäßig das Windows-Ereignislog.

Informationen zum Anpassen der Agent-Konfiguration finden Sie unter Agent konfigurieren.

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/default/google-fluentd
    
  2. 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.
    
  3. Starten Sie den Agent neu. Dazu führen Sie den folgenden Befehl auf der VM-Instanz aus:

     sudo service google-fluentd restart
    

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 festgelegt, damit der Agent Daten über ausgehendes HTTPS 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

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

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' \
     google-fluentd ∖
     google-fluentd-catch-all-config ∖
     google-fluentd-catch-all-config-structured

DEBIAN/UBUNTU

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

dpkg-query --show --showformat \
    '${Package} ${Version} ${Architecture} ${Status}\n' \
     google-fluentd ∖
     google-fluentd-catch-all-config ∖
     google-fluentd-catch-all-config-structured

SLES/SUSE

Führen Sie unter SUSE den folgenden Befehl aus:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' \
     google-fluentd ∖
     google-fluentd-catch-all-config ∖
     google-fluentd-catch-all-config-structured

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:

     reg query HKLM\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\GoogleStackdriverLoggingAgent\ /v Version
    

Agent neu starten

Sie müssen den Logging-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 google-fluentd restart

Nach dem Neustart des Logging-Agents können Sie eine Testnachricht senden.

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 -Name StackdriverLogging

Agent-Upgrade durchführen

Folgen Sie dieser Anleitung, um den Logging-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-logging-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-logging-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 google-fluentd

DEBIAN/UBUNTU

Listen Sie die verfügbaren Versionen des Agents auf:

sudo apt-cache madison google-fluentd

SLES/SUSE

Listen Sie die verfügbaren Versionen des Agents auf:

sudo zypper search -s google-fluentd

WINDOWS

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

Agent deinstallieren

Folgen Sie der nachstehenden Anleitung, um den Logging-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-logging-agent-repo.sh --uninstall

Windows

Wählen Sie in der Systemsteuerung von Windows Programm deinstallieren aus. Der Logging-Agent sollte in der Liste der deinstallierbaren Programme aufgeführt sein.

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 für AWS-Konten ansehen.

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

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