Amazon EKS での OTel Container Insights の詳細設定

次のコマンドを実行して、ログフィルター設定でアドオンを更新します。cluster-name は、自分の Amazon EKS クラスターに置き換えます。

aws eks update-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --configuration-values '{
    "otelContainerInsights": {
      "enabled": true
    },
    "agent": {
      "config": {
        "logs": {
          "metrics_collected": {
            "kubernetes": {
              "enhanced_container_insights": true
            }
          },
          "exclude_filters": [
            {
              "type": "log_level_filter",
              "log_level": "DEBUG"
            }
          ]
        }
      }
    }
  }' \
  --resolve-conflicts OVERWRITE

更新後、アドオンのステータスが ACTIVE であることを確認します。

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

中央モニタリングアカウントで、ワークロードアカウントが引き受けることを許可する信頼ポリシーを持つ IAM ロールを作成します。workload-account-id をワークロードアカウントの AWS アカウント ID に置き換えます。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::workload-account-id:root"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

CloudWatchAgentServerPolicy 管理ポリシーをクロスアカウントロールにアタッチします。

ワークロードアカウントで、アドオンを更新してクロスアカウントロールを引き受けます。cluster-name を Amazon EKS クラスターの名前に置き換え、monitoring-account-id を中央モニタリングアカウントのアカウントの AWS ID に置き換えます。

aws eks update-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --configuration-values '{
    "otelContainerInsights": {
      "enabled": true
    },
    "agent": {
      "config": {
        "credentials": {
          "role_arn": "arn:aws:iam::monitoring-account-id:role/CrossAccountCWObservabilityRole"
        }
      }
    }
  }' \
  --resolve-conflicts OVERWRITE

更新後、アドオンのステータスが ACTIVE であることを確認します。

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

次のコマンドを実行して、カスタムディメンションを設定します。cluster-name を Amazon EKS クラスターの名前に置き換え、label-key をディメンションとして使用する Kubernetes ラベルに置き換えます。

aws eks update-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --configuration-values '{
    "otelContainerInsights": {
      "enabled": true
    },
    "agent": {
      "config": {
        "logs": {
          "metrics_collected": {
            "kubernetes": {
              "enhanced_container_insights": true,
              "metric_dimensions": {
                "custom_dimensions": ["label-key"]
              }
            }
          }
        }
      }
    }
  }' \
  --resolve-conflicts OVERWRITE

更新後、アドオンのステータスが ACTIVE であることを確認します。

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

次のコマンドを実行して、リソースリクエストと制限を設定します。cluster-name を Amazon EKS クラスターの名前に置き換え、リソース値を上記の表の値に置き換えます。

aws eks update-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --configuration-values '{
    "otelContainerInsights": {
      "enabled": true
    },
    "agent": {
      "resources": {
        "requests": {
          "cpu": "cpu-request",
          "memory": "memory-request"
        },
        "limits": {
          "cpu": "cpu-limit",
          "memory": "memory-limit"
        }
      }
    }
  }' \
  --resolve-conflicts OVERWRITE

アドオンのステータスが ACTIVE であり、エージェントポッドが新しいリソース割り当てで再起動することを確認します。

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

エージェントポッドが新しいリソース制限で実行されていることを確認します。

kubectl get pods -n amazon-cloudwatch -l app.kubernetes.io/name=cloudwatch-agent -o jsonpath='{.items[0].spec.containers[0].resources}'

アドオンのステータスが ACTIVE であることを確認します。cluster-name は、自分の Amazon EKS クラスターに置き換えます。

aws eks describe-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --query "addon.{Status:status,ConfigValues:configurationValues}" \
  --output table

エージェントポッドが再起動し、Running ステータスになっていることを確認します。

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

すべてのエージェントポッドは、最新の再起動時刻で Running ステータスになっている必要があります。