Configurar o Container Insights no Amazon ECS usando o AWS Distro for OpenTelemetry

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.

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.

Etapa 1: Criar uma função de tarefa

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/.

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

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

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

4. Escolha Revisar política.

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

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

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

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

9. Na lista de políticas, procure AWSDistroOpenTelemetryPolicy.

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

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

12. 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 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/.

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

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

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

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

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

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

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

9. 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 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.

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

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

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

5. Configure seus contêineres e escolha Avançar.

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

7. Escolha Next (Próximo).

8. Escolha Create (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.

Etapa 4: Executar a tarefa

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.

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

3. Escolha Ações, Implantar, Executar tarefa.

4. Escolha Deploy (Implantar), Run task (Executar tarefa).

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

6. Escolha Criar.

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

8. Abra o console do CloudWatch em https://console.aws.amazon.com/cloudwatch/.

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

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