

# Configurar o Container Insights no Amazon ECS usando o AWS Distro for OpenTelemetry
<a name="deploy-container-insights-ECS-adot"></a>

Consulte esta seção para usar o AWS Distro for OpenTelemetry para configurar o CloudWatch Container Insights em um cluster do Amazon ECS. Para obter mais informações sobre o AWS Distro for OpenTelemetry, consulte [AWS Distro for OpenTelemetry](https://aws.amazon.com/otel/). 

Estas etapas presumem que você já tenha um cluster executando o Amazon ECS. Para obter mais informações sobre como usar o AWS Distro for Open Telemetry com o Amazon ECS e configurar um cluster do Amazon ECS para essa finalidade, consulte [Configurar o AWS Distro for Open Telemetry Collector no Amazon Elastic Container Service](https://aws-otel.github.io/docs/setup/ecs).

## Etapa 1: Criar uma função de tarefa
<a name="deploy-container-insights-ECS-adot-CreateTaskRole"></a>

A primeira etapa é criar uma função de tarefa no cluster que o AWS Distro for Open Telemetry Collector usará.

**Para criar uma função de tarefa para o AWS Distro for Open Telemetry**

1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. No painel de navegação, escolha **Policies (Políticas)** e, em seguida, selecione **Create policy (Criar política)**.

1. Selecione a guia **JSON** e copie a política a seguir:

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

****  

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

------

1. Selecione **Revisar política**.

1. Para nome, insira **AWSDistroOpenTelemetryPolicy** e escolha **Create policy** (Criar política).

1. No painel de navegação à esquerda, escolha **Roles** (Funções) e **Create role** (Criar função).

1. Na lista de serviços, escolha **Elastic Container Service**.

1. Na parte inferior da página, escolha **Elastic Container Service** e **Next: Permissions** (Próximo: permissões).

1. Na lista de políticas, procure **AWSDistroOpenTelemetryPolicy**.

1. Marque a caixa de seleção ao lado de **AWSDistroOpenTelemetryPolicy**.

1. Escolha **Next: Tags** (Próximo: etiquetas) e **Next: Review** (Próximo: revisar).

1. Em **Role name** (Nome da função), insira **AWSOpenTelemetryTaskRole** e escolha **Create role** (Criar função).

## Etapa 2: Criar uma função de execução de tarefa
<a name="deploy-container-insights-ECS-adot-CreateTaskExecutionRole"></a>

A próxima etapa é criar uma função de execução de tarefas para o AWS OpenTelemetry Collector.

**Para criar uma função de execução de tarefa para o AWS Distro for Open Telemetry**

1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. No painel de navegação à esquerda, escolha **Roles** (Funções) e **Create role** (Criar função).

1. Na lista de serviços, escolha **Elastic Container Service**.

1. Na parte inferior da página, escolha **Elastic Container Service** e **Next: Permissions** (Próximo: permissões).

1. Na lista de políticas, procure **AmazonECSTaskExecutionRolePolicy** e marque a caixa de seleção ao lado de **AmazonECSTaskExecutionRolePolicy**.

1. Na lista de políticas, procure **CloudWatchLogsFullAccess** e marque a caixa de seleção ao lado de **CloudWatchLogsFullAccess**.

1. Na lista de políticas, procure **AmazonSSMReadOnlyAccess** e marque a caixa de seleção ao lado de **AmazonSSMReadOnlyAccess**.

1. Escolha **Next: Tags** (Próximo: etiquetas) e **Next: Review** (Próximo: revisar).

1. Em **Role name** (Nome da função), insira **AWSOpenTelemetryTaskExecutionRole** e escolha **Create role** (Criar função).

## Etapa 3: Criar uma definição de tarefa
<a name="deploy-container-insights-ECS-adot-CreateTaskDefinition"></a>

A próxima etapa é criar uma definição de tarefa.

**Para criar uma definição de tarefa para o AWS Distro for Open Telemetry**

1. Abra o console em [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. No painel de navegação, escolha **Task definitions** (Definições de tarefas)

1. Escolha **Create new task definition** (Criar nova definição de tarefa), **Create new task definition** (Criar nova definição de tarefa).

1. Em **Task definition family** (Família de definição de tarefa), especifique um nome exclusivo para a definição de tarefa.

1. Configure seus contêineres e escolha **Avançar**.

1. Em **Métricas e logs**, selecione **Usar coleção de métricas**.

1. Escolha **Próximo**.

1. Escolha **Criar**.

Para obter mais informações sobre como usar o AWS Open Telemetry Collector com o Amazon ECS, consulte [Configurar o AWS Distro for Open Telemetry Collector no Amazon Elastic Container Service](https://aws-otel.github.io/docs/setup/ecs).

## Etapa 4: Executar a tarefa
<a name="deploy-container-insights-ECS-adot-CreateTaskDefinition"></a>

A etapa final é executar a tarefa que você criou.

**Para executar a tarefa para AWS Distro for OpenTelemetry**

1. Abra o console em [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. No painel de navegação à esquerda, escolha **Task Definitions** (Definições de tarefa) e selecione a tarefa que você acabou de criar.

1. Escolha **Ações**, **Implantar**, **Executar tarefa**. 

1. Escolha **Deploy** (Implantar), **Run task** (Executar tarefa).

1. Na seção **Opções de computação**, em **Cluster existente**, escolha o cluster.

1. Escolha **Criar**.

1. Em seguida, é possível conferir as novas métricas no console do CloudWatch.

1. Abra o console do CloudWatch, em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação à esquerda, escolha **Metrics**.

   Você deverá ver um namespace **ECS/ContainerInsights**. Escolha esse namespace e verá oito métricas.