Implante o OTel Container Insights com o Helm

Para adicionar o repositório do Helm

1. Execute o comando a seguir para adicionar o repositório.

   helm repo add aws-observability \
     https://aws-observability.github.io/helm-charts

2. Atualize o repositório para obter as versões mais recentes do chart.

   helm repo update

Para criar um perfil do IAM para uso com o atendente do CloudWatch

1. Recupere o URL do emissor do OIDC do cluster. Substitua cluster-name pelo nome do cluster do Amazon EKS.

   aws eks describe-cluster \
     --name cluster-name \
     --query "cluster.identity.oidc.issuer" \
     --output text

2. Crie um perfil do IAM com uma política de confiança para IRSA. Substitua account-id pelo ID da sua conta da AWS e oidc-id pelo ID do provedor OIDC da etapa anterior (a parte após https://oidc.eks.region.amazonaws.com/id/).

   aws iam create-role \
     --role-name EKS-CW-Observability-Role \
     --assume-role-policy-document '{
       "Version": "2012-10-17",
       "Statement": [{
         "Effect": "Allow",
         "Principal": {
           "Federated": "arn:aws:iam::account-id:oidc-provider/oidc.eks.region.amazonaws.com/id/oidc-id"
         },
         "Action": "sts:AssumeRoleWithWebIdentity",
         "Condition": {
           "StringEquals": {
             "oidc.eks.region.amazonaws.com/id/oidc-id:sub": "system:serviceaccount:amazon-cloudwatch:cloudwatch-agent"
           }
         }
       }]
     }'

3. Anexe a política gerenciada CloudWatchAgentServerPolicy à função.

   aws iam attach-role-policy \
     --role-name EKS-CW-Observability-Role \
     --policy-arn arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy

Para instalar o chart do Helm

• Execute o comando a seguir. Substitua cluster-name pelo nome do seu cluster Amazon EKS, region pela sua região da AWS e account-id pelo ID da sua conta da AWS.

  helm install amazon-cloudwatch-observability \
    aws-observability/amazon-cloudwatch-observability \
    --namespace amazon-cloudwatch \
    --create-namespace \
    --set clusterName=cluster-name \
    --set region=region \
    --set agent.serviceAccount.name=cloudwatch-agent \
    --set "agent.serviceAccount.annotations.eks\\.amazonaws\\.com/role-arn=arn:aws:iam::account-id:role/EKS-CW-Observability-Role" \
    --set otelContainerInsights.enabled=true

  Importante

  O parâmetro otelContainerInsights.enabled é obrigatório. O OTel Container Insights não está ativado por padrão.

Para verificar a instalação do Helm

1. Verifique se o status de lançamento do Helm mostra deployed.

   helm list -n amazon-cloudwatch

2. Confirme se o pod do operador está sendo executado.

   kubectl get pods -n amazon-cloudwatch -l app.kubernetes.io/name=amazon-cloudwatch-observability

3. Confirme se os pods do atendente do CloudWatch estão em execução em todos os nós.

   kubectl get pods -n amazon-cloudwatch -l app.kubernetes.io/name=cloudwatch-agent

   Todos os pods de atendentes devem mostrar o status Running.

Para configurar a integração do cert-manager

1. Verifique se o cert-manager está instalado no seu cluster.

   kubectl get pods -n cert-manager

2. Instale o chart do Helm com o cert-manager ativado. Substitua cluster-name pelo nome do seu cluster Amazon EKS, region pela sua região da AWS e account-id pelo ID da sua conta da AWS.

   helm install amazon-cloudwatch-observability \
     aws-observability/amazon-cloudwatch-observability \
     --namespace amazon-cloudwatch \
     --create-namespace \
     --set clusterName=cluster-name \
     --set region=region \
     --set agent.serviceAccount.name=cloudwatch-agent \
     --set "agent.serviceAccount.annotations.eks\\.amazonaws\\.com/role-arn=arn:aws:iam::account-id:role/EKS-CW-Observability-Role" \
     --set otelContainerInsights.enabled=true \
     --set admissionWebhooks.certManager.enabled=true

Para atualizar o chart do Helm

1. Atualize o repositório do Helm para obter as versões mais recentes do chart.

   helm repo update

2. Execute o comando de atualização com seus valores desejados. Substitua cluster-name pelo nome do seu cluster Amazon EKS, region pela sua região da AWS e account-id pelo ID da sua conta da AWS.

   helm upgrade amazon-cloudwatch-observability \
     aws-observability/amazon-cloudwatch-observability \
     --namespace amazon-cloudwatch \
     --set clusterName=cluster-name \
     --set region=region \
     --set agent.serviceAccount.name=cloudwatch-agent \
     --set "agent.serviceAccount.annotations.eks\\.amazonaws\\.com/role-arn=arn:aws:iam::account-id:role/EKS-CW-Observability-Role" \
     --set otelContainerInsights.enabled=true

3. Verifique se a atualização foi concluída com êxito.

   helm list -n amazon-cloudwatch

   O número da revisão deve ser incrementado e o status deve mostrar deployed.

Para desinstalar o chart do Helm

1. Execute o comando a seguir para desinstalar a versão.

   helm uninstall amazon-cloudwatch-observability \
     --namespace amazon-cloudwatch

2. Opcionalmente, exclua o namespace caso ele não seja mais necessário.

   kubectl delete namespace amazon-cloudwatch

Para verificar as métricas no CloudWatch

1. Abra o console do CloudWatch, em https://console.aws.amazon.com/cloudwatch/.

2. No painel de navegação, selecione Container Insights.

3. Verifique se seu cluster aparece na lista de clusters e se as métricas de infraestrutura estão sendo preenchidas.