Prometheus@監視ツール¶
はじめに¶
本サイトにつきまして、以下をご認識のほど宜しくお願いいたします。
01. Prometheusの仕組み¶
アーキテクチャ¶
Prometheus は、prometheus サーバー (Retrieval、ローカルのとき系列ストレージ、HTTP サーバー) から構成されている。
Kubernetes リソースに関するメトリクスの元になるデータポイントを収集し、分析する。
また設定された条件下でアラートを作成し、Alertmanager に送信する。

02. prometheusサーバー¶
prometheusサーバーとは¶
メトリクスの元になるデータポイントを収集し、管理する。
また PromQL に基づいて、データポイントからメトリクスを分析できるようにする。
9090 番ポートで、メトリクスの元になるデータポイントをプルし、加えて Grafana の PromQL によるアクセスを待ち受ける。
例えば、prometheus-operator を使用した場合は、各コンポーネントのデフォルト値は、/etc/prometheus/prometheus.yml ファイルで定義する。
02-02. Retrieval¶
Retrievalとは¶
監視対象からデータポイントを定期的に収集する。
設定ファイル¶
設定ファイルは yaml ファイルで定義する。セットアップ方法によって設定ファイルが配置されるディレクトリは異なる。
例えば、prometheus-operator を使用した場合は、prometheus コンテナの /etc/prometheus/rules ディレクトリ配下に配置される。
$ ls -1 /etc/prometheus
certs/
console_libraries/
consoles/
prometheus.yml # グローバルの設定ファイル
rules/ # ルールの設定ファイル
$ ls -1 /etc/prometheus/rules/prometheus-prometheus-kube-prometheus-prometheus-rulefiles-0
prometheus-eks-worker-rule.yaml
prometheus-prometheus-kube-prometheus-alertmanager.rules.yaml
prometheus-prometheus-kube-prometheus-general.rules.yaml
...
prometheus-prometheus-kube-prometheus-node.rules.yaml
prometheus-prometheus-kube-prometheus-prometheus-operator.yaml
prometheus-prometheus-kube-prometheus-prometheus.yaml
02-03. HTTP server¶
HTTP serverとは¶
データポイントを参照するためのエンドポイントを公開する。
PromQL リクエストを受信し、ローカルストレージからデータポイントをメトリクスとして返却する。
エンドポイント¶
▼ /metrics¶
Prometheus で使用できるメトリクスの一覧を取得できる。
$ curl http://localhost:3000/metrics
02-04. ローカルストレージ¶
ローカルストレージとは¶
Prometheus は、data ディレクトリ配下を TSDB として、収集したすべてのメトリクスを保管する。
data ディレクトリ¶
▼ data ディレクトリとは¶
Prometheus は、収集したデータポイントをデフォルトで 2 時間ごとにブロック化し、data ディレクトリ配下に配置する。
現在処理中のブロックをメモリ上に保持し、同時にストレージの /data/wal ディレクトリへバックアップとして保管する (補足:RDBMS では、これをジャーナルファイルという) 。
これにより、Prometheus で障害が発生し、メモリ上のブロックが削除されてしまっても、ストレージからブロックを復元できる。
data/
├── 01BKGV7JC0RY8A6MACW02A2PJD/ # ブロック
│ ├── chunks/
│ │ └── 000001
│ │
│ ├── tombstones
│ ├── index
│ └── meta.json
│
├── chunks_head/
│ └── 000001
│
└── wal # WALによるバックアップ
├── 000000002
└── checkpoint.00000001/
└── 00000000
Prometheus の稼働するコンテナや Node に接続すれば、data ディレクトリを確認できる。
$ kubectl exec -it prometheus -n prometheus -- sh
/data $ ls -la
drwxrwsr-x 3 1000 2000 4096 Jul 6 05:00 01BKGV7JC0RY8A6MACW02A2PJD # ブロック
drwxrwsr-x 3 1000 2000 4096 Jul 8 11:00 01BKTKF4VE33MYEEQF0M7YERFA
...
▼ 注意点¶
TSDB のディレクトリは Node にマウントされるため、Node のストレージサイズに注意する必要がある。
ストレージサイズが大きすぎると、Prometheus のコンテナは起動できなくなる場合がある。その場合は Node 側でメトリクスブロックを削除する。
対処方法として、データポイント数を減らし、データポイント全体のデータサイズを小さくするとよい。
独自TSDB¶
▼ 独自TSDBとは¶
Prometheus では、TSDB (data ディレクトリ配下) を採用している。
▼ データソース型モデル (仮定)¶
データソース型モデルとメトリクス型モデルがあり、Prometheus ではいずれを採用しているのかの記載が見つかっていない。
そのため、データソース型モデルと仮定してテーブル例を示す。
| timestamp | cluster | namespace | ... | cpu | memory |
|---|---|---|---|---|---|
2022-01-01 |
foo-cluster |
foo-namespace |
... | 10 |
10 |
2022-01-02 |
foo-cluster |
foo-namespace |
... | 20 |
30 |
02-05. リモートストレージ¶
リモートストレージとは¶
Prometheus は、ローカルストレージにメトリクスを保管する代わりに、TSDB として動作するリモートストレージ (AWS Timestream、Google Cloud Bigquery、VictoriaMetrics、...) に保管できる。
remote-write-receiver を有効化すると、リモートストレージの種類によらず、エンドポイントが『https://<IPアドレス>/api/v1/write』になる (ポート番号はリモートストレージごとに異なる) 。
Prometheus と外部の TSDB の両方を冗長化する場合、冗長化された Prometheus では、片方の DB のみに送信しないと、メトリクスが重複してしまう Grafana のようにリアルタイムにデータを取得し続けることはできない。
リモート読み出しを使用する場合、Prometheus のダッシュボード上で PromQL を使用することなく、Grafana のようにリアルタイムにデータを取得できるようになる。

ダイナミックキュー¶
▼ ダイナミックキューとは¶
リモートストレージにメトリクスを送信する場合、送信前にメトリクス (実体は WAL ファイル) をキューイングする。
ダイナミックキューは、メトリクスのスループットの高さに応じて、キューイングの実行単位であるシャードを増減させる。

▼ リモートストレージの障害時の書き込み待機¶
リモートストレージで障害が起こっている場合、キュー内のメトリクス (WAL ファイル) がいっぱいになったあと、キューイングを待機する。
2 時間は WAL ファイルのキューイングを待機し、リモートストレージの障害が回復次第、リモートストレージへの書き込みと WAL ファイルのキューイングを再開する。
タイムスタンプはそのままなので、リモートストレージ上ではメトリクスを欠損なく永続化できる。
2 時間が過ぎると、WAL ファイルは圧縮されて失われる。
性能設計¶
Prometheus は、現在処理中のブロックをメモリ上に保持し、同時にストレージの /data/wal ディレクトリにもバックアップとして保管する
そのため、十分量のメモリの割り当てが必要である。
レコーディングルール¶
事前に定義した PromQL の結果を TSDB に保管できる。
TSDB のデータサイズがむやみに増えないよう、最低限のレコーディングルールを定義する。
03. Alertmanager¶
Alertmanagerとは¶
Prometheus のアラートを受信し、特定の条件下で通知する。
受信したアラートは、Alertmanager の UI 上に表示される。

Storage¶
Alertmanager のデータを永続化する。
# Node内 (Amazon EKSのEC2ワーカーNodeの場合)
$ ls -la /var/lib/kubelet/plugins/kubernetes.io/aws-ebs/mounts/aws/ap-northeast-1a/vol-*****/alertmanager-db/
Silence¶
受信したアラートの通知を一時的に無効化する。
Silence されている期間、無効化されたアラートは Alertmanager の UI 上から削除され、通知されなくなる。
例えば、リモートストレージのアップグレード中にアラートが通知されないように、以下を matchers に設定したサイレンスを作成する。
alertname="PrometheusRemoteStorageFailures"
alertname="PrometheusRemoteWriteBehind"
alertname="PrometheusRemoteWriteDesiredShards"
04. PushGateway¶
PushGatewayとは¶
Prometheus がプッシュ型収集でメトリクスの元になるデータポイントを収集するためのエンドポイントとして動作する。
05. ServiceDiscovery¶
ServiceDiscoveryとは¶
プル型収集の宛先の IP アドレスが動的に変化する (例:スケーリングなど) 場合、宛先を動的に検出し、データポイントを収集し続けられるようにする。
06. マネージドPrometheus¶
Prometheus のコンポーネントを部分的にマネージドにしたサービス。
執筆時点 (2023/05/16 時点) では、リモートストレージ、Alertmanager をマネージドにしてくれる。