Helm を使用した新しい Prometheus サーバーからの取り込みの設定

このセクションの手順に従うと、Amazon Managed Service for Prometheus を迅速に設定して稼働させることができます。ここでは、Amazon EKS クラスターに新しい Prometheus サーバーをセットアップします。新しいサーバーは、デフォルト設定を使用して Amazon Managed Service for Prometheus にメトリクスを送信します。この方法には次の前提条件があります。

• 新しい Prometheus サーバーがメトリクスを収集する Amazon EKS クラスターが必要です。

• Amazon EKS クラスターには、Amazon EBS CSI ドライバーがインストールされている必要があります (Helm で必要）。

• Helm CLI 3.0 以降を使用する必要があります。

• 以下のセクションの手順を実行するには、Linux または macOS コンピュータを使用する必要があります。

ステップ 1: 新しい Helm チャートリポジトリを追加する

次のコマンドを入力して、新しい Helm チャートリポジトリを追加します。これらのコマンドの詳細については、「Helm Repo」を参照してください。

helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo add kube-state-metrics https://kubernetes.github.io/kube-state-metrics
helm repo update

ステップ 2: Prometheus 名前空間を作成する

次のコマンドを入力して、Prometheus サーバーとその他のモニタリングコンポーネント用の Prometheus 名前空間を作成します。prometheus-namespace は、この名前空間に付ける名前に置き換えます。

kubectl create namespace prometheus-namespace

ステップ 3: サービスアカウントの IAM ロールを設定する

ここで説明するオンボーディング方法では、Prometheus サーバーが実行されている Amazon EKS クラスターでサービスアカウントの IAM ロールを使用する必要があります。

サービスアカウントの IAM ロールを使用すると、IAM ロールを Kubernetes サービスアカウントに関連付けることができます。このサービスアカウントは、そのサービスアカウントを使用するポッド内のコンテナに AWS アクセス許可を提供できます。詳細については、「サービスアカウントの IAM ロール」を参照してください。

これらのロールをまだ設定していない場合は、「Amazon EKS クラスターからメトリクスを取り込むためのサービスロールの設定」の手順に従ってロールを設定します。そのセクションの手順では、eksctl を使用する必要があります。詳細については、「Amazon Elastic Kubernetes Service の開始方法 - eksctl」を参照してください。

注記

EKS または ではなく AWS 、アクセスキーとシークレットキーのみを使用して Amazon Managed Service for Prometheus にアクセスする場合、 EKS-IAM-ROLE ベースの SigV4 を使用することはできません。

ステップ 4: 新しいサーバーをセットアップしてメトリクスの取り込みを開始する

Amazon Managed Service for Prometheus ワークスペースにメトリクスを送信する新しい Prometheus サーバーをインストールするには、以下の手順に従います。

Amazon Managed Service for Prometheus ワークスペースにメトリクスを送信する新しい Prometheus サーバーをインストールするには

1. テキストエディタを使用して、my_prometheus_values_yaml という名前のファイルを作成し、次の内容を記述します。

   • IAM_PROXY_PROMETHEUS_ROLE_ARN を、 で作成した の ARN に置き換えamp-iamproxy-ingest-roleますAmazon EKS クラスターからメトリクスを取り込むためのサービスロールの設定。

   • WORKSPACE_ID は、Amazon Managed Service for Prometheus ワークスペースの ID に置き換えます。

   • REGION は、Amazon Managed Service for Prometheus のリージョンに置き換えます。

   ## The following is a set of default values for prometheus server helm chart which enable remoteWrite to AMP
   ## For the rest of prometheus helm chart values see: https://github.com/prometheus-community/helm-charts/blob/main/charts/prometheus/values.yaml
   ##
   serviceAccounts:
     server:
       name: amp-iamproxy-ingest-service-account
       annotations: 
         eks.amazonaws.com/role-arn: ${IAM_PROXY_PROMETHEUS_ROLE_ARN}
   server:
     remoteWrite:
       - url: https://aps-workspaces.${REGION}.amazonaws.com/workspaces/${WORKSPACE_ID}/api/v1/remote_write
         sigv4:
           region: ${REGION}
         queue_config:
           max_samples_per_send: 1000
           max_shards: 200
           capacity: 2500

2. 次のコマンドを入力して、Prometheus サーバーを作成します。

   • を Prometheus リリース名prometheus-chart-nameに置き換えます。

   • prometheus-namespace は、Prometheus 名前空間の名前に置き換えます。

   helm install prometheus-chart-name prometheus-community/prometheus -n prometheus-namespace \
   -f my_prometheus_values_yaml

   注記

   helm install コマンドはさまざまな方法でカスタマイズできます。詳細については、「Helm ドキュメント」の「Helm install」を参照してください。