サードパーティーのモニタリングツールのアドオンを設定する

Network Flow Monitor アドオンを設定して、インストール中に OpenMetrics サーバーを公開できます。これにより、Prometheus などのサードパーティーのモニタリングツールとの統合が可能になり、既存のモニタリングインフラストラクチャとともにネットワークフローメトリクスを収集して分析できます。OpenMetrics の詳細について説明します。この機能はアドオンバージョン v1.1.0 から使用できます。

OpenMetrics サーバーを有効にするには、EKS Network Flow Monitor アドオンの設定値に OPEN_METRICS、OPEN_METRICS_ADDRESS、および OPEN_METRICS_PORT を追加します。このガイドでは、CLI とコンソールの両方を使用してこれを行う方法について説明します。設定値の追加の詳細については、「Amazon EKS アドオンの詳細設定」を参照してください。

CLI 設定

AWS Command Line Interface を使用する場合、設定値をパラメータとして指定できます。

aws eks create-addon \
  --cluster-name my-cluster-name \
  --addon-name aws-network-flow-monitoring-agent \
  --addon-version v1.1.0-eksbuild.1 \
  --configuration-values '{"env":{"OPEN_METRICS":"on","OPEN_METRICS_ADDRESS":"0.0.0.0","OPEN_METRICS_PORT":9109}}'

コンソール設定

Amazon EKS コンソールを使用する場合、これらの値は、設定値の一部として、[オプションの設定] で追加できます。

サンプル JSON:

{
    "env": {
        "OPEN_METRICS": "on",
        "OPEN_METRICS_ADDRESS": "0.0.0.0",
        "OPEN_METRICS_PORT": 9109
    }
}

サンプル YAML:

env:
  OPEN_METRICS: "on"
  OPEN_METRICS_ADDRESS: "0.0.0.0"
  OPEN_METRICS_PORT: 9109

EKS Network Flow Monitor アドオン OpenMetric パラメータ

重要: OPEN_METRICS_ADDRESS を 0.0.0.0 に設定すると、メトリクスエンドポイントは任意のネットワークインターフェイスからアクセス可能になります。localhost のみのアクセスにするために 127.0.0.1 を使用することを検討するか、適切なネットワークセキュリティコントロールを実装して、承認されたモニタリングシステムのみにアクセスを制限します。

トラブルシューティング

OpenMetrics サーバー設定で問題が発生した場合は、次の情報を使用して一般的な問題を診断して解決します。

メトリクスが表示されない

問題: OpenMetrics サーバーが設定されていますが、メトリクスがモニタリングツールに表示されません。

トラブルシューティングの手順:

特定のポッドに欠落しているメトリクス

問題: メトリクスが一部のポッドから使用できますが、クラスター内の他のポッドからは使用できません。

トラブルシューティングの手順:

Network Flow Monitor アドオンは、hostNetwork: true を使用するポッドをサポートしていません。ポッド仕様にこの設定が含まれている場合、それらのポッドからメトリクスを使用することはできません。

回避策: 可能であれば、ポッド仕様から hostNetwork: true 設定を削除します。アプリケーションにホストネットワークが必要な場合は、それらの特定のポッドに代替のモニタリングアプローチを使用することを検討してください。

接続がエラーを拒否しました

問題: メトリクスエンドポイントにアクセスしようとすると、「接続が拒否されました」というエラーが表示されます。

トラブルシューティングの手順:

検証手順

OpenMetrics 設定が正しく動作していることを確認するには: