Implementación de Información de contenedores de OTel con Helm

Adición del repositorio de Helm

1. Ejecute el siguiente comando para agregar el repositorio.

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

2. Actualice el repositorio para obtener las últimas versiones de los gráficos.

   helm repo update

Creación del rol de IAM para el agente de CloudWatch

1. Recupere la URL del emisor de OIDC para su clúster. Reemplace cluster-name por el nombre del clúster de Amazon EKS.

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

2. Cree el rol de IAM con una política de confianza para IRSA. Sustituya account-id por su ID de cuenta de AWS y oidc-id por el ID de proveedor del OIDC del paso anterior (la parte que viene después de 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. Asocie la política administrada por CloudWatchAgentServerPolicy al rol.

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

Instalación del gráfico de Helm

• Ejecute el siguiente comando. Sustituya cluster-name por el nombre del clúster de Amazon EKS, region por la región de AWS y account-id por el ID de cuenta de 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

  El parámetro otelContainerInsights.enabled es obligatorio. Información de contenedores de OTel no está activado de forma predeterminada.

Verificación de la instalación de Helm

1. Compruebe que el estado de lanzamiento de Helm sea deployed.

   helm list -n amazon-cloudwatch

2. Confirme que el pod del operador se esté ejecutando.

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

3. Confirme que los pods de agentes de CloudWatch estén en ejecución en todos los nodos.

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

   Todos los pods de agentes deben mostrar el estado Running.

Configuración de la integración de cert-manager

1. Compruebe que cert-manager esté instalado en el clúster.

   kubectl get pods -n cert-manager

2. Instale el gráfico de Helm con cert-manager activado. Sustituya cluster-name por el nombre del clúster de Amazon EKS, region por la región de AWS y account-id por el ID de cuenta de 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

Actualización del gráfico de Helm

1. Actualice el repositorio de Helm para obtener las últimas versiones de los gráficos.

   helm repo update

2. Ejecute el comando de actualización con los valores que desee. Sustituya cluster-name por el nombre del clúster de Amazon EKS, region por la región de AWS y account-id por el ID de cuenta de 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. Compruebe que la actualización se haya completado correctamente.

   helm list -n amazon-cloudwatch

   El número de revisión debe incrementarse y el estado debe ser deployed.

Desinstalación del gráfico de Helm

1. Ejecute el siguiente comando para desinstalar el lanzamiento.

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

2. Si lo desea, elimine el espacio de nombres si ya no lo necesita.

   kubectl delete namespace amazon-cloudwatch

Comprobación de métricas en CloudWatch

1. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

2. En el panel de navegación, elija Información de contenedores.

3. Compruebe que el clúster aparezca en la lista de clústeres y que las métricas de infraestructura se estén rellenando.