

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.

# Amazon ECS-Ereigniserfassung in der Konsole
<a name="task-lifecycle-events"></a>

Die Amazon ECS-Konsole bietet Funktionen zur Erfassung von Ereignissen, mit denen von Amazon ECS generierte Ereignisse, wie Serviceaktionen und Änderungen des Aufgabenstatus, in Amazon CloudWatch Logs gespeichert werden. EventBridge Dieses Feature beinhaltet eine Abfrageschnittstelle mit Filterfunktionen zur Überwachung und Fehlerbehebung.

Ereignisse bieten detaillierte Informationen darüber, wie Ihre Servicebereitstellungen, Services, Aufgaben und Instances funktionieren. Sie können diese Informationen verwenden, um Fehler bei der Bereitstellung von Aufgaben oder Services zu beheben.

Wenn Sie die Ereigniserfassung aktivieren, haben Sie Zugriff auf alle Ereignisse, die Amazon ECS für einen Aufbewahrungszeitraum Ihrer Wahl generiert. Dies geht über die systemeigenen Beschränkungen der letzten 100 ungefilterten Ereignisse oder gestoppten Aufgaben hinaus, die nur 1 Stunde lang sichtbar sind.

## Funktionsweise
<a name="task-lifecycle-events-overview"></a>

Event Capture verwendet EventBridge , um Ereignisse in einer vordefinierten Amazon CloudWatch Logs-Protokollgruppe zu speichern. Die Amazon-ECS-Konsole bietet vorgefertigte Abfragen und Filteroptionen und korreliert Ereignisse, um Aufgabenlebenszyklen in einem intuitiven Format bereitzustellen.

Sie können die folgenden Arten von Ereignissen abfragen und abrufen:
+ **Serviceaktionsereignisse** – Helfen bei der Identifizierung von Problemen bei der Bereitstellung oder Ressourcenzuweisung
+ **Ereignisse im Aufgabenlebenszyklus** – Helfen bei der Klärung, warum Aufgaben oder Container nicht gestartet werden können oder nicht mehr ausgeführt werden

Die Amazon ECS-Konsole ermöglicht Ihnen die Einrichtung der Ereigniserfassung mit einem Klick und bietet häufig verwendete Abfragen und Filterung, ohne dass Sie Abfragesprachen lernen oder zwischen mehreren Konsolen navigieren müssen.

## Event types (Ereignistypen)
<a name="task-lifecycle-events-types"></a>

Event Capture speichert alle von Amazon ECS generierten Ereignisse in den folgenden Kategorien:

Änderungsereignisse des Aufgabenstatus  
Container-Stopps und andere Terminierungsereignisse, die Sie zur Fehlerbehebung oder zur Überwachung der Lebenszyklen von Aufgaben verwenden können.

Service-Aktionen  
Ereignisse wie das Erreichen eines stabilen Zustands, fehlgeschlagene Aufgabenplatzierung oder Ressourcenengpässe.

Statusänderungen der Servicebereitstellung  
Ereignisse wie laufende, abgeschlossene oder fehlgeschlagene Bereitstellungen, ausgelöst durch Circuit Breaker- und Rollback-Einstellungen, um den Status einer Dienstbereitstellung zu überwachen.

Statusänderungen der Container-Instance  
Für Workloads auf EC2- und Amazon ECS-verwalteten Instances zeigen Ereignisse den Status „Verbunden“ und „Getrennt“ an.

## Konfiguration der Protokollgruppe
<a name="task-lifecycle-events-log-group"></a>

Wenn Sie die Ereigniserfassung aktivieren, erstellt Amazon ECS automatisch die folgenden Ressourcen:
+ Eine Amazon CloudWatch Logs-Protokollgruppe mit dem Namen `/aws/events/ecs/containerinsights/${clusterName}/performance`
+ Eine EventBridge Regel, die alle Ereignisse aus der `aws.ecs` Quelle aufnimmt und an die Protokollgruppe weiterleitet

Sie können für die Protokollgruppe einen Aufbewahrungszeitraum von 1 Tag bis 10 Jahren angeben. Die Standardaufbewahrungsdauer beträgt 7 Tage.

## Überlegungen
<a name="task-lifecycle-events-limitations"></a>

Beachten Sie bei der Verwendung von Event Capture Folgendes:
+ Event Capture speichert der Einfachheit halber alle Ereignisse. Sie können in der Amazon ECS-Konsole keine Regeln so konfigurieren, dass nur bestimmte Ereignisse erfasst werden.
+ Die Amazon ECS-Konsole bietet vordefinierte Abfragekriterien. Verwenden Sie für erweiterte Abfragen Amazon CloudWatch Logs Logs Insights, um die Protokollgruppe direkt abzufragen.
+ Die Live-Tail-Funktionalität ist in der Amazon ECS-Konsole nicht verfügbar. Verwenden Sie Amazon CloudWatch Logs direkt für Live-Tail.
+ Wenn Sie die Ereigniserfassung deaktivieren, wird die EventBridge Regel gelöscht.
+ Bei der Erfassung von Ereignissen fallen zusätzliche Kosten für die EventBridge Datenaufnahme, die Speicherung von Amazon CloudWatch Logs und die Ausführung von Abfragen an.

  [Informationen zur Preisgestaltung finden Sie unter EventBridge Preise. EventBridge ](https://aws.amazon.com/eventbridge/pricing/)

  Informationen zur CloudWatch Preisgestaltung finden Sie unter [CloudWatch Preisgestaltung](https://aws.amazon.com/cloudwatch/pricing/).

## Ereignisbasierte Problembehandlung
<a name="task-lifecycle-events-troubleshooting"></a>

Verwenden Sie von Amazon ECS generierte Ereignisse, um häufig gestellte Fragen zur Fehlerbehebung zu beantworten.

### Analyse von Aufgabenfehlern
<a name="task-lifecycle-events-task-failures"></a>

Sie können Ereignisse zur Änderung des `STOPPED` Aufgabenstatus, Stoppcodes und Container-Exitcodes überprüfen, um festzustellen, warum eine Aufgabe nicht oder während der Ausführung nicht gestartet werden konnte.

Sie können Serviceaktionsereignisse auf Platzierungsfehler und Informationen zu Ressourcenbeschränkungen überprüfen, um festzustellen, warum eine Aufgabe aufgrund von Ressourcenbeschränkungen nicht platziert werden konnte

### Häufige Szenarien, in denen Aufgaben fehlschlagen
<a name="task-lifecycle-events-common-issues"></a>

Die häufigsten Fehler bei abnormalen Aufgaben hängen mit den folgenden Problemen zusammen:
+ Fehler bei der Bereitstellung des CI/CD-Dienstes
+ Fehler bei der automatischen Skalierung
+ Fehler beim Rebalancing von Aufgaben
+ Ungewöhnliche Container-Exits, wie z. B. out-of-memory (OOM-) Fehler

Abnormale Aufgabenfehler führen zu Ereignissen zur Änderung des `STOPPED` Aufgabenstatus mit einem `TaskFailedToStart` Stoppcode `EssentialContainerExited` oder. Sie können nach diesen Stoppcodes filtern, um das Verhalten von Containern bei der Ausführung und beim Stoppen zu untersuchen.

# Aktivieren Sie die Ereigniserfassung für einen vorhandenen Amazon ECS-Cluster
<a name="turn-on-event-capture-existing-cluster"></a>

Sie können die Ereigniserfassung in einem vorhandenen Amazon ECS-Cluster aktivieren, um von Amazon ECS generierte Ereignisse in Amazon CloudWatch Logs zu speichern. EventBridge Diese Funktion hilft Ihnen bei der Überwachung und Behebung von Aufgabenausfällen, Servicebereitstellungen und anderen Cluster-Aktivitäten.

Nachdem Sie die Ereigniserfassung aktiviert haben, erstellt Amazon ECS die folgenden Ressourcen:
+ Eine Amazon CloudWatch Logs-Protokollgruppe mit dem Namen `/aws/events/ecs/containerinsights/${clusterName}/performance`
+ Eine EventBridge Regel, die alle Ereignisse aus der `aws.ecs` Quelle erfasst

In der Clusteransicht wird eine Registerkarte „**Verlauf**“ angezeigt, auf der Sie Ereignisse und Serviceaktionen im Aufgabenlebenszyklus abfragen können. Die Erfassung von Ereignissen beginnt sofort und speichert alle von Amazon ECS generierten Ereignisse gemäß Ihrer angegebenen Aufbewahrungsfrist.

## Voraussetzungen
<a name="turn-on-event-capture-prerequisites"></a>
+ Ein vorhandener Amazon ECS-Cluster
+ Entsprechende IAM-Berechtigungen zum Ändern der Cluster-Einstellungen und zum Erstellen von Amazon CloudWatch Logs-Ressourcen

## Aktivieren Sie die Ereigniserfassung über die Konsole
<a name="turn-on-event-capture-procedure"></a>

1. Öffnen Sie die Konsole auf [https://console.aws.amazon.com/ecs/Version](https://console.aws.amazon.com/ecs/v2) 2.

1. Klicken Sie im Navigationsbereich auf **Cluster**.

1. Wählen Sie den Cluster aus, in dem Sie die Ereigniserfassung aktivieren möchten.

   Die Cluster-Detailseite wird angezeigt.

1. Wählen Sie **Konfiguration**.

1. Wählen Sie im Abschnitt **ECS-Ereignisse** die Option **Ereigniserfassung aktivieren** aus.

   Das Dialogfeld „**Ereigniserfassung aktivieren**“ wird angezeigt.

1. Wählen Sie **für Expire event** den Aufbewahrungszeitraum für die Amazon CloudWatch Logs-Protokollgruppe aus. Die Standardeinstellung ist 7 Tage.

1. Wählen Sie **Turn on** (Einschalten) aus.

# Ereignisse zur Änderung des Amazon ECS-Service- und Aufgabenstatus anzeigen
<a name="viewing-state-events"></a>

Die Amazon ECS-Konsole bietet Funktionen zur Erfassung von Ereignissen, mit denen von Amazon ECS generierte Ereignisse, wie Serviceaktionen und Änderungen des Aufgabenstatus, in Amazon CloudWatch Logs gespeichert werden. EventBridge Diese Funktion umfasst eine Abfrageschnittstelle mit Filterfunktionen zur Verbesserung der Überwachung und Fehlerbehebung.

Ereignisse bieten detaillierte Informationen darüber, wie Ihre Servicebereitstellungen, Services, Aufgaben und Instances funktionieren. Sie können diese Informationen verwenden, um Fehler bei der Bereitstellung von Aufgaben oder Services zu beheben.

Sie können jedes der folgenden Kriterien verwenden, um die Ereignisse zu filtern:
+  Bereitstellungs-ID (Diese ist nur auf der Service-Detailseite verfügbar) 
+ Startzeit
+ Endzeit 
+ Dienstname (gilt nur auf der Cluster-Detailseite, auf der Dienstdetailseite, dies ist standardmäßig der aktuelle Dienst) 
+ Aufgaben-ID 
+ Letzter Status der Aufgabe 
+ Familie der Aufgabendefinitionen 
+ Überarbeitung der Aufgabendefinition 

## Ereignisse auf Cluster-Ebene anzeigen
<a name="view-cluster-procedure"></a>

1. [Öffnen Sie die Konsole auf Version 2. https://console.aws.amazon.com/ecs/](https://console.aws.amazon.com/ecs/v2)

1. Klicken Sie auf **Cluster**.

   Die Seite mit der Cluster-Liste wird angezeigt.

1. Wählen Sie den Cluster aus.

   Die Cluster-Detailseite wird angezeigt.

1. Legen Sie unter **Verlauf** fest, welche Ereignisse angezeigt werden sollen.

   1. Um Serviceaktionsereignisse anzuzeigen, wählen Sie **Serviceaktionsereignisse** aus.

   1. Um Ereignisse zur Änderung des Aufgabenstatus anzuzeigen, wählen Sie Ereignisse zur **Änderung des Aufgabenstatus** aus.

   1. (Optional) Geben Sie im Feld **Abfragekriterien** die Filter für die Ereignisse ein, die Sie anzeigen möchten.

1. Wählen Sie **Abfrage ausführen**.

   Die Ereignisse werden in einer Liste angezeigt.

1. Um die vollständigen Details des Ereignisses anzuzeigen, wählen Sie das Ereignis aus.

## Anzeige auf Serviceebene
<a name="tasks-procedure"></a>

1. Öffnen Sie die Konsole auf [https://console.aws.amazon.com/ecs/Version 2.](https://console.aws.amazon.com/ecs/v2)

1. Wählen Sie auf der **Cluster**-Seite den Cluster aus.

1. Wählen Sie auf der Seite mit den Cluster-Details im Abschnitt **Services** den Service aus.

   Die Seite mit den Service-Details wird angezeigt.

1. Legen Sie unter **Verlauf** fest, welche Ereignisse angezeigt werden sollen.

   1. Um Serviceaktionsereignisse anzuzeigen, wählen Sie **Serviceaktionsereignisse** aus.

   1. Um Ereignisse zur Änderung des Aufgabenstatus anzuzeigen, wählen Sie Ereignisse zur **Änderung des Aufgabenstatus** aus.

   1. (Optional) Geben Sie im Feld **Abfragekriterien** die Filter für die Ereignisse ein, die Sie anzeigen möchten.

1. Wählen Sie **Abfrage ausführen**.

   Die Ereignisse werden in einer Liste angezeigt.

1. Um die vollständigen Details des Ereignisses anzuzeigen, wählen Sie das Ereignis aus.