Como configurar o CloudWatch Container Insights para monitorar minhas tarefas do Amazon ECS e a implantação de contêineres?

Resolução

Observação: se você receber erros ao executar comandos da AWS Command Line Interface (AWS CLI), consulte Troubleshoot AWS CLI errors. Além disso, certifique-se de usar a versão mais recente da AWS CLI.

Para configurar o CloudWatch Container Insights para monitorar suas tarefas do Amazon ECS e a implantação de contêineres, conclua as etapas a seguir.

Modificar as configurações da conta

Para ativar o Container Insights para todos os novos clusters que você criou, defina as configurações da conta do Container Insights.

Use o console do CloudWatch para modificar as configurações da conta

Conclua as seguintes etapas:

1. Abra o console do Amazon ECS.
2. Na barra de navegação, use o seletor de região para escolher uma região.
3. Escolha Configurações da conta.
4. Na seção CloudWatch Container Insights, defina ou desmarque a caixa de seleção para cada configuração para o usuário e o perfil autenticados do AWS Identity and Access Management (IAM).
5. Depois de definir essas configurações, escolha Salvar.
6. Na tela de confirmação, escolha Confirmar.

Ao fazer login como conta de usuário raiz da AWS, você pode alterar a configuração padrão da conta. Ou você pode alterar a configuração de qualquer usuário ou perfil do IAM específico na conta.

Use a AWS CLI para modificar as configurações de conta padrão para todos os usuários ou perfis do IAM

Para modificar a configuração de conta padrão para todos os usuários ou perfis do IAM na sua conta, execute o seguinte comando da AWS CLI:

aws ecs put-account-setting-default --name containerInsights --value enabled --region <REGION_NAME>

Observação: as alterações do comando anterior se aplicam a toda a conta da AWS, a menos que um usuário ou perfil do IAM substitua explicitamente essas configurações. Para obter mais informações, consulte Modificar configurações de conta do Amazon ECS.

Criar um cluster com o Container Insights ativado

Para ativar o Container Insights ao criar um cluster, use o console do Amazon ECS ou a AWS CLI.

Criar um cluster com o Container Insights ativado

Conclua as seguintes etapas:

1. Abra o console do Amazon ECS.
2. Na barra de navegação, use o seletor de região para escolher uma região.
3. No painel de navegação, escolha Clusters.
4. Escolha Criar cluster.
5. Na página Criar cluster, escolha as configurações necessárias para criar seu cluster.
6. Expanda Monitoramento e selecione Usar Container Insights.
7. Escolha Criar.

Use a AWS CLI para criar um cluster com o Container Insights ativado

Para criar um novo cluster com o Container Insights ativado, execute o seguinte comando:

aws ecs create-cluster --cluster-name <CLUSTER_NAME> --settings "name=containerInsights,value=enabled" --region <REGION_NAME>

Ativar o Container Insights em um cluster existente do Amazon ECS

Para ativar o Container Insights em um cluster existente, execute o seguinte comando:

aws ecs update-cluster-settings --cluster <CLUSTER_NAME> --settings name=containerInsights,value=enabled --region <REGION_NAME>

Opções do Container Insights

Ao usar o CloudWatch Container Insights, revise as seguintes opções:

• Quando você usa um tipo de execução do Amazon Elastic Compute Cloud (Amazon EC2), sua tarefa não precisa ter configurações de recursos de CPU de contêiner. Para mostrar as métricas de utilização da CPU no nível da tarefa do Amazon ECS, defina o parâmetro da CPU no nível da tarefa ou no nível do contêiner na definição da tarefa.
• Métricas de rede estão disponíveis para todas as tarefas executadas no AWS Fargate e para tarefas executadas em instâncias do Amazon EC2 que usam a ponte. Métricas também estão disponíveis para tarefas que usam os modos de rede da Amazon Virtual Private Cloud (Amazon VPC).
• Para coletar as métricas em nível de instância dos clusters do ECS que estão hospedados em uma instância do EC2, implante o agente do CloudWatch.

Usar o CloudWatch Logs Insights para visualizar os dados do Container Insights

As métricas que o Containers Insights coleta para a coleta do Amazon ECS são para métricas agregadas e médias no nível da família. Para analisar os dados, use o CloudWatch Logs Insights. Observe que o CloudWatch Logs Insights não rastreia tarefas únicas.

O Container Insights recupera eventos de logs de desempenho e coleta automaticamente as métricas de desempenho como logs. Para coletar as métricas de desempenho, abra o console do CloudWatch Logs Insights. Em seguida, use o formato a seguir para selecionar um grupo de logs:

/aws/ecs/containerinsights/<CLUSTER_NAME>/performance

O exemplo de consulta a seguir mostra o uso da CPU e da memória em nível de tarefa:

stats avg(CpuUtilized) as CPU, avg(MemoryUtilized) as Mem by TaskId  
| filter Type="Task"  
| sort Mem, CPU desc

Informações relacionadas

Clusters do Amazon ECS

Métricas Amazon ECS Container Insights

Configurar o Container Insights no Amazon ECS para métricas no nível de cluster e no nível de serviço

Implantar o atendente do CloudWatch para coletar métricas no nível de instância do EC2 no Amazon ECS

Visualizar métricas do Container Insights