Cloud Logging-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-logging-agent-repo.sh
   sudo bash add-logging-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/windows/StackdriverLogging-v1-21.exe", "${env:UserProfile}\StackdriverLogging-v1-21.exe")
   & "${env:UserProfile}\StackdriverLogging-v1-21.exe"
   

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

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

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

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

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

   & "${env:UserProfile}\StackdriverLogging-v1-21.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.

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

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
   

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

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.

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.

Linux

Führen Sie dazu diesen Befehl aus:

sudo bash add-logging-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. In der Liste der Programme, die deinstalliert werden können, sollte der Logging-Agent angezeigt werden. Führen Sie uninstall.exe auch in dem Verzeichnis aus, in dem Sie den Logging-Agent installiert haben.