# Captura de eventos de Amazon ECS en la consola
La consola de Amazon ECS proporciona una funcionalidad de captura de eventos que almacena los eventos generados por Amazon ECS, como las acciones de servicio y los cambios de estado de las tareas, en Registros de Amazon CloudWatch a través de EventBridge. Esta característica incluye una interfaz de consulta con funciones de filtrado para la supervisión y la solución de problemas.
Los eventos proporcionan información detallada sobre el funcionamiento de las implementaciones de servicio, los servicios, las tareas y las instancias. Puede utilizar esta información para solucionar problemas de implementación de tareas o problemas de implementación de servicios.
Al activar la captura de eventos, tiene acceso a todos los eventos que Amazon ECS genera durante el periodo de retención que elija, que se extiende más allá de las limitaciones nativas de los últimos 100 eventos sin filtrar o tareas detenidas visibles solo durante 1 hora.
## Funcionamiento
La captura de eventos utiliza EventBridge para almacenar eventos en un grupo de registro predefinido de Registros de Amazon CloudWatch. La consola de Amazon ECS proporciona consultas predefinidas y opciones de filtrado, y correlaciona los eventos para proporcionar los ciclos de vida de las tareas en un formato intuitivo.
Puede consultar y recuperar los siguientes tipos de eventos:
+ **Eventos de acción de servicio**: ayudan a identificar problemas de aprovisionamiento o asignación de recursos
+ **Eventos del ciclo de vida de las tareas**: ayudan a identificar por qué las tareas o los contenedores no se inician o dejan de estar en marcha.
La consola de Amazon ECS le permite configurar la captura de eventos con un solo clic y proporciona consultas y filtros de uso común sin necesidad de aprender los lenguajes de consulta ni de navegar entre varias consolas.
## Tipos de eventos
La captura de eventos almacena todos los eventos generados por Amazon ECS en las siguientes categorías:
Eventos de cambio de estado de tarea
Las paradas de contenedores y otros eventos de terminación, que puede utilizar para solucionar problemas o para supervisar los plazos del ciclo de vida de las tareas.
Acciones de servicio
Eventos como alcanzar un estado estable, realizar una tarea errónea o limitar los recursos.
Cambios de estado de implementación de servicios
Eventos como implementaciones en curso, finalizadas o fallidas, activados por la configuración del interruptor y la reversión, para supervisar el estado de la implementación de un servicio.
Cambios de estado de instancia de contenedor
En el caso de las cargas de trabajo en instancias administradas de Amazon ECS y EC2, los eventos muestran el estado de conexión y desconexión.
## Configuración de grupos de registro
Al activar la captura de eventos, Amazon ECS crea automáticamente los siguientes recursos:
+ Un grupo de registro de Registros de Amazon CloudWatch denominado `/aws/events/ecs/containerinsights/${clusterName}/performance`
+ Una regla de EventBridge que ingiere todos los eventos del origen `aws.ecs` y los reenvía al grupo de registro
Puede especificar un periodo de retención para el grupo de registro de 1 día a 10 años. El periodo de retención predeterminado es de 7 días.
## Consideraciones
Tenga en cuenta lo siguiente al usar la captura de eventos:
+ La captura de eventos almacena todos los eventos para simplificar. No puede configurar reglas en la consola de Amazon ECS para capturar solo eventos específicos.
+ La consola de Amazon ECS proporciona criterios de consulta predefinidos. Para consultas avanzadas, utilice la información de registros de Registros de Amazon CloudWatch para consultar directamente el grupo de registro.
+ La funcionalidad Live Tail no está disponible en la consola de Amazon ECS. Utilice Registros de Amazon CloudWatch directamente para Live Tail.
+ Al deshabilitar la captura de eventos, se elimina la regla de EventBridge.
+ La captura de eventos conlleva costos adicionales por la ingesta de datos de EventBridge, el almacenamiento de Registros de Amazon CloudWatch y la puesta en marcha de consultas.
Para obtener información acerca de los precios de EventBridge, consulte [Precios de EventBridge](https://aws.amazon.com/eventbridge/pricing/).
Para obtener más información acerca de los precios de CloudWatch, consulte [Precios de CloudWatch](https://aws.amazon.com/cloudwatch/pricing/).
## Solución de problemas basada en eventos
Utilice los eventos generados por Amazon ECS para responder a las preguntas habituales de solución de problemas.
### Análisis de errores de tarea
Puede revisar los eventos de cambio de estado de la tarea `STOPPED`, los códigos de detención y los códigos de salida del contenedor para determinar por qué una tarea no se pudo iniciar o falló mientras estaba en marcha.
Puede revisar los eventos de acción del servicio para ver si hay errores de ubicación y la información sobre limitaciones de recursos para determinar por qué una tarea no se pudo realizar debido a las limitaciones de recursos.
### Situaciones comunes de errores en las tareas
Los errores anormales de tareas más comunes se relacionan con los siguientes problemas:
+ Errores de implementación del servicio de CI/CD
+ Errores de escalado automático
+ Errores de reequilibrio de tareas
+ Salidas anormales del contenedor, como errores de memoria insuficiente (OOM)
Los errores anormales en las tareas producen eventos de cambio de estado de la tarea `STOPPED` con un código de detención `EssentialContainerExited` o `TaskFailedToStart`. Puede filtrar por estos códigos de parada para examinar los comportamientos de puesta en marcha y parada de los contenedores.
# Activación de la captura de eventos de un clúster de Amazon ECS existente
Puede habilitar la captura de eventos en un clúster de Amazon ECS existente para almacenar los eventos generados por Amazon ECS en Registros de Amazon CloudWatch a través de EventBridge. Esta característica le permite supervisar y solucionar los errores en las tareas, las implementaciones de servicios y otras actividades del clúster.
Al activar la captura de eventos, Amazon ECS crea los siguientes recursos:
+ Un grupo de registro de Registros de Amazon CloudWatch denominado `/aws/events/ecs/containerinsights/${clusterName}/performance`
+ Una regla de EventBridge que captura todos los eventos del origen `aws.ecs`
Aparece una pestaña de **historial** en la vista de clúster, que permite consultar los eventos del ciclo de vida de las tareas y las acciones de servicio. La captura de eventos comienza inmediatamente y almacena todos los eventos generados por Amazon ECS de acuerdo con el periodo de retención especificado.
## Requisitos previos
+ Un clúster existente de Amazon EKS
+ Permisos de IAM adecuados para modificar la configuración del clúster y crear recursos de Registros de Amazon CloudWatch
## Activación de la captura de eventos mediante la consola
1. Abra la consola en [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
1. Seleccione el clúster en el que desee activar la captura de eventos.
Aparecerá la página de detalles del clúster.
1. Elija **Configuración**.
1. En la sección de **eventos de ECS**, seleccione **Activar la captura de eventos**.
Aparece el cuadro de diálogo **Activar la captura de eventos**.
1. En el **evento de vencimiento**, elija el periodo de retención del grupo de registro de Registros de Amazon CloudWatch. El valor predeterminado es 7 días.
1. Elija **Turn on**.
# Visualización de eventos de cambio de estado de tarea y servicio de Amazon ECS
La consola de Amazon ECS proporciona una funcionalidad de captura de eventos que almacena los eventos generados por Amazon ECS, como las acciones de servicio y los cambios de estado de las tareas, en Registros de Amazon CloudWatch a través de EventBridge. Esta característica incluye una interfaz de consulta con funciones de filtrado para mejorar la supervisión y la solución de problemas.
Los eventos proporcionan información detallada sobre el funcionamiento de las implementaciones de servicio, los servicios, las tareas y las instancias. Puede utilizar esta información para solucionar problemas de implementación de tareas o problemas de implementación de servicios.
Puede utilizar cualquiera de los siguientes criterios para filtrar los eventos:
+ ID de implementación (solo está disponible en la página de detalles del servicio)
+ Hora de inicio
+ Hora de finalización
+ Nombre del servicio (solo se aplica a la página de detalles del clúster; en la página de detalles del servicio, será el servicio actual por defecto)
+ ID de tarea
+ Último estado de la tarea
+ Familia de definiciones de tareas
+ Revisión de definición de tareas
## Visualización de eventos a nivel de clúster
1. Abra la consola en [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).
1. Seleccione **Clusters (Clústeres)**.
Aparecerá la página de lista de clústeres.
1. Seleccione el clúster de .
Aparecerá la página de detalles del clúster.
1. En **Historial**, determine los eventos que desea ver.
1. Para ver los eventos de acción de servicio, seleccione **Eventos de acción de servicio**.
1. Para ver los eventos de cambio de estado de la tarea, seleccione los **eventos de cambio de estado de la tarea**.
1. (Opcional) En **Criterios de consulta**, introduzca los filtros para los eventos que desee ver.
1. Elija **Ejecutar consulta**.
Los eventos se muestran en una lista.
1. Para ver todos los detalles del evento, seleccione el evento.
## Visualización a nivel de servicio
1. Abra la consola en [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).
1. En la página **Clusters** (Clústeres), elija el clúster.
1. En la página de detalles del clúster, en la sección **Servicios**, elija el servicio.
Aparecerá la página de detalles del servicio.
1. En **Historial**, determine los eventos que desea ver.
1. Para ver los eventos de acción de servicio, seleccione **Eventos de acción de servicio**.
1. Para ver los eventos de cambio de estado de la tarea, seleccione los **eventos de cambio de estado de la tarea**.
1. (Opcional) En **Criterios de consulta**, introduzca los filtros para los eventos que desee ver.
1. Elija **Ejecutar consulta**.
Los eventos se muestran en una lista.
1. Para ver todos los detalles del evento, seleccione el evento.