Erfassung von Container-Protokollen mit Amazon ECS Log Collector - Amazon Elastic Container Service

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erfassung von Container-Protokollen mit Amazon ECS Log Collector

Anmerkung

Sie können Amazon ECS Log Collector nicht für Amazon ECS Managed Instances verwenden.

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

Anmerkung

Unter Amazon Linux, der für Amazon ECS optimierten AMIs Version 20250909 und höher, ist der Amazon ECS-Protokollsammler vorinstalliert /opt/amazon/ecs/ecs-logs-collector.sh und kann ohne Download von verwendet werden. GitHub Weitere Informationen finden Sie unter ECS Logs Collector in der ECS-optimierten AMI-Dokumentation.

Derzeit unterstützt der Amazon-ECS-Protokollsammler die folgenden Betriebssysteme:

  • Amazon Linux

  • Red Hat Enterprise Linux

  • Ubuntu

  • Windows Server

So führen Sie den Amazon ECS Logs Collector für Linux aus (ECS-optimiertes AMI)

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

  2. 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 Option --mode=enable-debug zum folgenden Befehl hinzu. Dies kann den Docker-Daemon möglicherweise neu starten, wodurch alle aktuell auf der Instance ausgeführten Container abgebrochen 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 Entlastung von Amazon-ECS-Container-Instances.

    [ec2-user ~]$ sudo /opt/amazon/ecs/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 aller Protokolle, das Sie AWS Support zur Diagnoseunterstützung zur Verfügung stellen können.

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.

    $ sudo bash ./ecs-logs-collector.sh
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 Herstellen einer Verbindung mit Ihrer Windows-Instance über RDP im Amazon-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 Option -RunMode debug 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 Entlastung 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.