Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Acquisizione di eventi Amazon ECS nella console
<a name="task-lifecycle-events"></a>

La console Amazon ECS fornisce una funzionalità di acquisizione degli eventi che archivia gli eventi generati da Amazon ECS, come azioni di servizio e modifiche dello stato delle attività, in Amazon CloudWatch Logs through. EventBridge Questa funzionalità include un’interfaccia di query con funzionalità di filtraggio per il monitoraggio e la risoluzione dei problemi.

Gli eventi forniscono informazioni dettagliate sul funzionamento delle implementazioni, dei servizi, delle attività e delle istanze. È possibile utilizzare questa informazioni per risolvere i problemi relativi alle implementazioni non riuscite di attività o servizi.

Quando attivi l'acquisizione degli eventi, hai accesso a tutti gli eventi generati da Amazon ECS per un periodo di conservazione a tua scelta, che va oltre i limiti nativi degli ultimi 100 eventi non filtrati o attività interrotte visibili solo per 1 ora.

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

L'acquisizione degli eventi consente EventBridge di archiviare gli eventi in un gruppo di log Amazon CloudWatch Logs predefinito. La console Amazon ECS fornisce query e opzioni di filtro predefinite e correla gli eventi per fornire cicli di vita delle attività in un formato intuitivo.

È possibile eseguire una query e recuperare i seguenti tipi di eventi:
+ **Eventi di azione del servizio**: aiutano a identificare problemi di provisioning o allocazione delle risorse
+ **Eventi del ciclo di vita delle attività**: aiutano a identificare il motivo per cui le attività o i container non vengono avviati o interrompono l’esecuzione

La console Amazon ECS ti consente di configurare l'acquisizione degli eventi con un clic e fornisce query e filtri di uso comune senza dover imparare i linguaggi di query o navigare tra più console.

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

Event Capture archivia tutti gli eventi generati da Amazon ECS nelle seguenti categorie:

Eventi di modifica dello stato dei processi  
Arresti dei container e altri eventi di terminazione, che puoi utilizzare per la risoluzione dei problemi o per monitorare le tempistiche del ciclo di vita delle attività.

Operazioni di servizio  
Eventi come il raggiungimento dello stato stazionario, l’immissione fallita delle attività o la limitazione delle risorse.

Modifiche agli stati di implementazione del servizio  
Eventi come implementazioni in corso, completate o non riuscite, attivati dalle impostazioni di circuit breaker e rollback, per monitorare lo stato dell'implementazione di un servizio.

Modifiche dello stato dell’istanza di container  
Per i carichi di lavoro su istanze gestite EC2 e Amazon ECS, gli eventi mostrano lo stato di connessione e disconnessione.

## Configurazione dei gruppi di log
<a name="task-lifecycle-events-log-group"></a>

Quando attivi l'acquisizione degli eventi, Amazon ECS crea automaticamente le seguenti risorse:
+ Un gruppo di CloudWatch log di Amazon Logs denominato `/aws/events/ecs/containerinsights/${clusterName}/performance`
+ Una EventBridge regola che acquisisce tutti gli eventi dall'`aws.ecs`origine e li inoltra al gruppo di log

È possibile specificare un periodo di conservazione per il gruppo di log da 1 giorno a 10 anni. Il periodo di conservazione predefinito è di 7 giorni.

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

Quando utilizzi l'acquisizione di eventi, considera quanto segue:
+ Event Capture archivia tutti gli eventi per semplicità. Non è possibile configurare regole nella console Amazon ECS per acquisire solo eventi specifici.
+ La console Amazon ECS fornisce criteri di interrogazione predefiniti. Per le query avanzate, usa Amazon CloudWatch Logs Logs Insights per interrogare direttamente il gruppo di log.
+ La funzionalità Live Tail non è disponibile nella console Amazon ECS. Usa Amazon CloudWatch Logs direttamente per live tail.
+ Quando disabiliti l'acquisizione degli eventi, la EventBridge regola viene eliminata.
+ L'acquisizione degli eventi comporta costi aggiuntivi per l'inserimento EventBridge dei dati, lo storage di Amazon CloudWatch Logs e l'esecuzione delle query.

  [Per informazioni sui EventBridge prezzi, consulta la pagina dei prezzi. EventBridge ](https://aws.amazon.com/eventbridge/pricing/)

  Per informazioni sui CloudWatch prezzi, consulta la sezione [CloudWatch prezzi](https://aws.amazon.com/cloudwatch/pricing/).

## Risoluzione dei problemi basata sugli eventi
<a name="task-lifecycle-events-troubleshooting"></a>

Utilizza gli eventi generati da Amazon ECS per rispondere a domande comuni sulla risoluzione dei problemi.

### Analisi degli errori delle attività
<a name="task-lifecycle-events-task-failures"></a>

È possibile esaminare gli eventi di modifica dello stato dell'`STOPPED`attività, i codici di arresto e i codici di uscita del contenitore per determinare il motivo per cui un'attività non è stata avviata o non è riuscita durante l'esecuzione.

È possibile esaminare gli eventi relativi alle azioni di servizio per verificare gli errori di posizionamento e le informazioni sui vincoli di risorse per determinare il motivo per cui un'attività non è riuscita a essere eseguita a causa di vincoli di risorse

### Scenari comuni di errore delle attività
<a name="task-lifecycle-events-common-issues"></a>

Gli errori anomali delle attività più comuni sono correlati ai seguenti problemi:
+ Errori di implementazione del servizio CI/CD
+ Errori di scalabilità automatica
+ Errori di ribilanciamento delle attività
+ Uscite anomale dei contenitori, ad esempio errori (OOM) out-of-memory

Gli errori anomali delle attività producono eventi di modifica dello stato dell'`STOPPED`attività con un `EssentialContainerExited` codice di arresto OR. `TaskFailedToStart` È possibile filtrare in base a questi codici di arresto per esaminare i comportamenti di esecuzione e arresto dei container.

# Attiva l'acquisizione degli eventi per un cluster Amazon ECS esistente
<a name="turn-on-event-capture-existing-cluster"></a>

Puoi abilitare l'acquisizione di eventi su un cluster Amazon ECS esistente per archiviare gli eventi generati da Amazon ECS in Amazon CloudWatch Logs tramite. EventBridge Questa funzionalità consente di monitorare e risolvere i problemi relativi agli errori delle attività, alle implementazioni di servizi e ad altre attività del cluster.

Dopo aver abilitato l'acquisizione degli eventi, Amazon ECS crea le seguenti risorse:
+ Un gruppo di CloudWatch log di Amazon Logs denominato `/aws/events/ecs/containerinsights/${clusterName}/performance`
+ Una EventBridge regola che cattura tutti gli eventi dalla fonte `aws.ecs`

Nella visualizzazione cluster viene visualizzata una scheda **Cronologia**, che consente di interrogare gli eventi del ciclo di vita delle attività e le azioni di servizio. L'acquisizione degli eventi inizia immediatamente e memorizza tutti gli eventi generati da Amazon ECS in base al periodo di conservazione specificato.

## Prerequisiti
<a name="turn-on-event-capture-prerequisites"></a>
+ Un cluster Amazon ECS esistente
+ Autorizzazioni IAM appropriate per modificare le impostazioni del cluster e creare risorse Amazon CloudWatch Logs

## Attiva l'acquisizione degli eventi tramite la console
<a name="turn-on-event-capture-procedure"></a>

1. Apri la console alla [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. Nel pannello di navigazione scegliere **Cluster**.

1. Seleziona il cluster in cui desideri abilitare l'acquisizione degli eventi.

   Si apre la pagina dei dettagli del cluster.

1. Scegliere **Configuration (Configurazione)**.

1. Nella sezione **Eventi ECS**, scegli **Attiva l'acquisizione degli eventi**.

   Viene visualizzata la finestra di dialogo **Attiva acquisizione eventi**.

1. Per l'**evento Expire**, scegli il periodo di conservazione per il gruppo di log Amazon CloudWatch Logs. L’impostazione di default è 7 giorni.

1. Scegliere **Turn On (Attiva)**.

# Visualizzazione degli eventi di modifica dello stato dei servizi e delle attività di Amazon ECS
<a name="viewing-state-events"></a>

La console Amazon ECS fornisce una funzionalità di acquisizione degli eventi che archivia gli eventi generati da Amazon ECS, come azioni di servizio e modifiche dello stato delle attività, in Amazon CloudWatch Logs through. EventBridge Questa funzionalità include un'interfaccia di interrogazione con funzionalità di filtraggio per migliorare il monitoraggio e la risoluzione dei problemi.

Gli eventi forniscono informazioni dettagliate sul funzionamento delle implementazioni, dei servizi, delle attività e delle istanze. È possibile utilizzare questa informazioni per risolvere i problemi relativi alle implementazioni non riuscite di attività o servizi.

È possibile utilizzare uno dei seguenti criteri per filtrare gli eventi:
+  ID di distribuzione (disponibile solo nella pagina dei dettagli del servizio) 
+ Ora di inizio
+ Ora di fine 
+ Nome del servizio (applicabile solo nella pagina dei dettagli del cluster, nella pagina dei dettagli del servizio, sarà l'impostazione predefinita per il servizio corrente) 
+ ID attività 
+ Ultimo stato dell'attività 
+ Famiglia di definizioni delle attività 
+ Revisione della definizione delle attività 

## Visualizzazione degli eventi a livello di cluster
<a name="view-cluster-procedure"></a>

1. [Apri la console nella versione 2. https://console.aws.amazon.com/ecs/](https://console.aws.amazon.com/ecs/v2)

1. Scegli **Cluster**.

   Viene visualizzata la pagina con l'elenco dei cluster.

1. Scegli il cluster .

   Si apre la pagina dei dettagli del cluster.

1. In **Cronologia**, determina gli eventi da visualizzare.

   1. Per visualizzare gli eventi relativi alle azioni di **servizio, scegli Eventi di azione** del servizio.

   1. Per visualizzare gli eventi di modifica dello stato dell'**attività, scegli Eventi di modifica dello stato** dell'attività.

   1. (Facoltativo) In **Criteri di interrogazione**, inserite i filtri per gli eventi che desiderate visualizzare.

1. Scegli **Esegui query**.

   Gli eventi vengono visualizzati in un elenco.

1. Per visualizzare i dettagli completi dell'evento, scegli l'evento.

## Visualizzazione a livello di servizio
<a name="tasks-procedure"></a>

1. [Apri la console alla v2. https://console.aws.amazon.com/ecs/](https://console.aws.amazon.com/ecs/v2)

1. Nella pagina **Cluster**, scegliere il cluster.

1. Nella pagina dei dettagli del cluster, nella sezione **Servizi**, selezionare il servizio.

   Si apre la pagina dei dettagli del servizio.

1. In **Cronologia**, determina gli eventi da visualizzare.

   1. Per visualizzare gli eventi relativi alle azioni di **servizio, scegli Eventi di azione** del servizio.

   1. Per visualizzare gli eventi di modifica dello stato dell'**attività, scegli Eventi di modifica dello stato** dell'attività.

   1. (Facoltativo) In **Criteri di interrogazione**, inserite i filtri per gli eventi che desiderate visualizzare.

1. Scegli **Esegui query**.

   Gli eventi vengono visualizzati in un elenco.

1. Per visualizzare i dettagli completi dell'evento, scegli l'evento.