Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Cloud Logging-Agent auf einer einzelnen VM 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.

  • Ein Arbeitsbereich zur Überwachung des AWS-Kontos, das die VM-Instanz enthält. Preisinformationen finden Sie unter Preise für die Operations-Suite von Google Cloud.

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

Google Cloud-Projekte 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 einem Arbeitsbereich verbinden, wird das AWS-Connector-Projekt erstellt. Rufen Sie den Tab Einstellungen des Arbeitsbereichs auf, um das AWS-Verbindungsprojekt zu identifizieren. Das Verbindungsprojekt wird unter der Überschrift AWS-Konten aufgeführt. In der Spalte Projekt-ID werden die Google Cloud-Projekte angezeigt, die Ihrem Arbeitsbereich zugeordnet sind.

Weitere Informationen zu AWS-Verbindungsprojekten finden Sie auf der Seite "Arbeitsbereiche".

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, wirkt sich die Netzwerkkonfiguration möglicherweise auch auf die Installation von Agent-Abhängigkeiten aus vorgelagerten Repositories aus. Die Agent-Pakete selbst sind über den privaten Google-Zugriff zugänglich.

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.

Agent auf einer einzelnen VM installieren

Folgen Sie der nachstehenden Anleitung, um den Agent zu installieren.

AMAZON LINUX AMI/CENTOS/RHEL

  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. Fügen Sie das Package Repository des Agents hinzu:

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
    sudo bash add-logging-agent-repo.sh
    
  4. Installieren Sie den Agent:

    1. Listen Sie die verfügbaren Versionen des Agents auf, um auszuwählen, welche Version installiert werden soll:

      sudo yum list --showduplicates google-fluentd
      
    2. In Produktionsumgebungen empfiehlt es sich, eine Hauptversion anzuhängen, um Hauptversionen zu vermeiden, die möglicherweise nicht abwärts kompatible Änderungen enthalten. Zum Anhängen einer Hauptversion führen Sie folgenden Befehl aus:

      sudo yum install -y google-fluentd-major-version.*
      

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

      sudo yum install -y google-fluentd-1.*
      
    3. Wenn Sie keine Hauptversion anhängen möchten, können Sie eine der anderen Installationsoptionen auswählen:

      1. Führen Sie folgenden Befehl aus, um eine bestimmte Version des Agents zu installieren:

          sudo yum install -y google-fluentd-version-number
        
      2. Führen Sie Folgendes aus, um die neueste Version des Agents zu installieren:

          sudo yum install -y google-fluentd
        
  5. Installieren Sie die Konfigurationsdateien.

    1. Führen Sie für unstrukturiertes Logging Folgendes aus:

      sudo yum install -y google-fluentd-catch-all-config
      
    2. Führen Sie für strukturiertes Logging Folgendes aus:

      sudo yum install -y google-fluentd-catch-all-config-structured
      

      Informationen zum strukturierten Logging finden Sie im Leitfaden Strukturiertes Logging.

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

DEBIAN/UBUNTU

  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. Fügen Sie das Package Repository des Agents hinzu:

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh && \
    sudo bash add-logging-agent-repo.sh && \
    sudo apt-get update
    
  4. Installieren Sie den Agent:

    1. Listen Sie die verfügbaren Versionen des Agents auf, um auszuwählen, welche Version installiert werden soll:

      sudo apt-cache madison google-fluentd
      
    2. In Produktionsumgebungen empfiehlt es sich, eine Hauptversion anzuhängen, um Hauptversionen zu vermeiden, die möglicherweise nicht abwärts kompatible Änderungen enthalten. Zum Anhängen einer Hauptversion führen Sie folgenden Befehl aus:

      sudo apt-get install -y 'google-fluentd=major-version.*'
      

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

      sudo apt-get install -y 'google-fluentd=1.*'
      
    3. Wenn Sie keine Hauptversion anhängen möchten, können Sie eine der anderen Installationsoptionen auswählen:

      1. Führen Sie folgenden Befehl aus, um eine bestimmte Version des Agents zu installieren:

          sudo apt-get install -y google-fluentd=version-number
        
      2. Führen Sie Folgendes aus, um die neueste Version des Agents zu installieren:

          sudo apt-get install -y google-fluentd
        
  5. Installieren Sie die Konfigurationsdateien.

    1. Führen Sie für unstrukturiertes Logging Folgendes aus:

      sudo apt-get install -y google-fluentd-catch-all-config
      
    2. Führen Sie für strukturiertes Logging Folgendes aus:

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

      Informationen zum strukturierten Logging finden Sie im Leitfaden Strukturiertes Logging.

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

SLES/SUSE

  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. Fügen Sie das Package Repository des Agents hinzu:

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
    sudo bash add-logging-agent-repo.sh
    
  4. Installieren Sie den Agent:

    1. Listen Sie die verfügbaren Versionen des Agents auf, um auszuwählen, welche Version installiert werden soll:

      sudo zypper search -s google-fluentd
      
    2. In Produktionsumgebungen empfiehlt es sich, eine Hauptversion anzuhängen, um Hauptversionen zu vermeiden, die möglicherweise nicht abwärts kompatible Änderungen enthalten. Zum Anhängen einer Hauptversion führen Sie folgenden Befehl aus:

      sudo zypper install -y 'google-fluentd<major-version.0.0'
      

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

      sudo zypper install -y 'google-fluentd<2.0.0'
      
    3. Wenn Sie keine Hauptversion anhängen möchten, können Sie eine der anderen Installationsoptionen auswählen:

      1. Führen Sie folgenden Befehl aus, um eine bestimmte Version des Agents zu installieren:

          sudo zypper install -y google-fluentd=version-number
        
      2. Führen Sie Folgendes aus, um die neueste Version des Agents zu installieren:

          sudo zypper install -y google-fluentd
        
  5. Installieren Sie die Konfigurationsdateien.

    1. Führen Sie für unstrukturiertes Logging Folgendes aus:

      sudo zypper install -y google-fluentd-catch-all-config
      
    2. Führen Sie für strukturiertes Logging Folgendes aus:

      sudo zypper install -y google-fluentd-catch-all-config-structured
      

      Informationen zum strukturierten Logging finden Sie im Leitfaden Strukturiertes Logging.

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

Führen Sie die folgenden Schritte aus, um den Agent auf einer VM-Instanz unter Windows zu installieren:

  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 und führen Sie die folgenden PowerShell-Befehle aus. Sie benötigen keine Administratorberechtigungen.

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-14.exe", "${env:UserProfile}\StackdriverLogging-v1-14.exe")
    & "${env:UserProfile}\StackdriverLogging-v1-14.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-14.exe

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

    .\StackdriverLogging-v1-14.exe /S
    

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

    .\StackdriverLogging-v1-14.exe /S /D="C:\Google Cloud's operations suite\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 auf einer Compute Engine-VM installieren

Sie können den Logging-Agent auf einer einzelnen VM über das vorkonfigurierte Monitoring-Dashboard VM-Instanzen installieren.

So gelangen Sie zum 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.

    Wenn Sie Cloud Monitoring noch nie verwendet haben, wird beim ersten Zugriff auf Monitoring in der Google Cloud Console automatisch ein Arbeitsbereich erstellt und Ihr Projekt mit diesem Arbeitsbereich verknüpft. Wenn Ihr Projekt nicht mit einem Arbeitsbereich verknüpft ist, wird ein Dialogfeld angezeigt, in dem Sie entweder einen Arbeitsbereich erstellen oder dieses Projekt zu einem vorhandenen Arbeitsbereich hinzufügen können. Wir empfehlen, einen Arbeitsbereich zu erstellen. Klicken Sie nach der Auswahl auf Hinzufügen.

  3. Wählen Sie im Navigationsbereich „Monitoring“ die Option Dashboards aus.
  4. Suchen Sie in der Tabelle 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 enthält die Liste eine Statusspalte für den Agent:

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

Wenn der Agent in einer Compute Engine-Instanz nicht erkannt wird, können Sie auf den Link „Nicht erkannt“ klicken, um im Dashboard einen Installationsworkflow aufzurufen.

Optionale Aufgaben

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

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 Logging-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 (sollte erstellt werden, falls sie nicht vorhanden ist):

     /etc/default/google-fluentd
    
  2. Fügen Sie die folgenden Zeilen 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 Logging-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, sodass der Agent über ausgehende HTTPS-Verbindungen Daten an Logging 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 und führen Sie die folgenden PowerShell-Befehle aus. Sie benötigen Administratorberechtigungen.

     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 und führen Sie die folgenden PowerShell-Befehle aus. Sie benötigen Administratorberechtigungen.

Restart-Service -Name StackdriverLogging

Agent-Upgrade durchführen

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

AMAZON LINUX AMI/CENTOS/RHEL

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

sudo yum upgrade google-fluentd

Durch den vorherigen Befehl ändert sich die Konfigurationsdatei des Agents nicht. Führen Sie die folgenden Befehle für Ihre Instanz aus, um die neuesten Standardkonfigurations- und Catchall-Konfigurationsdateien abzurufen:

sudo yum upgrade google-fluentd google-fluentd-catch-all-config

DEBIAN/UBUNTU

Führen Sie unter Debian oder Ubuntu die folgenden Befehle aus:

sudo apt-get update
sudo apt-get install -y --only-upgrade google-fluentd

Durch die vorherigen Befehle ändert sich die Konfigurationsdatei des Agents nicht. Führen Sie die folgenden Befehle für Ihre Instanz aus, um die neuesten Standardkonfigurations- und Catchall-Konfigurationsdateien abzurufen:

sudo apt-get install -y --only-upgrade -o Dpkg::Options::="--force-confnew" google-fluentd-catch-all-config
sudo apt-get install -y --only-upgrade google-fluentd

SLES/SUSE

Führen Sie unter SUSE den folgenden Befehl aus:

sudo zypper update google-fluentd

Durch den vorherigen Befehl ändert sich die Konfigurationsdatei des Agents nicht. Führen Sie die folgenden Befehle für Ihre Instanz aus, um die neuesten Standardkonfigurations- und Catchall-Konfigurationsdateien abzurufen:

sudo zypper update google-fluentd google-fluentd-catch-all-config

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.

Agent deinstallieren

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

AMAZON LINUX AMI/CENTOS/RHEL

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

sudo service google-fluentd stop
sudo yum remove google-fluentd google-fluentd-catch-all-config

DEBIAN/UBUNTU

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

sudo service google-fluentd stop
sudo apt-get remove google-fluentd google-fluentd-catch-all-config

SLES/SUSE

Führen Sie unter SUSE Linux folgenden Befehl aus:

sudo service google-fluentd stop
sudo zypper remove google-fluentd google-fluentd-catch-all-config

WINDOWS

Wählen Sie in der Systemsteuerung von Windows Programm deinstallieren aus. In der Liste der Programme, die deinstalliert werden können, sollte der Logging-Agent angezeigt werden.