

# Configuración de Información de contenedores en Amazon ECS
<a name="deploy-container-insights-ECS-cluster"></a>

Puede configurar Información de contenedores con observabilidad mejorada o Información de contenedores en clústeres de Amazon ECS nuevos y existentes mediante la consola de Amazon ECS o la AWS CLI. Información de contenedores recopila métricas en los niveles de clúster, tarea y servicio. Información de contenedores con observabilidad mejorada proporciona dimensiones y métricas adicionales, lo que le permite profundizar en la visibilidad por contenedor. 

Si está utilizando Amazon ECS en una instancia de Amazon EC2, inicie esa instancia con una AMI que incluya el agente de Amazon ECS, versión 1.29 o posterior. Para obtener información sobre cómo se actualiza la versión del agente, consulte [Actualización del agente de contenedor de Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html).

**nota**  
Si la clave de AWS KMS administrada por el cliente que utiliza para las métricas de Información de contenedores de Amazon ECS aún no está configurada para funcionar con CloudWatch, debe actualizar la política de claves para permitir los registros cifrados en Registros de CloudWatch. También debe asociar su propia clave de AWS KMS al grupo de registro que se indica en `/aws/ecs/containerinsights/ClusterName/performance`. Para obtener más información, consulte [Cifrar datos de registro en los registros de CloudWatch mediante AWS Key Management Service](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/encrypt-log-data-kms.html).

Le recomendamos que utilice Información de contenedores con observación mejorada en lugar de Información de contenedores, ya que proporciona una visibilidad detallada del entorno de contenedores y reduce el tiempo medio de resolución.

## Configuración de Información de contenedores con observabilidad mejorada
<a name="set-container-insights-ECS-cluster-enhanced"></a>

Puede activar Información de contenedores con observabilidad mejorada mediante la consola de Amazon ECS o la AWS CLI. 

------
#### [ AWS CLI ]

Utilice el siguiente comando para activar Información de contenedores con observabilidad mejorada.

 Establezca la configuración de la cuenta `containerInsights` en `enhanced`.

```
aws ecs put-account-setting --name containerInsights --value enhanced
```

Ejemplo de resultado

```
{
    "setting": {
        "name": "containerInsights",
        "value": "enhanced",
        "principalArn": "arn:aws:iam::123456789012:johndoe",
         "type": user
    }
}
```

**nota**  
De forma predeterminada, `put-account-setting` se aplica solo al usuario autenticado actualmente. Si desea habilitar la configuración en toda la cuenta para todos los usuarios y roles, utilice el usuario raíz como en el siguiente ejemplo.  

```
aws ecs put-account-setting --name containerInsights --value enhanced --principal-arn arn:aws:iam::accountID:root
```

Tras establecer esta configuración de la cuenta, todos los clústeres nuevos utilizan automáticamente Información de contenedores con observabilidad mejorada. Usa el comando `update-cluster-settings` para agregar Información de contenedores con observabilidad mejorada al clúster existente o para actualizar los clústeres que actualmente usan Información de contenedores a Información de contenedores con observabilidad mejorada.

```
aws ecs update-cluster-settings --cluster cluster-name --settings name=containerInsights,value=enhanced
```

------
#### [ Amazon ECS console ]

1. Abra la consola en [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. En la barra de navegación de la parte superior, seleccione la región para la que desea consultar la configuración de cuenta. 

1. En la página de navegación, elija **Account Settings** (Configuración de cuenta).

1. Elija **Actualizar**.

1. Para usar Información de contenedores con observabilidad mejorada, elija **Información de contenedores con observabilidad mejorada**.

1. Seleccione **Save changes (Guardar cambios)**.

1. En la pantalla de confirmación, seleccione **Confirm (Confirmar)** para guardar la selección.

Tras establecer esta configuración, todos los clústeres nuevos utilizan automáticamente Información de contenedores con observabilidad mejorada. Puede agregar Información de contenedores con observabilidad mejorada a los clústeres existentes o actualizar los clústeres que actualmente usan Información de contenedores a Información de contenedores con observabilidad mejorada. Para obtener más información, consulte [Actualización de un clúster de Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-cluster-v2.html) en la *Guía para desarrolladores de Amazon Elastic Container Service*.

------

## Configuración de Información de contenedores
<a name="set-container-insights-ECS-cluster"></a>

Puede activar Información de contenedores con la consola de Amazon ECS o la AWS CLI. 

------
#### [ AWS CLI ]

Para usar Información de contenedores, establezca la configuración de la cuenta `container Insights` en `enabled`. Use el siguiente comando para activar Información de contenedores.

```
aws ecs put-account-setting --name containerInsights --value enabled
```

Ejemplo de resultado

```
{
    "setting": {
        "name": "container Insights",
        "value": "enabled",
        "principalArn": "arn:aws:iam::123456789012:johndoe",
         "type": user
    }
}
```

Al establecer la configuración de la cuenta `container Insights` en `enabled`, todos los clústeres nuevos tienen habilitado Información de contenedores de forma predeterminada. Usa el comando `update-cluster-settings` para agregar Información de contenedores a un clúster existente.

```
aws ecs update-cluster-settings --cluster cluster-name --settings name=containerInsights,value=enabled
```

------
#### [ Amazon ECS console ]

1. Abra la consola en [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. En la barra de navegación de la parte superior, seleccione la región para la que desea consultar la configuración de cuenta. 

1. En la página de navegación, elija **Account Settings** (Configuración de cuenta).

1. Elija **Actualizar**.

1. Para usar Información de contenedores, seleccione **Información de contenedores**.

1. Seleccione **Save changes (Guardar cambios)**.

1. En la pantalla de confirmación, seleccione **Confirm (Confirmar)** para guardar la selección.

Tras configurarlo, todos los clústeres nuevos utilizarán Información de contenedores automáticamente. Actualice los clústeres existentes para agregar Información de contenedores. Para obtener más información, consulte [Actualización de un clúster de Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-cluster-v2.html) en la *Guía para desarrolladores de Amazon Elastic Container Service*.

------