Container-Optimized OS enthält einen Logging-Agent, der einige System- und Containerlogs nach Cloud Logging exportiert. Bis Container-Optimized OS 101 verwendeten x86-basierte Container-Optimized OS-Images einen containerisierten Logging-Agent, der auf fluentd basiert. Mit Container-Optimized OS 105 wurde eine alternative Logging-Agent-Implementierung ausgeliefert: fluent-bit. Ab Container-Optimized OS 109 ist der fluent-bit-Logging-Agent die Standardeinstellung. Der Legacy-Logging-Agent fluentd wird in Container-Optimized OS 113 entfernt.
Alle Versionen von Arm-basierten Container-Optimized OS-Images enthalten den fluent-bit-Logging-Agent.
Logging-Agent aktivieren
Der Logging-Agent ist standardmäßig deaktiviert. Sie können dieses Feature aktivieren, wenn Sie eine neue Instanz erstellen oder eine vorhandene Instanz aktualisieren.
Zugriffsanforderungen
Cloud Logging bietet IAM
Rollen
, mit denen Sie den entsprechenden Zugriff gewähren können. Wenn Sie Ihre Logs in einem Projekt ansehen möchten, benötigen Sie die Rolle roles/logging.viewer. Anwendungen müssen die Berechtigung zum Schreiben von Logs haben. Sie können diese Berechtigung erteilen, indem Sie dem Dienstkonto für eine Anwendung die IAM-Rolle roles/logging.logWriter zuweisen.
Weitere Informationen zu Berechtigungen und Rollen finden Sie unter Vordefinierte Rollen.
Instanz mit aktiviertem Logging-Agent erstellen
Console
Führen Sie die folgenden Schritte aus, um eine Compute Engine-Instanz auf Container-Optimized OS mit aktiviertem fluent-bit-Logging-Agent auszuführen:
Rufen Sie in der Console die Seite zum Erstellen einer Compute Engine-Instanz auf. Google Cloud
Geben Sie unter Name einen Namen für Ihre Instanz an.
Wählen Sie im Abschnitt Bootlaufwerk ein Container-Optimized OS-Image aus.
Klicken Sie auf Verwaltung, Sicherheit, Laufwerke, Netzwerke, Einzelmandanten, um weitere Optionen einzublenden.
Scrollen Sie auf dem Tab Verwaltung zum Abschnitt Metadaten. Fügen Sie einen neuen Metadateneintrag mit
google-logging-enabledals Schlüssel undtrueals Wert hinzu.Geben Sie optional weitere Optionen für Ihren Anwendungsfall an. Weitere Informationen finden Sie unter Instanzen erstellen und konfigurieren.
Klicken Sie auf Erstellen, um die Instanz zu erstellen und zu starten.
gcloud
Führen Sie den Befehl gcloud compute instances create aus und fügen Sie google-logging-enabled=true in die Metadaten ein, um eine Compute Engine-Instanz unter Container-Optimized OS mit aktiviertem Logging-Agent auszuführen. Beispiel:
gcloud compute instances create instance-name \
--image image-name \
--image-project cos-cloud \
--zone compute-zone \
--metadata google-logging-enabled=true
Dabei gilt:
- instance-name: Der Name Ihrer VM-Instanz.
- image-name: Der Name des Container-Optimized OS-Images für
die Instanz. Beispiel:
--image=cos-113-18244-85-29. - compute-zone: Die Compute-Zone für Ihre Instanz.
Weitere Informationen zum gcloud Befehl finden Sie in der
gcloud compute instances create
Referenzdokumentation.
Weitere Informationen zum Erstellen von Container-Optimized OS-Instanzen finden Sie unter
Instanzen erstellen und konfigurieren.
Logging-Agent auswählen
Die x86-basierten Container-Optimized OS 105- und 109-Images enthalten zwei Implementierungen des Logging-Agent: fluentd (Legacy) und fluent-bit.
Container-Optimized OS 105 verwendet standardmäßig fluentd und Container-Optimized OS 109 verwendet standardmäßig fluent-bit. Sie können das Standardverhalten mit dem Metadateneintrag google-logging-use-fluentbit ändern.
Wenn Sie den fluent-bit-Logging-Agent in Container-Optimized OS 105 verwenden möchten, legen Sie für google-logging-use-fluentbit den Wert true fest.
Wenn Sie den fluentd-Logging-Agent in Container-Optimized OS 109 verwenden möchten, legen Sie für google-logging-use-fluentbit den Wert false fest.
Logging-Agent in Projektmetadaten aktivieren
Ab Meilenstein 97 kann das Logging in Projektmetadaten aktiviert werden:
gcloud compute project-info add-metadata \
--metadata google-logging-enabled=true
Zugriffslogs
Console
Rufen Sie die Seite "VM-Instanzen" auf.
Klicken Sie auf den Namen der Instanz mit Container-Optimized OS, über die Sie auf Logs zugreifen möchten.
Klicken Sie im Abschnitt Logs auf Cloud Logging.
Dadurch wird der Log-Explorer für die angegebene Instanz geöffnet. Weitere Informationen finden Sie unter Log-Explorer verwenden.
gcloud
Verwenden Sie den gcloud logging read-Befehl, um auf Logs zuzugreifen. Beispiel:
gcloud logging read \
"resource.type=gce_instance AND resource.labels.instance_id=instance-id" \
--limit 10 \
--format json \
--freshness 30d
Dabei gilt:
- instance-id ist die ID Ihrer VM-Instanz.
Dieser Befehl versucht, Logs aus der VM-Instanz mit instance-id zu lesen. Dabei beträgt die Höchstzahl 10 Logs, die im JSON-Format vorliegen und höchsten 30 Tage alt sind.
Weitere Informationen zum gcloud Befehl finden Sie in der
Referenz
dokumentation zu gcloud logging read.
Funktionsweise
Der Logging-Agent ist standardmäßig so konfiguriert, dass Logs von bestimmten systemkritischen Diensten und Nutzeranwendungscontainern an das Cloud Logging-Back-End gesendet werden. Beispiele: Logs von Docker-Containern, ausgewählten systemd-Diensten, Audit-Logs, Journal-Log-Fehlern usw. Die vollständige Standardkonfiguration für das Logging finden Sie unter Container-Optimized OS-spezifische Konfigurationsquelle (x86-Images und Arm-Images) .
Bei x86-Images von Container-Optimized OS 105 und älter ist der Logging-Agent der containerisierte Legacy-Logging-Agent von Google Cloud Observability. Der Docker-Befehl, mit dem der Logging-Agent gestartet wird, ist in der Container-Optimized OS-Quelle für den systemd-Dienst stackdriver-logging definiert. Die Version des ausgeführten containerisierten Agent ist in der Container-Optimized OS Quelle im Verzeichnis app-admin/stackdriver definiert.
Bei Arm-Images aller Versionen und x86-Images für Container-Optimized OS 109 und höher ist der Logging-Agent ein integriertes Betriebssystempaket namens fluent-bit. Der Agent ist in das Betriebssystem integriert und wird zusammen mit den Betriebssystem-Images aktualisiert.
Bekannte Einschränkungen
Kompatibilität mit dem gcplogs-Treiber
Wenn ab Meilenstein 89 der in Container-Optimized OS enthaltene Logging-Agent und der Docker-Logging-Treiber gcplogs für einen oder mehrere Container aktiviert sind, kann eine übermäßige Anzahl an Warnlogs vom enthaltenen Logging-Agent ausgegeben werden. Dies kann zu Lograuschen und/oder erhöhten Gebühren für Cloud Logging führen.
Als Behelfslösung nutzen Sie nicht gcplogs als Docker-Logging-Treiber, sondern den von Container-Optimized OS konfigurierten Standardtreiber. Beachten Sie, dass der in Container-Optimized OS enthaltene Logging-Agent Containerlogs nach Cloud Logging exportiert, sodass es unnötig ist, beide Lösungen gleichzeitig zu verwenden.
Kompatibilität der Logging-Agent-Konfiguration
Der Logging-Agent ist ein auf fluentd basierender Container auf x86-basierten Container-Optimized OS-Images und eine fluent-bit-Binärdatei auf Arm-basierten Container-Optimized OS-Images. Die Konfigurationen der beiden Agent sind nicht kompatibel. Das ist kein Problem, wenn Sie nur die Standardkonfiguration für das Logging verwenden, die in die Betriebssystem-Images integriert ist. Wenn Sie jedoch eine benutzerdefinierte Konfiguration für das Logging haben, kann es zu Problemen kommen, wenn Sie Arbeitslasten zu Images migrieren, die auf einer anderen Architektur oder einer neueren Version von Container-Optimized OS basieren.
Verweise
- Dokumentation zum Legacy-Logging-Agent von Google Cloud Observability . Der in Container-Optimized OS enthaltene containerisierte Logging-Agent ist eine Teilmenge des Legacy-Logging-Agent. Diese Dokumentation kann daher einen allgemeineren Kontext zum Agent bieten, der über den Umfang von Container-Optimized OS hinausgeht.
- Dokumentation zu Google Cloud Observability documentation. Homepage der Dokumentation zu Google Cloud Observability, die für den Kontext nützlich sein kann.