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.
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
}
}
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
-
Abra o console em https://console.aws.amazon.com/ecs/v2.
-
Na barra de navegação na parte superior, selecione a região da qual você deseja visualizar as configurações da conta.
-
Na página de navegação, selecione Account Settings (Configurações da conta).
-
Selecione Atualizar.
-
Para usar o Container Insights com observabilidade aprimorada, escolha Container Insights com observabilidade aprimorada.
Escolha Salvar alterações.
-
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
-
Abra o console em https://console.aws.amazon.com/ecs/v2.
-
Na barra de navegação na parte superior, selecione a região da qual você deseja visualizar as configurações da conta.
-
Na página de navegação, selecione Account Settings (Configurações da conta).
-
Selecione Atualizar.
-
Para usar o Container Insights, escolha Container Insights.
-
Escolha Salvar alterações.
-
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.