Sammeln von Container-Protokollen mit Amazon ECS Logs Collector

Wenn Sie nicht sicher sind, wie Sie all die verschiedenen Protokolle auf Ihren Container-Instances sammeln können, können Sie den Amazon-ECS-Protokollsammler verwenden. Er ist sowohl GitHub für Linux als auch für Windows verfügbar. Das Skript sammelt allgemeine Betriebssystemprotokolle sowie Docker- und Amazon ECS-Container-Agent-Protokolle, die bei der Fehlerbehebung hilfreich sein können AWS Support . Anschließend komprimiert und archiviert es die erfassten Informationen in einer einzigen Datei, die problemlos für Diagnosezwecke weitergegeben werden kann. Außerdem unterstützt es die Aktivierung des Debug-Modus für den Docker-Daemon und den Amazon-ECS-Container-Agenten auf Amazon Linux-Varianten, wie etwa das Amazon-ECS-optimierte AMI. Derzeit unterstützt der Amazon-ECS-Protokollsammler die folgenden Betriebssysteme:

• Amazon Linux

• Red Hat Enterprise Linux 7

• Debian 8

• Ubuntu 14.04

• Ubuntu 16.04

• Ubuntu 18.04

• Windows Server 2016

Anmerkung

Der Quellcode für den Amazon ECS Logs Collector ist sowohl GitHub für Linux als auch für Windows verfügbar. Wir möchten Sie bitten, uns eventuelle Änderungswünsche mitzuteilen. Amazon Web Services bietet derzeit jedoch keine Unterstützung für die Ausführung modifizierter Kopien dieser Software.

So laden Sie den Amazon-ECS-Protokollsammler für Linux herunter und führen ihn aus

1. Stellen Sie eine Verbindung mit Ihrer Container-Instance her.

2. Laden Sie das Skript des Amazon-ECS-Protokollsammlers herunter.

   curl -O https://raw.githubusercontent.com/awslabs/ecs-logs-collector/master/ecs-logs-collector.sh

3. Führen Sie das Skript aus, um die Protokolle zu erfassen und das Archiv zu erstellen.

   Anmerkung

   Um den Debug-Modus für den Docker-Daemon und den Amazon ECS-Container-Agenten zu aktivieren, fügen Sie die --mode=enable-debug Option zum folgenden Befehl hinzu. Dadurch könnte der Docker-Daemon neu gestartet werden, der alle Container beendet, die auf der Instance ausgeführt werden. Sie sollten in Betracht ziehen, die Container-Instance auszugleichen und alle wichtigen Aufgaben in andere Container-Instances zu verschieben, bevor Sie den Debug-Modus aktivieren. Weitere Informationen finden Sie unter Entleeren von Amazon ECS-Container-Instances.

   [ec2-user ~]$ sudo bash ./ecs-logs-collector.sh

Nachdem Sie das Skript ausgeführt haben, können Sie die gesammelten Protokolle im Ordner collect, den das Skript erstellt hat, untersuchen. Bei der collect.tgz Datei handelt es sich um ein komprimiertes Archiv mit allen Protokollen, das Sie AWS Support zur Diagnoseunterstützung zur Verfügung stellen können.

So laden Sie den Amazon-ECS-Protokollsammler für Windows herunter und führen ihn aus

1. Stellen Sie eine Verbindung mit Ihrer Container-Instance her. Weitere Informationen finden Sie unter Connecting to Your Windows Instance im Amazon EC2 EC2-Benutzerhandbuch.

2. Laden Sie das Amazon ECS-Logs-Collector-Skript mit herunter PowerShell.

   Invoke-WebRequest -OutFile ecs-logs-collector.ps1 https://raw.githubusercontent.com/awslabs/aws-ecs-logs-collector-for-windows/master/ecs-logs-collector.ps1

3. Führen Sie das Skript aus, um die Protokolle zu erfassen und das Archiv zu erstellen.

   Anmerkung

   Um den Debug-Modus für den Docker-Daemon und den Amazon ECS-Container-Agenten zu aktivieren, fügen Sie die -RunMode debug Option zum folgenden Befehl hinzu. Dies startet den Docker-Daemon neu, wodurch alle aktuell auf der Instance ausgeführten Container gestoppt werden. Sie sollten in Betracht ziehen, die Container-Instance auszugleichen und alle wichtigen Aufgaben in andere Container-Instances zu verschieben, bevor Sie den Debug-Modus aktivieren. Weitere Informationen finden Sie unter Entleeren von Amazon ECS-Container-Instances.

   .\ecs-logs-collector.ps1

Nachdem Sie das Skript ausgeführt haben, können Sie die gesammelten Protokolle im Ordner collect, den das Skript erstellt hat, untersuchen. Bei der collect.tgz Datei handelt es sich um ein komprimiertes Archiv aller Protokolle, das Sie mit dem AWS Support teilen können, um Hilfe bei der Diagnose zu erhalten.