Über den Logging-Agent

Diese Anleitung enthält allgemeine Informationen zum Logging-Agent. Der Logging-Agent ist eine fluentd Anwendung, die auf Ihren VM-Instanzen ausgeführt wird.

In der Standardkonfiguration streamt der Logging-Agent Logs aus gängigen Drittanbieteranwendungen und Systemsoftware in Logging. Die Liste der Standardlogs finden Sie unter Logs des Standard-Logging-Agents. Sie können den Agent so konfigurieren, dass zusätzliche Logs gestreamt werden. Ausführliche Informationen zur Konfiguration und Nutzung des Agents finden Sie unter Logging-Agent konfigurieren.

Es empfiehlt sich, den Logging-Agent auf allen VM-Instanzen auszuführen. Der Agent ist mit Linux und Microsoft Windows kompatibel.

Eine Installationsanleitung für den Logging-Agent erhalten Sie unter Logging-Agent installieren.

Funktionsweise des Logging-Agents

Unterstützte Betriebssysteme

Sie können den Logging-Agent unter folgenden Betriebssystemen auf kompatiblen VM-Instanzen ausführen:

  • CentOS 7 and 8
  • Rocky Linux 8
  • Red Hat Enterprise Linux 7 und 8
  • Debian 9 "Stretch", 10 "Buster" und 11 "Bullseye"
  • Ubuntu LTS 20.04 (Focal Fossa)
  • Ubuntu Minimal LTS 20.04 (Focal Fossa)
  • SUSE Linux Enterprise Server 12 und 12 SP5 für SAP
  • SUSE Linux Enterprise Server 15, 15 SP2 für SAP, 15 S3 für SAP, 15 SP4 für SAP und 15 SP5 für SAP
  • OpenSUSE Leap 15, 15.2, 15.3 und 15.4
  • Windows Server 2016 und 2019
  • Windows Server Core 2016 und 2019
  • Amazon Linux AMI (außer Amazon Linux 2.0 AMI)

Wenn Sie Container-Optimized OS-VMs ausführen, folgen Sie der Anleitung für Container-Optimized OS, um Logs von Ihren VMs zu erfassen.

Unterstützte Umgebungen

Der Logging-Agent ist mit den folgenden Umgebungen kompatibel:

  • Compute Engine-Instanzen: Der Logging-Agent sendet die Logs jeweils an das Projekt, das mit der jeweiligen VM-Instanz verknüpft ist.

    Aktivieren Sie für Instanzen ohne externe IP-Adressen privaten Google-Zugriff, damit der Logging-Agent Logs senden kann.

  • Amazon Elastic Compute Cloud-Instanzen (Amazon EC2). Der Logging-Agent sendet die Logs an das AWS-Connector-Projekt, das Ihr AWS-Konto mit Google Cloud-Diensten verknüpft.

    Damit der Logging-Agent ordnungsgemäß funktioniert, muss die Amazon EC2-Instanz, auf der er ausgeführt wird, mit Google Cloud APIs, insbesondere mit der Logging API, kommunizieren können. Dafür ist entweder eine externe IP-Adresse oder ein VPC-Internetgateway erforderlich.

Zur Ausführung des Logging-Agents auf diesen VM-Instanzen sind mindestens 250 MiB residenter Speicher (RSS) erforderlich, 1 GiB wird jedoch empfohlen. Bei einer Verarbeitungsrate von 100 Logeinträgen pro Sekunde mit einer Größe von je 1 KB beansprucht der Logging-Agent in der Standardkonfigurationen 5 % der CPU-Kapazität pro Kern und 150 MB Speicher.

Die folgenden VM-Instanzen unterstützen Logging mit eigener Software. Daher wird die manuelle Installation des Logging-Agents dort nicht unterstützt:

  • Instanzen der App Engine-Standardumgebung. App Engine bietet eine integrierte Unterstützung für Logging. Weitere Informationen finden Sie unter Anwendungslogs schreiben.

  • Instanzen der flexiblen App Engine-Umgebung. Anwendungen, die in der flexiblen App Engine-Umgebung ausgeführt werden, können zusätzliche Logs erstellen, die über die in der App Engine-Standardumgebung enthaltenen Logs hinausgehen. Weitere Informationen finden Sie unter Anwendungslogs schreiben.

  • Google Kubernetes Engine-Knoteninstanzen Die Logerfassung mit Logging ist für neue Containercluster standardmäßig aktiviert oder Sie können sie für Ihre vorhandenen Cluster aktivieren. Weitere Informationen finden Sie unter Logging und Monitoring für GKE konfigurieren.

  • Bei Instanzen, die auf GKE on VMware ausgeführt werden, erfasst der Agent Systemlogs, jedoch keine Anwendungslogs.

  • Cloud Run-Containerinstanzen. Cloud Run bietet integrierte Unterstützung für Logging. Weitere Informationen finden Sie unter Logs schreiben und abrufen.

  • Cloud Functions HTTP- und Hintergrundfunktionen. Cloud Functions bietet integrierte Unterstützung für Logging. Weitere Informationen finden Sie unter Logs schreiben, ansehen und beantworten.

Unterstützung für lokale und Hybrid-Clouds

Google Cloud kooperiert mit observIQ, um Logging-Dienste für lokale und Hybrid-Cloud-Plattformen auf konsistente und vorhersehbare Weise bereitzustellen. Mit BindPlane können Sie Ihre eigenen Daten erfassen und zur Analyse an Logging senden. BindPlane kann in Cloud Logging eingebunden werden, um Daten aus Ihrer Infrastruktur zu erfassen, und ist ohne zusätzliche Kosten in Ihrem Projekt enthalten.

Weitere Informationen zu observIQ und BindPlane finden Sie unter observIQ und BindPlane.

Erforderlicher Agent-Zugriff

Das Ausführen des Agents erfordert Zugriff auf die folgenden DNS-Namen:

  • OAuth2-Token-Server: oauth2.googleapis.com

    Ältere Versionen des Agents erfordern möglicherweise Zugriff auf www.googleapis.com (vollständige URL: https://www.googleapis.com/oauth2/v3/token).

    Wenn Sie eine ältere Version des Agents verwenden, sollten Sie für den Agent ein Upgrade auf die aktuellste Version durchführen.

  • Logging-APIs: logging.googleapis.com

Die Installation des Agents erfordert Zugriff auf die folgenden DNS-Namen:

  • (Linux) Google Cloud-Paket-Repository: packages.cloud.google.com

  • Google-Download-Server: dl.google.com

Quellcode des Logging-Agents

Sie benötigen die Informationen in diesem Abschnitt nur, wenn Sie den Quellcode nachvollziehen oder spezielle Anforderungen umsetzen möchten. Der Logging-Agent wird mit dem in der Installationsanleitung beschriebenen Skript installiert.

Der Logging-Agent google-fluentd ist eine modifizierte Version des Logdaten-Collectors fluentd. google-fluentd wird in zwei separaten Paketen verteilt. Der Quellcode ist in den zugehörigen GitHub-Repositories verfügbar:

  • Das GitHub-Repository mit dem Namen google-fluentd, das das Kernprogramm fluentd, die benutzerdefinierten Skripts für die Paketerstellung und das Ausgabe-Plug-in für die Cloud Logging API enthält.
    • Das Ausgabe-Plug-in ist als Ruby Gem gepackt und im Paket google-fluentd enthalten. Darüber hinaus ist es auch separat im Ruby-Gem-Hosting-Dienst unter fluent-plugin-google-cloud verfügbar.
    • Der Inhalt des Windows-Installationsprogramms befindet sich im Ordner windows-installer.
  • Im GitHub-Repository namens google-fluentd-catch-all-config, das die Konfigurationsdateien für den Logging-Agent zur Aufnahme der Logs aus verschiedenen Softwarepaketen von Drittanbietern enthält.

Versionshinweise für den Logging-Agent

  • Die Versionshinweise für das Linux-Paket google-fluentd finden Sie unter google-fluentd/releases. Die Release-Tags entsprechen dem semantischen Versionsformat [Major].[Minor].[Patch].

  • Die Versionshinweise für die Windows-Installationsprogramme finden Sie ebenfalls unter google-fluentd/releases. Den Release-Tags wird aber stattdessen das Präfix Windows vorangestellt.

  • Die Versionshinweise für das eigenständige Gem fluent-plugin-google-cloud finden Sie unter fluent-plugin-google-cloud/releases. Die Release-Tags entsprechen dem semantischen Versionsformat [Major].[Minor].[Patch].

Einstellungsrichtlinie

Der Logging-Agent unterliegt der Richtlinie zur Einstellung von Google Cloud-Agents für die Beobachtbarkeit.

Weitere Informationen