Configurar o Container Insights no Amazon ECS

Você pode configurar o Container Insights com observabilidade aprimorada ou o Container Insights em clusters novos e existentes do Amazon ECS usando o console do Amazon ECS ou a AWS CLI. O Container Insights coleta métricas nos níveis de cluster, de tarefa e de serviço. O Container Insights com observabilidade aprimorada fornece dimensões e métricas adicionais, permitindo que você se aprofunde na visibilidade em nível de contêiner.

Se estiver usando o Amazon ECS em uma instância do Amazon EC2, execute essa instância usando uma AMI que inclua o agente do Amazon ECS versão 1.29 ou posterior. Para obter informações sobre como atualizar a versão do agente, consulte Atualizar o agente de contêiner do Amazon ECS.

nota

Se a chave do AWS KMS gerenciada pelo cliente que você usa para as métricas do Amazon ECS Container Insights ainda não estiver configurada para funcionar com o CloudWatch, você deverá atualizar a política de chave para permitir logs criptografados no CloudWatch Logs. Você também deve associar sua própria chave do AWS KMS ao grupo de logs em /aws/ecs/containerinsights/ClusterName/performance. Para obter mais informações, consulte Criptografar dados de logs no CloudWatch Logs usando o AWS Key Management Service.

Recomendamos que você use o Container Insights com observabilidade aprimorada em vez do Container Insights, pois ele fornece visibilidade detalhada no ambiente de contêiner, reduzindo o tempo médio de resolução.

Configurar o Container Insights com observabilidade aprimorada

Você pode ativar o Container Insights com observabilidade aprimorada usando o console do Amazon ECS ou a AWS CLI.

AWS CLI

Use o comando a seguir para ativar o Container Insights com observabilidade aprimorada.

Definir a configuração da conta containerInsights como enhanced

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

Exemplo de saída

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

nota

Por padrão, o put-account-setting apenas é aplicável ao usuário autenticado no momento. Para habilitar a configuração em nível de conta para todos os usuários e perfis, trabalhe com o usuário-raiz, como no exemplo a seguir.

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

Depois de definir essa configuração de conta, todos os novos clusters usarão automaticamente o Container Insights com observabilidade aprimorada. Use o comando update-cluster-settings para adicionar o Container Insights com observabilidade aprimorada ao cluster existente, ou para atualizar clusters que atualmente usam o Container Insights para o Container Insights com observabilidade aprimorada.

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

Amazon ECS console

1. Abra o console em https://console.aws.amazon.com/ecs/v2.

2. Na barra de navegação na parte superior, selecione a região da qual você deseja visualizar as configurações da conta.

3. Na página de navegação, selecione Account Settings (Configurações da conta).

4. Selecione Atualizar.

5. Para usar o Container Insights com observabilidade aprimorada, escolha Container Insights com observabilidade aprimorada.

6. Escolha Salvar alterações.

7. Na tela de confirmação, escolha Confirm (Confirmar) para salvar a seleção.

Depois de definir isso, todos os novos clusters usarão automaticamente o Container Insights com observabilidade aprimorada. Você pode adicionar o Container Insights com observabilidade aprimorada ao cluster existente, ou pode atualizar clusters que atualmente usam o Container Insights para o Container Insights com observabilidade aprimorada. Para obter mais informações, consulte Atualização de um cluster do Amazon ECS no Guia do desenvolvedor do Amazon Elastic Container Service.

Configurar o Container Insights

Você pode ativar o Container Insights usando o console do Amazon ECS ou a AWS CLI.

AWS CLI

Para usar o Container Insights, defina a configuração da conta container Insights como enabled. Use o comando a seguir para ativar o Container Insights.

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

Exemplo de saída

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

Ao definir a configuração da conta container Insights como enabled, todos os novos clusters terão o Container Insights habilitado por padrão. Use o comando update-cluster-settings para adicionar o Container Insights a um cluster existente.

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

Amazon ECS console

1. Abra o console em https://console.aws.amazon.com/ecs/v2.

2. Na barra de navegação na parte superior, selecione a região da qual você deseja visualizar as configurações da conta.

3. Na página de navegação, selecione Account Settings (Configurações da conta).

4. Selecione Atualizar.

5. Para usar o Container Insights, escolha Container Insights.

6. Escolha Salvar alterações.

7. Na tela de confirmação, escolha Confirm (Confirmar) para salvar a seleção.

Depois de definir isso, todos os novos clusters usarão automaticamente o Container Insights. Atualize os clusters existentes para adicionar o Container Insights. Para obter mais informações, consulte Atualização de um cluster do Amazon ECS no Guia do desenvolvedor do Amazon Elastic Container Service.