Amazon EKS の OpenTelemetry メトリクスを使用した Container Insights

Amazon CloudWatch Observability EKS アドオンは、Amazon EKS クラスターからオープンソースメトリクスを収集し、OpenTelemetry Protocol (OTLP) を使用して 30 秒の精度でそれらを CloudWatch に送信します。これらのメトリクスは、cAdvisor、Prometheus Node Exporter、NVIDIA DCGM、Kube State Metrics、AWS Neuron Monitor など、元のソースのメトリクス名を使用します。これらのメトリクスは、CloudWatch Query Studio の PromQL を使用して、または Prometheus 互換クエリ API を介してクエリできます。

各メトリクスは、OpenTelemetry セマンティック規則属性、Kubernetes ポッドおよびノードラベルなど、最大 150 個のラベルで自動的に強化されます。PromQL はクエリ時に集計を処理するので、各メトリクスは複数の集計レベルではなく、リソースごとに 1 回発行されます。アドオンは、AWS Neuron および AWS Elastic Fabric Adapter からのアクセラレーターメトリクスを、それらを使用する特定のポッドとコンテナと関連付け、メトリクスソースだけでは利用できない可視性を提供します。

Amazon EKS クラスターで OTel Container Insights を有効にするには、Amazon CloudWatch Observability EKS アドオンバージョン v6.0.1-eksbuild.1 以降を Amazon EKS コンソールまたは Infrastructure as Code を介してインストールします。

OTel Container Insights のセットアップの詳細については、「Container Insights の設定」を参照してください。

PromQL を使用したこれらのメトリクスのクエリの詳細については、「PromQL クエリ」を参照してください。

OTel Container Insights を Container Insights と比較する方法 (拡張)

次の表は、Container Insights (拡張) と OTel Container Insights の違いをまとめたものです。

メトリクスをラベル付けする方法

OTel Container Insights によって収集された各メトリクスには、3 個のソースからのラベルが付けられます。

PromQL を使用してこれらの属性をクエリする方法の詳細については、「PromQL クエリ」を参照してください。

サポートされるメトリクス

次の表は、OTel Container Insights によって収集されたメトリクスソースとカテゴリを示します。

デュアルパブリッシュの無効化

Amazon CloudWatch Observability EKS アドオンバージョン v6.0.1-eksbuild.1 以降では、アドオンはデフォルトで Container Insights (レガシー) と OTel Container Insights の両方を通じてメトリクスを発行します。これらのうち 1 つだけを使用したい場合は、もう 1 つを無効にできます。

OTel Container Insights を無効化する

OTel Container Insights メトリクスの公開を停止し、レガシー Container Insights のみを使用するには、otelContainerInsights 設定を disabled に設定します。

次の設定値を使用します。

{"otelContainerInsights":{"enabled":false}}

次のコマンドを実行し、設定を適用します。

aws eks update-addon \
  --cluster-name CLUSTER_NAME \
  --addon-name amazon-cloudwatch-observability \
  --configuration-values '{"otelContainerInsights":{"enabled":false}}' \
  --region REGION

Container Insights を無効にします

レガシー Container Insights メトリクスの公開を停止し、OTel Container Insights のみを使用するには、containerInsights 設定を disabled に設定します。

次の設定値を使用します。

{"containerInsights":{"enabled":false}}

次のコマンドを実行し、設定を適用します。

aws eks update-addon \
  --cluster-name CLUSTER_NAME \
  --addon-name amazon-cloudwatch-observability \
  --configuration-values '{"containerInsights":{"enabled":false}}' \
  --region REGION