インストール
事前コンパイル済みバイナリの使用
ほとんどの公式Prometheusコンポーネント用に、事前コンパイル済みバイナリを提供しています。利用可能なすべてのバージョンのリストについては、ダウンロードセクションをご覧ください。
ソースから
Prometheusコンポーネントをソースからビルドするには、各リポジトリのMakefile
ターゲットを参照してください。
Dockerの使用
すべてのPrometheusサービスは、Quay.ioまたはDocker HubでDockerイメージとして利用可能です。
PrometheusをDockerで実行するのは、docker run -p 9090:9090 prom/prometheus
と入力するだけで簡単です。これにより、Prometheusがサンプル設定で起動し、ポート9090で公開されます。
Prometheusイメージは、実際のメトリックを保存するためにボリュームを使用します。本番環境でのデプロイメントでは、Prometheusのアップグレード時のデータ管理を容易にするために、名前付きボリュームを使用することを強くお勧めします。
コマンドラインパラメータの設定
Dockerイメージはデフォルトのコマンドラインパラメータのセットで起動され、これはDockerfileに記載されています(使用するバージョンに合わせてリンクを調整してください)。
docker run
コマンドにコマンドラインパラメータを追加したい場合、それらは上書きされるため、自分で再度追加する必要があります。
ボリュームとバインドマウント
独自の構成を提供するには、いくつかのオプションがあります。ここに2つの例を示します。
ホストからprometheus.yml
をバインドマウントするには、次のコマンドを実行します。
docker run \
-p 9090:9090 \
-v /path/to/prometheus.yml:/etc/prometheus/prometheus.yml \
prom/prometheus
または、prometheus.yml
を含むディレクトリを/etc/prometheus
にバインドマウントするには、次のコマンドを実行します。
docker run \
-p 9090:9090 \
-v /path/to/config:/etc/prometheus \
prom/prometheus
Prometheusデータの保存
Prometheusのデータはコンテナ内の/prometheus
ディレクトリに保存されるため、コンテナが再起動されるたびにデータはクリアされます。データを保存するには、コンテナ用に永続ストレージ(またはバインドマウント)を設定する必要があります。
永続ストレージでPrometheusコンテナを実行
# Create persistent volume for your data
docker volume create prometheus-data
# Start Prometheus container
docker run \
-p 9090:9090 \
-v /path/to/prometheus.yml:/etc/prometheus/prometheus.yml \
-v prometheus-data:/prometheus \
prom/prometheus
カスタムイメージ
ホスト上のファイルを管理してバインドマウントするのを避けるために、設定をイメージに組み込むことができます。これは、設定自体がかなり静的で、すべての環境で同じ場合にうまく機能します。
これには、Prometheusの設定と次のようなDockerfile
を持つ新しいディレクトリを作成します。
FROM prom/prometheus
ADD prometheus.yml /etc/prometheus/
次に、ビルドして実行します。
docker build -t my-prometheus .
docker run -p 9090:9090 my-prometheus
より高度なオプションとしては、開始時に何らかのツールで動的に設定をレンダリングしたり、デーモンが定期的に更新するようにしたりすることも可能です。
構成管理システムの使用
構成管理システムを使用することを好む場合は、以下のサードパーティの貢献に関心があるかもしれません。