Helm を使用して OTel Container Insights をデプロイする

Helm リポジトリを追加するには

1. 次のコマンドを実行してリポジトリを追加します。

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

2. リポジトリを更新して、最新のチャートバージョンを取得します。

   helm repo update

CloudWatch エージェント用の IAM ロールを作成するには

1. クラスターの OIDC 発行者 URL を取得します。cluster-name は、自分の Amazon EKS クラスターに置き換えます。

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

2. IRSA の信頼できるポリシーを使用して IAM ロールを作成します。account-id を自分の AWS アカウント ID に、oidc-id を前のステップ (https://oidc.eks.region.amazonaws.com/id/ の後の部分) の OIDC プロバイダー 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 チャートをインストールするには

• 以下のコマンドを実行してください。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. オペレーターポッドが実行されていることを確認します。

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

3. CloudWatch エージェントポッドがすべてのノードで実行されていることを確認します。

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

   すべてのエージェントポッドが Running ステータスになっている必要があります。

cert-manager 統合を設定するには

1. cert-manager がクラスターにインストールされていることを確認します。

   kubectl get pods -n cert-manager

2. cert-manager を有効にして Helm チャートをインストールします。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 チャートをアップグレードするには

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 チャートをアンインストールするには

1. 次のコマンドを実行してリリースをアンインストールします。

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

2. 必要に応じて、不要になった名前空間があれば削除します。

   kubectl delete namespace amazon-cloudwatch

CloudWatch でメトリクスを確認するには

1. CloudWatch コンソールの https://console.aws.amazon.com/cloudwatch/ を開いてください。

2. ナビゲーションペインで、[Container Insights] を選択します。

3. クラスターがクラスターリストに表示され、インフラストラクチャメトリクスが入力されていることを確認します。