Control plane metrics with Prometheus - Amazon EKS
Viewing the raw metricsDeploying Prometheus

英語の翻訳が提供されている場合で、内容が矛盾する場合には、英語版がオリジナルとして取り扱われます。翻訳は機械翻訳により提供されています。

Control plane metrics with Prometheus

Kubernetes API サーバーは、モニタリングと分析に役立つ多数のメトリクスを公開します。これらのメトリクスは、/metrics HTTP API を参照するメトリクスエンドポイントを介して内部的に公開されます。他のエンドポイントと同様に、このエンドポイントは Amazon EKS コントロールプレーンに公開されます。このトピックでは、このエンドポイントを使用してクラスターの動作を表示および分析する方法をいくつか説明します。

Viewing the raw metrics

未加工メトリクスの出力を表示するには、--raw フラグを付けて kubectl を使用します。このコマンドを使用すると、任意の HTTP パスを渡して未加工のレスポンスを返すことができます。 

kubectl get --raw /metrics

出力例。

...
# HELP rest_client_requests_total Number of HTTP requests, partitioned by status code, method, and host.
# TYPE rest_client_requests_total counter
rest_client_requests_total{code="200",host="127.0.0.1:21362",method="POST"} 4994
rest_client_requests_total{code="200",host="127.0.0.1:443",method="DELETE"} 1
rest_client_requests_total{code="200",host="127.0.0.1:443",method="GET"} 1.326086e+06
rest_client_requests_total{code="200",host="127.0.0.1:443",method="PUT"} 862173
rest_client_requests_total{code="404",host="127.0.0.1:443",method="GET"} 2
rest_client_requests_total{code="409",host="127.0.0.1:443",method="POST"} 3
rest_client_requests_total{code="409",host="127.0.0.1:443",method="PUT"} 8
# HELP ssh_tunnel_open_count Counter of ssh tunnel total open attempts
# TYPE ssh_tunnel_open_count counter
ssh_tunnel_open_count 0
# HELP ssh_tunnel_open_fail_count Counter of ssh tunnel failed open attempts
# TYPE ssh_tunnel_open_fail_count counter
ssh_tunnel_open_fail_count 0

この未加工出力は、API サーバーが公開する内容をそのまま返します。これらのメトリクスは Prometheus 形式で表されます。この形式により、API サーバーはさまざまなメトリクスを行に分けて公開できます。各行には、メトリクス名、タグ、および値が含まれます。 

metric_name{"tag"="value"[,...]} value

このエンドポイントは特定のメトリクスを探している場合に役立ちますが、通常はこれらのメトリクスを経時分析する必要があります。分析するには、Prometheus をクラスターにデプロイします。Prometheus は、公開されているエンドポイントを整理しデータを集計するモニタリングおよび時系列データベースであり、結果をフィルタリング、グラフ化、およびクエリできるようにします。

Deploying Prometheus

このトピックは、Helm V3 を使用して Prometheus をクラスターにデプロイする際に役立ちます。既に Helm がインストールされている場合は、helm version コマンドでバージョンを確認できます。Helm は Kubernetes クラスターのパッケージマネージャーです。Helm の詳細およびインストール方法については、「Using Helm with Amazon EKS」を参照してください。

Amazon EKS クラスター用に Helm を設定した後、以下の手順でそれを使用して Prometheus をデプロイできます。

Helm を使用して Prometheus をデプロイするには

  1. Prometheus 名前空間を作成します。

    kubectl create namespace prometheus

  2. Prometheus をデプロイします。

    helm install prometheus stable/prometheus \
    --namespace prometheus \
    --set alertmanager.persistentVolume.storageClass="gp2",server.persistentVolume.storageClass="gp2"

  3. prometheus 名前空間のすべてのポッドが READY 状態になっていることを確認します。 

    kubectl get pods -n prometheus

    Output

    NAME                                             READY   STATUS    RESTARTS   AGE
prometheus-alertmanager-59b4c8c744-r7bgp         1/2     Running   0          48s
prometheus-kube-state-metrics-7cfd87cf99-jkz2f   1/1     Running   0          48s
prometheus-node-exporter-jcjqz                   1/1     Running   0          48s
prometheus-node-exporter-jxv2h                   1/1     Running   0          48s
prometheus-node-exporter-vbdks                   1/1     Running   0          48s
prometheus-pushgateway-76c444b68c-82tnw          1/1     Running   0          48s
prometheus-server-775957f748-mmht9               1/2     Running   0          48s

  4. kubectl を使用して、Prometheus コンソールをローカルマシンにポート転送します。 

    kubectl --namespace=prometheus port-forward deploy/prometheus-server 9090

  5. ウェブブラウザで localhost:9090 にアクセスして、Prometheus コンソールを表示します。

  6. [- insert metric at cursor (カーソルの位置のメトリクスを挿入)] メニューからメトリクスを選択し、[実行] を選択します。[グラフ] タブを選択して、一定期間のメトリクスを表示します。次の図では、一定期間の container_memory_usage_bytes を示します。

    Prometheus メトリクス

  7. 上部のナビゲーションバーから、[ステータス]、[ターゲット] の順に選択します。

    Prometheus コンソール

    サービス検出を使用して Prometheus に接続されているすべての Kubernetes エンドポイントが表示されます。