快速入門：Amazon EKS 上的 OTel Container Insights

使用主控台啟用 OTel Container Insights

1. 在 https://console.aws.amazon.com/eks/：// 開啟 Amazon EKS 主控台。

2. 選擇叢集，然後選擇您的叢集名稱。

3. 選擇可觀測性索引標籤。

4. 選擇啟用容器洞見，然後依照畫面上的指示操作。

建立 CloudWatch 可觀測性附加元件 IAM 角色

1. 執行下列命令來建立具有 EKS Pod Identity 信任政策的角色。

   aws iam create-role \
     --role-name EKS-CloudWatch-Observability-Role \
     --assume-role-policy-document '{
       "Version": "2012-10-17",
       "Statement": [{
         "Effect": "Allow",
         "Principal": { "Service": "pods.eks.amazonaws.com" },
         "Action": ["sts:AssumeRole", "sts:TagSession"]
       }]
     }'

2. 將 CloudWatchAgentServerPolicy 受管政策連接至角色。

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

建立 Pod Identity 關聯

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

  aws eks create-pod-identity-association \
    --cluster-name cluster-name \
    --namespace amazon-cloudwatch \
    --service-account cloudwatch-agent \
    --role-arn arn:aws:iam::account-id:role/EKS-CloudWatch-Observability-Role

安裝 附加元件

• 執行下列命令。使用 Amazon EKS 叢集的名稱取代 cluster-name。

  aws eks create-addon \
    --cluster-name cluster-name \
    --addon-name amazon-cloudwatch-observability \
    --configuration-values '{"otelContainerInsights":{"enabled":true}}'

  重要

  otelContainerInsights.enabled 組態是必要的。預設不會啟用 OTel Container Insights。

驗證附加元件狀態

• 執行下列命令。使用 Amazon EKS 叢集的名稱取代 cluster-name。

  aws eks describe-addon \
    --cluster-name cluster-name \
    --addon-name amazon-cloudwatch-observability \
    --query "addon.status" \
    --output text

  預期的輸出為 ACTIVE。

確認代理程式 Pod 正在執行

• 執行下列命令。

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

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

在 CloudWatch 中檢查指標

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

2. 在導覽窗格中，選擇查詢 Studio。

3. container_cpu_usage_seconds_total 使用 PromQL 搜尋 等指標。