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

使用控制台启用 OTel Container Insights

1. 从以下位置打开 Amazon EKS 控制台：https://console.aws.amazon.com/eks/。

2. 选择集群，然后选择您的集群名称。

3. 选择可观测性选项卡。

4. 选择启用 Container Insights，然后按照屏幕上的说明进行操作。

创建 CloudWatch 可观测性附加组件 IAM 角色

1. 运行以下命令为 EKS 容器组身份创建具有信任策略的角色。

   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

创建容器组身份关联

• 运行如下命令。将 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

安装附加组件

• 运行如下命令。将 cluster-name 替换为 Amazon EKS 集群的名称。

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

  重要

  otelContainerInsights.enabled 配置是必需的。默认情况下，OTel Container Insights 未启用。

确认附加组件状态

• 运行如下命令。将 cluster-name 替换为 Amazon EKS 集群的名称。

  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. 在导航窗格中，选择 Query Studio。

3. 使用 PromQL 搜索指标，例如 container_cpu_usage_seconds_total。