使用 Helm 部署 OTel 容器洞見

新增 Helm 儲存庫

1. 執行下列命令來新增儲存庫。

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

2. 更新儲存庫以取得最新的圖表版本。

   helm repo update

建立 CloudWatch 代理程式的 IAM 角色

1. 擷取叢集的 OIDC 發行者 URL。使用 Amazon EKS 叢集的名稱取代 cluster-name。

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

2. 使用 IRSA 的信任政策建立 IAM 角色。將 account-id 取代為 AWS 您的帳戶 ID，並將 oidc-id 取代為上一個步驟的 OIDC 提供者 ID （之後的部分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. 將 CloudWatchAgentServerPolicy 受管政策連接至角色。

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

安裝 Helm Chart

• 執行下列命令。將 cluster-name 取代為您的 Amazon EKS 叢集名稱、將 region 取代為您的 AWS 區域，並將 account-id 取代為您的 AWS 帳戶 ID。

  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

  重要

  otelContainerInsights.enabled 參數是必要參數。預設不會啟用 OTel Container Insights。

驗證 Helm 安裝

1. 確認 Helm 發行狀態顯示 deployed。

   helm list -n amazon-cloudwatch

2. 確認運算子 Pod 正在執行。

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

3. 確認 CloudWatch 代理程式 Pod 在所有節點上執行。

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

   所有代理程式 Pod 必須顯示Running狀態。

設定 cert-manager 整合

1. 確認叢集中已安裝 cert-manager。

   kubectl get pods -n cert-manager

2. 在啟用 cert-manager 的情況下安裝 Helm Chart。將 cluster-name 取代為您的 Amazon EKS 叢集名稱、將 region 取代為您的 AWS 區域，並將 account-id 取代為您的 AWS 帳戶 ID。

   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

升級 Helm Chart

1. 更新 Helm 儲存庫以取得最新的圖表版本。

   helm repo update

2. 使用所需的值執行升級命令。將 cluster-name 取代為您的 Amazon EKS 叢集名稱、將 region 取代為您的 AWS 區域，並將 account-id 取代為您的 AWS 帳戶 ID。

   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. 確認升級已成功完成。

   helm list -n amazon-cloudwatch

   修訂編號必須遞增，且狀態必須顯示 deployed。

解除安裝 Helm Chart

1. 執行下列命令來解除安裝 版本。

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

2. 或者，如果不再需要命名空間，請將其刪除。

   kubectl delete namespace amazon-cloudwatch

在 CloudWatch 中檢查指標

1. 透過 https://console.aws.amazon.com/cloudwatch/ 開啟 CloudWatch 主控台。

2. 在導覽窗格中，選擇容器洞見。

3. 確認您的叢集出現在叢集清單中，且基礎設施指標正在填入。