# OTel Container Insights (recomendado)
O OTel Container Insights é a abordagem recomendada para ativar o Container Insights em clusters do Amazon EKS. Desenvolvido com base no OpenTelemetry, ele fornece observabilidade abrangente em todas as métricas e logs com um modelo de implantação simplificado e desenvolvimento ativo contínuo.
Tanto o OTel Container Insights quanto o Enhanced Container Insights (Classic) usam o mesmo complemento do `amazon-cloudwatch-observability` Amazon EKS. A diferença é a versão e a configuração do complemento, não um produto diferente. O OTel Container Insights é a configuração mais recente e ativamente desenvolvida desse complemento.
Esta abordagem foi projetada para os seguintes casos de uso:
+ Novos clientes do Amazon EKS que desejam o caminho com melhor suporte para a observabilidade do cluster
+ Clientes existentes que desejam se consolidar em um único pipeline de telemetria moderno
+ Equipes que adotam o OpenTelemetry e que desejam integração nativa com o CloudWatch
## Benefícios principais
O OTel Container Insights fornece os seguintes benefícios:
+ **Configuração simplificada**: ative a observabilidade total em minutos por meio do console, da AWS CLI ou do CloudFormation
+ **Sinais abrangentes**: colete métricas e logs de uma única implantação de atendente
+ **Observabilidade aprimorada**: acesse métricas detalhadas do Kubernetes, insights em nível de pod e sinais correlacionados
+ **Desenvolvimento ativo**: recebe novos recursos, melhorias de desempenho e cobertura de sinal expandida de forma contínua
+ **Nativo do OpenTelemetry**: criado no OpenTelemetry Collector, alinhado com a estrutura de observabilidade padrão do setor
## Por que essa abordagem é recomendada
O OTel Container Insights é recomendado em relação a outras abordagens do Container Insights porque fornece a mais ampla cobertura de sinal (métricas e logs) com o modelo de implantação mais simples. Outras abordagens estão no modo somente de manutenção ou exigem uma configuração manual mais complexa.
A tabela a seguir compara o OTel Container Insights com o Enhanced Container Insights (Classic).
| Consideração | OTel Container Insights | Enhanced Container Insights (Classic) |
| --- | --- | --- |
| Sinais | Métricas, Logs | Métricas, Logs |
| Observabilidade aprimorada | Sim | Sim |
| Status da manutenção | Desenvolvimento ativo | Manutenção |
| Complexidade da implantação | Baixo | Baixo |
## Origens e receptores de métricas
O OTel Container Insights coleta métricas de receptores de código aberto e as enriquece automaticamente com as convenções semânticas do OpenTelemetry. Ao contrário do Enhanced Container Insights (Classic), que usa nomes de métricas proprietários, o OTel Container Insights preserva os nomes das métricas originais de cada fonte. Isso os torna compatíveis com os painéis existentes do PromQL e com a documentação da comunidade.
O OTel Container Insights coleta métricas de código aberto de vários receptores usando o OpenTelemetry Protocol (OTLP) com granularidade de 30 segundos. As métricas usam seus nomes originais (por exemplo, `container_cpu_usage_seconds_total` do cVisor) em vez de nomes no formato CloudWatch, e você pode consultá-las com o PromQL.
A tabela a seguir lista os receptores disponíveis e seus pré-requisitos.
| Receptor | O que ele coleta | Pré-requisitos |
| --- | --- | --- |
| cAdvisor | Métricas de CPU de contêiner, memória, rede, disco/sistema de arquivos | Integrado ao kubelet — sem configuração adicional |
| Exportador de nós do Prometheus | Métricas de CPU em nível de nó, memória, disco, sistema de arquivos, rede, sistema, VMstat, netstat/soquete | Incluído no complemento |
| Métricas de estado do Kube | Métricas de pod, nó, implantação, DaemonSet, StatefulSet, ReplicaSet, tarefa, CronJob, serviço, namespace, PV, PVC | Incluído no complemento |
| Servidor da API do Kubernetes | Servidor da API e métricas do etcd | Disponível no ambiente de gerenciamento |
| NVIDIA DCGM | Métricas de utilização da GPU, memória, alimentação/térmica, controle de utilização, erro/confiabilidade, métricas | É necessário um plug-in de dispositivo NVIDIA e um kit de ferramentas de contêiner |
| AWS Neuron Monitor | Métricas do sistema NeuronCore, NeuronDevice e Neuron | É necessário o driver Neuron e o plug-in do dispositivo |
| AWS Elastic Fabric Adapter | Métricas de rede do EFA | É necessário o plug-in de dispositivo do EFA |
| NVMe | Métricas de integridade SMART do NVMe | Sem configuração adicional |
Cada métrica é enriquecida com até 150 rótulos das três fontes a seguir:
1. **Etiquetas nativas da fonte de telemetria**: do receptor original (por exemplo, `pod`, `namespace`, `container` do cAdvisor)
1. **Atributos de recursos do OpenTelemetry**: seguindo as convenções semânticas do OTel para Kubernetes, Host e Cloud
1. **Rótulos de pod e nó do Kubernetes**: todos os rótulos da API Kubernetes, com prefixos `k8s.pod.label.*` e `k8s.node.label.*`
## Publicação e migração duplas
O OTel Container Insights é desativado por padrão. Para ativá-lo, defina `otelContainerInsights.enabled` como `true` na configuração do complemento.
A partir do complemento v6.2.0, são suportadas métricas de publicação por meio do Enhanced Container Insights (Classic) e do OTel Container Insights simultaneamente. Isso permite que você valide o novo pipeline de métricas antes de migrar totalmente.
Para ativar o OTel Container Insights junto com o Enhanced Container Insights (Classic), execute o comando a seguir.
```
aws eks update-addon \
--cluster-name {{cluster-name}} \
--addon-name amazon-cloudwatch-observability \
--configuration-values '{"containerInsights":{"enabled":true},"otelContainerInsights":{"enabled":true}}'
```
Para desativar o OTel Container Insights e manter somente o Enhanced Container Insights (Classic), execute o comando a seguir.
```
aws eks update-addon \
--cluster-name {{cluster-name}} \
--addon-name amazon-cloudwatch-observability \
--configuration-values '{"otelContainerInsights":{"enabled":false}}'
```
Para desativar o Enhanced Container Insights (Classic) e manter somente o OTel Container Insights, execute o comando a seguir.
```
aws eks update-addon \
--cluster-name {{cluster-name}} \
--addon-name amazon-cloudwatch-observability \
--configuration-values '{"containerInsights":{"enabled":false},"otelContainerInsights":{"enabled":true}}'
```
## Introdução
Use os tópicos a seguir para instalar e configurar o OTel Container Insights em seus clusters do Amazon EKS.
**Topics**
+ [Início rápido: OTel Container Insights no Amazon EKS](container-insights-eks-otel-quickstart.md): comece a usar o OTel Container Insights por meio do caminho de configuração mais rápido.
+ [Ative o OTel Container Insights a partir do console](container-insights-eks-otel-console.md): ative o OTel Container Insights por meio do console de gerenciamento da AWS.
+ [Implante o OTel Container Insights com o Helm](container-insights-eks-otel-helm.md): implante o OTel Container Insights usando o chart do Helm para um gerenciamento flexível e amigável ao GitOps.
+ [Implante o OTel Container Insights com CloudFormation](container-insights-eks-otel-cfn.md): implante o OTel Container Insights usando um modelo CloudFormation.
+ [Enviar logs ao Amazon CloudWatch](container-insights-eks-otel-logs.md): configure a coleta de logs para seus clusters do Amazon EKS.
+ [Configuração avançada para OTel Container Insights no Amazon EKS](container-insights-eks-otel-advanced.md): personalize e ajuste o OTel Container Insights para seu ambiente.