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
<a name="ecs-logs-collector"></a>

**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 verfügbar auf GitHub für beide [Linux](https://github.com/awslabs/ecs-logs-collector) und [Windows](https://github.com/awslabs/aws-ecs-logs-collector-for-windows). Das Skript sammelt allgemeine Betriebssystemprotokolle sowie Docker- und Amazon ECS-Container-Agent-Protokolle, die bei der Fehlerbehebung hilfreich sein können AWS Support Fälle. Anschließend komprimiert und archiviert es die erfassten Informationen in einer einzigen Datei, die problemlos für Diagnosezwecke weitergegeben werden kann. Es unterstützt auch die Aktivierung des Debug-Modus für den Docker-Daemon und den Amazon ECS-Container-Agenten auf Amazon Linux-Varianten wie Amazon ECS-optimized ICH BIN.

**Anmerkung**  
Auf Amazon, Linux, Amazon ECS-optimized In der AMIS-Version 20250909 und höher ist der Amazon ECS Logs Collector unter vorinstalliert `/opt/amazon/ecs/ecs-logs-collector.sh` und sofort einsatzbereit, ohne es herunterzuladen von GitHub. Weitere Informationen finden Sie unter [ECS Logs Collector](https://github.com/aws/amazon-ecs-ami?tab=readme-ov-file#ecs-logs-collector) in der ECS-optimized AMI-Dokumentation.

Derzeit unterstützt der Amazon-ECS-Protokollsammler die folgenden Betriebssysteme:
+ Amazon Linux
+ Red Hat Enterprise Linux
+ Ubuntu
+ Windows Server

**Um den Amazon ECS Logs Collector für Linux auszuführen (ECS-optimized AMI)**

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

1. 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](container-instance-draining.md).

   ```
   [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. Das `collect.tgz` Die Datei ist ein komprimiertes Archiv aller Protokolle, das Sie teilen können AWS Support für diagnostische Hilfe.

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

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

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

1. 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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connecting_to_windows_instance.html) im *Amazon-EC2-Benutzerhandbuch*.

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

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

1. 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](container-instance-draining.md).

   ```
   .\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. Das `collect.tgz` Die Datei ist ein komprimiertes Archiv aller Protokolle, das Sie teilen können AWS Unterstützung für diagnostische Hilfe.