

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon EKS および Kubernetes のメトリクス
<a name="kubernetes-eks-metrics"></a>

Kubernetes には、リソース使用量メトリクス（ノードおよびポッドの CPU およびメモリ使用量など）にアクセスできるメトリクス API が提供されますが、API はポイントインタイム情報のみを提供し、履歴メトリックは提供しません。[Kubernetes メトリックスサーバー](https://github.com/kubernetes-sigs/metrics-server) は、通常、Amazon EKS および Kubernetes のデプロイで、メトリクスの集約、メトリクスに関する短期的な履歴情報の提供、[Horizontal Pod Autoscaler](https://kubernetes.io/docs/tasks/run-application/horizontal-pod-autoscale/) のような機能をサポートするために使用されます。

Amazon EKS は [Prometheus 形式で](https://docs.aws.amazon.com//eks/latest/userguide/prometheus.html) Kubernetes API サーバーを介してコントロールプレーンのメトリクスを公開しており、CloudWatch は、これらのメトリクスをキャプチャして取り込むことができます。CloudWatch とコンテナインサイトは、Amazon EKS ノードとポッドの包括的なメトリクスのキャプチャ、分析、およびアラームを提供するように構成することもできます。

## Kubernetes コントロールプレーンのメトリクス
<a name="kubernetes-control-plane-metrics"></a>

`/metrics` HTTP API エンドポイントを使用し Kubernetes は、Prometheus 形式でコントロールプレーンのメトリックを公開します。Kubernetes クラスターに [Prometheus](https://prometheus.io/) インストールし、これらのメトリクスをウェブブラウザーでグラフ化して表示します。また、Kubernetes API サーバーによって CloudWatch により、[公開されたメトリクスを取り込めます](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/ContainerInsights-Prometheus-Setup-configure.html#ContainerInsights-Prometheus-Setup-new-exporters)。

## Kubernetes のノードとシステムメトリック
<a name="kubernetes-node-system-metrics"></a>

Kubernetes が Prometheus を提供する [メトリクスサーバー](https://github.com/kubernetes-sigs/metrics-server) できるポッド [デプロイして実行する](https://docs.aws.amazon.com//eks/latest/userguide/metrics-server.html) クラスター、ノード、ポッドレベルの CPU およびメモリの統計情報については、Kubernetes クラスタ上で実行します。これらのメトリクスは、[Horizontal Pod Autoscaler](https://kubernetes.io/docs/tasks/run-application/horizontal-pod-autoscale/)、そして [Vertical Pod Autoscaler](https://docs.aws.amazon.com/eks/latest/userguide/vertical-pod-autoscaler.html) に使用されます。CloudWatch はこれらのメトリクスを提供することもできます。

Kubernetes [Kubernetes ダッシュボード](https://github.com/kubernetes/dashboard) または、水平および垂直ポッドオートスケーラーを使用する場合は、Kubernetes メトリクスサーバをインストールする必要があります。Kubernetes ダッシュボードは、Kubernetes クラスター、ノード、ポッド、および関連する構成を参照して構成し、Kubernetes メトリクスサーバーから CPU およびメモリのメトリックを表示するのに役立ちます。

Kubernetes メトリクスサーバーによって提供されるメトリックは、Auto Scaling 以外の目的（モニタリングなど）には使用できません。メトリックは、過去の分析ではなく、ポイントインタイム分析を対象としています。Kubernetes ダッシュボードは、`dashboard-metrics-scraper` Kubernetes メトリクスサーバーからのメトリックを短時間ウィンドウに保存します。

Container Insights は、Kubernetes DaemCloudWatch set で実行中のすべてのコンテナを検出し、ノードレベルのメトリクスを提供します。次に、パフォーマンススタックの各レイヤーでパフォーマンスデータを収集します。クイックスタートから AWS クイックスタートを使用するか、Container Insights を個別に設定できます。クイックスタートでは、CloudWatch エージェントによるメトリクスのモニタリングと Fluent Bit によるロギングを設定するため、ロギングとモニタリングのために一度だけデプロイする必要があります。

Amazon EKS ノードは EC2 インスタンスであるため、Amazon EC2 に対して定義した標準を使用して、コンテナインサイトによってキャプチャされたメトリクスに加えて、システムレベルのメトリックスをキャプチャする必要があります。 Amazon EKS クラスターの CloudWatch エージェントをインストールして設定するには、[CloudWatch エージェントのデプロイと設定のステートマネージャーとディストリビューターをセットアップする](install-cloudwatch-systems-manager.md#set-up-systems-manager-distributor) このガイドのセクションと同じ方法で使用できます。Amazon EKS 固有の CloudWatch 設定ファイルを更新して、メトリクスと Amazon EKS 固有のログ設定を含めることができます。

Prometheus をサポートするエージェントは、Prometheus メトリクスを自動的に検出して [サポートされているコンテナ化されたワークロードとシステム](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/ContainerInsights-Prometheus.html) をスクレイプできます。CloudWatch Logs Insights を使用して分析するために、組み込みメトリックス形式の CloudWatch Logs としてそれらを取り込み、CloudWatch メトリクスを自動的に作成します。

**重要**  
Prometheus メトリクスを収集するための CloudWatch エージェントの [特殊バージョンをデプロイ](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/ContainerInsights-Prometheus-Setup.html#ContainerInsights-Prometheus-Setup-install-agent) を行う必要があります。これは、コンテナインサイト用にデプロイされた CloudWatch エージェントとは別のエージェントです。Prometheus メトリクスの検出を実証するための CloudWatch エージェントと Amazon EKS ポッドデプロイのデプロイと設定ファイルが含まれている [prometheus\$1jmx](https://github.com/aws-samples/logging-monitoring-apg-guide-examples/tree/main/examples/eks/prometheus_jmx) サンプル の Java アプリケーションを使用できます。詳細については、CloudWatch のドキュメント内の「[Amazon EKS および Kubernetes で Java/JMX サンプルワークロードをセットアップ](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/ContainerInsights-Prometheus-Sample-Workloads-javajmx.html)」を参照してください。また、Amazon EKS クラスターで実行中の他の Prometheus ターゲットからメトリクスをキャプチャするように CloudWatch エージェントを設定することもできます。

## アプリケーションメトリクス
<a name="application-metrics-eks"></a>

[CloudWatch の埋め込みメトリクス形式](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format.html) を使用して、独自のアプリケーションメトリクスを作成、取得することも可能です。埋め込みメトリック形式ステートメントを取り込むには、埋め込みメトリック形式のエントリを埋め込みメトリック形式のエンドポイントに送信する必要があります。CloudWatch エージェントは、[Amazon EKS ポッドのサイドカーコンテナ](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format_Generation_CloudWatch_Agent.html) を設定できます。CloudWatch エージェント設定は Kubernetes ConfigMap として保存され、CloudWatch エージェントサイドカーコンテナによって読み込まれ、埋め込みメトリックス形式のエンドポイントを開始します。

また、アプリケーションを Prometheus ターゲットとして設定し、Prometheus サポートを使用して CloudWatch エージェントを設定して、メトリクスを検出、スクレープ、CloudWatch に取り込むこともできます。たとえば、[オープンソースの JMX エクスポーター](https://github.com/prometheus/jmx_exporter) と一緒に Java アプリケーションを使用して、CloudWatch エージェントによる Prometheus 消費用の JMX Bean を公開します。

埋め込みメトリクス形式を使用しない場合は、[AWS API](https://docs.aws.amazon.com//AmazonCloudWatch/latest/APIReference/Welcome.html) または [AWS SDK](https://aws.amazon.com/developer/tools/) を使用して CloudWatch メトリクスを作成および更新することもできます。ただし、モニタリングとアプリケーションロジックが混在するため、このアプローチはお勧めしません。

## Fargate での Amazon EKS のメトリクス
<a name="metrics-fargate-eks-workloads"></a>

Fargate は Kubernetes ポッドを実行するために Amazon EKS ノードを自動的にプロビジョニングするため、ノードレベルのメトリクスを監視および収集する必要はありません。ただし、Fargate の Amazon EKS ノードで実行されているポッドのメトリクスを監視する必要があります。コンテナインサイトは、現在サポートされていない次の機能が必要なため、Fargate 上の Amazon EKS では現在利用できません。
+ DaemonSets は現在サポートされていません。コンテナインサイトは、CloudWatch エージェントを各クラスターノードで DaemonSet として実行することによってデプロイされます。
+ HostPath パーシステントボリュームはサポートされていません。CloudWatch エージェントコンテナは、コンテナメトリックスデータを収集するための前提条件として HostPath パーシステントボリュームを使用します。
+ Fargate は、特権コンテナーとホスト情報へのアクセスを防止します。

[Fargate 用の内蔵ログルータ](https://docs.aws.amazon.com//eks/latest/userguide/fargate-logging.html) を使用して、埋め込みメトリクスフォーマットステートメントを CloudWatch に送信します。ログルーターは Fluent Bit を使用します。Fluent Bit には CloudWatch プラグインがあり、組み込みメトリックス形式のステートメントをサポートするように設定できます。

Fargate ノードのポッドレベルのメトリクスを取得してキャプチャするには、Prometheus サーバーを Amazon EKS クラスターにデプロイして Fargate ノードからメトリクスを収集します。Prometheus は永続ストレージを必要とするため、永続ストレージに Amazon Elastic File System (Amazon EFS) を使用する場合は、Prometheus を Fargate にデプロイできます。また、Amazon EC2 バッキングされたノードに Prometheus をデプロイすることもできます。詳細については、 ブログの「[Monitoring Amazon EKS on AWS Fargate using Prometheus and Grafana](https://aws.amazon.com//blogs/containers/monitoring-amazon-eks-on-aws-fargate-using-prometheus-and-grafana/)」を参照してください。 AWS 