# Configuración de Información de contenedores en Amazon ECS mediante AWS Distro para OpenTelemetry
<a name="deploy-container-insights-ECS-adot"></a>

Utilice esta sección si desea utilizar AWS Distro para OpenTelemetry con el fin de configurar Información de contenedores de CloudWatch en un clúster de Amazon ECS. Para obtener más información acerca de AWS Distro para Open Telemetry, consulte [AWS Distro para OpenTelemetry](https://aws.amazon.com/otel/). 

En estos pasos se da por sentado que ya cuenta con un clúster que ejecuta Amazon ECS. Para obtener más información sobre el uso de AWS Distro para OpenTelemetry con Amazon ECS y la configuración de un clúster de Amazon ECS para este fin, consulte [Configuración del recopilador de AWS Distro para OpenTelemetry en Amazon Elastic Container Service](https://aws-otel.github.io/docs/setup/ecs).

## Paso 1: Cree un rol de tarea
<a name="deploy-container-insights-ECS-adot-CreateTaskRole"></a>

El primer paso consiste en crear un rol de tarea en el clúster que el recopilador de OpenTelemetry de AWS usará.

**Cómo crear un rol de tarea para AWS Distro para OpenTelemetry**

1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. En el panel de navegación, elija **Policies (Políticas)** y, a continuación, seleccione **Create policy (Crear política)**.

1. Elija la pestaña **JSON** y copie la siguiente política:

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "logs:PutLogEvents",
                   "logs:CreateLogGroup",
                   "logs:CreateLogStream",
                   "logs:DescribeLogStreams",
                   "logs:DescribeLogGroups",
                   "ssm:GetParameters"
               ],
               "Resource": "*"
           }
       ]
   }
   ```

------

1. Elija **Revisar política**.

1. En nombre, ingrese **AWSDistroOpenTelemetryPolicy**, después, elija **Create policy** (Crear política).

1. En el panel de navegación de la izquierda, elija **Roles** y, a continuación, seleccione **Create Role** (Crear rol).

1. En la lista de servicios, elija **Elastic Container Service**.

1. Debajo en la misma página, elija **Elastic Container Service Task** (Tarea de Elastic Container Service), luego **Next: Permissions** (Siguiente: Permisos).

1. En la lista de políticas, busque **AWSDistroOpenTelemetryPolicy**.

1. Marque la casilla situada junto a **AWSDistroOpenTelemetryPolicy**.

1. Elija **Next: Tags** (Siguiente: Etiquetas) y, a continuación, seleccione **Next: Review** (Siguiente: Revisar).

1. En **Role name** (Nombre de rol), ingrese **AWSOpenTelemetryTaskRole** y luego elija **Create role** (Crear rol).

## Paso 2: Cree un rol de ejecución de tarea
<a name="deploy-container-insights-ECS-adot-CreateTaskExecutionRole"></a>

El siguiente paso es crear un rol de ejecución de tareas para el recopilador OpenTelemetry de AWS.

**Cómo crear un rol de ejecución de tareas para AWS Distro para OpenTelemetry**

1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. En el panel de navegación de la izquierda, seleccione **Roles** y, a continuación, seleccione **Create Role** (Crear rol).

1. En la lista de servicios, elija **Elastic Container Service**.

1. Debajo en la misma página, elija **Elastic Container Service Task** (Tarea de Elastic Container Service), luego **Next: Permissions** (Siguiente: Permisos).

1. En la lista de políticas, busque **AmazonECSTaskExecutionRolePolicy** y, a continuación, seleccione la casilla de selección situada junto a **AmazonECSTaskExecutionRolePolicy**.

1. En la lista de políticas, busque **CloudWatchLogsFullAccess** y, a continuación, seleccione la casilla de selección situada junto a **CloudWatchLogsFullAccess**.

1. En la lista de políticas, busque **AmazonSSMReadOnlyAccess** y, a continuación, seleccione la casilla de selección situada junto a **AmazonSSMReadOnlyAccess**.

1. Elija **Next: Tags** (Siguiente: Etiquetas) y, a continuación, seleccione **Next: Review** (Siguiente: Revisar).

1. En **Role name** (Nombre de rol), ingrese **AWSOpenTelemetryTaskExecutionRole** y luego elija **Create role** (Crear rol).

## Paso 3: Cree una definición de tarea
<a name="deploy-container-insights-ECS-adot-CreateTaskDefinition"></a>

El siguiente paso es crear una definición de tarea.

**Cómo crear una definición de tarea para AWS Distro para OpenTelemetry**

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, elija **Task definitions** (Definiciones de tareas).

1. Elija **Create new task definition** (Crear nueva definición de tarea) y **Create new task definition** (Crear nueva definición de tarea).

1. Para **Task definition family** (Familia de definiciones de tareas), especifique un nombre único para la definición de tareas.

1. Configure los contenedores y, a continuación, elija **Siguiente**.

1. En **Métricas y registro**, seleccione **Usar recopilación de métricas**.

1. Elija **Next (Siguiente)**.

1. Seleccione **Create (Crear)**.

Para obtener más información sobre el uso del recopilador de AWS OpenTelemetry con Amazon ECS, consulte [Configuración del recopilador de AWS Distro para OpenTelemetry en Amazon Elastic Container Service](https://aws-otel.github.io/docs/setup/ecs).

## Paso 4: Ejecute la tarea
<a name="deploy-container-insights-ECS-adot-CreateTaskDefinition"></a>

El paso final es ejecutar la tarea que ha creado.

**Cómo ejecutar la tarea de AWS Distro para OpenTelemetry**

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 izquierdo, elija **Task Definitions** (Definiciones de tarea) y, a continuación, seleccione la tarea que acaba de crear.

1. Seleccione **Acciones**, **Implementar** y **Ejecutar tarea**. 

1. Elija **Deploy** (Implementar), **Run task** (Ejecución de tareas).

1. En la sección **Opciones de procesamiento**, en **Clúster existente**, elija el clúster.

1. Seleccione **Crear**.

1. A continuación, puede verificar las métricas nuevas en la consola de CloudWatch.

1. Abra la consola de CloudWatch en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. En el panel de navegación izquierdo, en **Metrics** (Métricas).

   Debería ver un espacio de nombres **ECS/ContainerInsights** Elija ese espacio de nombres, se deberían ver ocho métricas.