# Ative o OTel Container Insights a partir do console
<a name="container-insights-eks-otel-console"></a>

Você pode ativar o OTel Container Insights diretamente do Console de gerenciamento da AWS com um fluxo de trabalho com um mínimo de cliques. Essa abordagem é ideal se você preferir uma experiência orientada por interface de usuário e quiser permitir a observabilidade total em um cluster Amazon EKS existente sem escrever código de infraestrutura ou executar comandos de CLI.

## Pré-requisitos
<a name="container-insights-eks-otel-console-prereqs"></a>

Antes de ativar o OTel Container Insights no console, verifique se você atende aos seguintes requisitos.
+ Você está conectado ao console do Amazon EKS.
+ Um cluster existente do Amazon EKS executando o Kubernetes versão 1.28 ou posterior.
+ Versão 6.2.0 ou mais recente do complemento `amazon-cloudwatch-observability`.
+ Permissões do IAM: `eks:DescribeCluster`, `eks:UpdateClusterConfig`, `eks:ListAddons`, `eks:CreateAddon`, `eks:DescribeAddon`, `iam:AttachRolePolicy` e `iam:CreateServiceLinkedRole`.
+ O perfil do IAM do nó deve possuir a política `CloudWatchAgentServerPolicy` gerenciada anexada.
+ O cluster está no estado `ACTIVE`.

## Desative o OTel Container Insights
<a name="container-insights-eks-otel-console-enable"></a>

Use o procedimento a seguir para ativar o OTel Container Insights no console do Amazon EKS.

**Para ativar o OTel Container Insights usando o console**

1. Abra o console do Amazon EKS em [https://console.aws.amazon.com/eks/](https://console.aws.amazon.com/eks/).

1. Escolha **Clusters** e, em seguida, escolha o nome do cluster.

1. Escolha a guia **Observabilidade**.

1. Ao lado do status do **Container Insights**, escolha **Gerenciar**.

1. Selecione a configuração do **OTel Container Insights**.

1. Configure o perfil do IAM para o complemento. O console cria automaticamente o perfil, caso ainda não exista um.

1. Escolha **Habilitar**.

## O que o console configura
<a name="container-insights-eks-otel-console-actions"></a>

Quando você ativa o OTel Container Insights a partir do console, ele executa as seguintes ações em seu nome.
+ Cria e configura a associação da Identidade de Pods para o namespace `amazon-cloudwatch`
+ Instala o complemento `amazon-cloudwatch-observability` Amazon EKS com a versão 6.2.0 ou posterior e `otelContainerInsights.enabled=true`
+ Anexa o `CloudWatchAgentServerPolicy` ao perfil do IAM designado

## Verifique se os dados aparecem no CloudWatch
<a name="container-insights-eks-otel-console-verify"></a>

Depois de ativar o OTel Container Insights, os dados aparecem no CloudWatch em 5 minutos.

**Para verificar os dados do Container Insights**

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, escolha **Insights** e, em seguida, **Container Insights**.

1. Escolha seu cluster na lista.

Os painéis do Container Insights são preenchidos com dados de métricas do seu cluster.

## Solução de problemas
<a name="container-insights-eks-otel-console-troubleshoot"></a>

Use as orientações a seguir para resolver problemas comuns ao ativar o OTel Container Insights no console.

### O botão Ativar não está disponível
<a name="container-insights-eks-otel-console-ts-greyed-out"></a>

**Sintoma:** o botão **Ativar** está acinzentado e você não pode escolhê-lo.

**Causa:** o cluster pode estar em um estado de atualização ou você não tem permissões suficientes do IAM.

**Solução:** para resolver esse problema, siga as seguintes etapas:

1. Verifique se o status do cluster está `ACTIVE` na página de detalhes do cluster.

1. Verifique se o usuário ou o perfil do IAM tem as permissões necessárias listadas nos pré-requisitos.

1. Se o cluster estiver sendo atualizado, aguarde até que a atualização seja concluída e tente novamente.

### O status mostra DEGRADED após a ativação
<a name="container-insights-eks-otel-console-ts-degraded"></a>

**Sintoma:** depois de ativar o OTel Container Insights, o status do complemento mostra `DEGRADED`.

**Causa:** o complemento foi instalado, mas não pode funcionar corretamente, geralmente devido a problemas de permissão do perfil do IAM ou problemas de conectividade do nó.

**Solução:** para resolver esse problema, siga as seguintes etapas:

1. Verifique se o perfil do IAM tem a política gerenciada pela `CloudWatchAgentServerPolicy` anexada.

1. Verifique se os nós do cluster têm conectividade de saída com os endpoints do CloudWatch.

1. Verifique os detalhes de integridade do complemento no console do Amazon EKS escolhendo a guia **Complementos** na página de detalhes do cluster.