インストール

プリコンパイル済みバイナリの使用

ほとんどの公式Prometheusコンポーネント向けにプリコンパイル済みバイナリを提供しています。利用可能なすべてのバージョンのリストについては、ダウンロードセクションをご覧ください。

ソースから

Prometheusコンポーネントをソースからビルドするには、それぞれのレポジトリのMakefileターゲットを参照してください。

Dockerの使用

すべてのPrometheusサービスは、Quay.ioまたはDocker HubでDockerイメージとして利用できます。

DockerでPrometheusを実行するには、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

より高度なオプションは、起動時にいくつかのツールを使用して設定を動的にレンダリングするか、デーモンに定期的に更新させることです。

構成管理システムの使用

構成管理システムの使用を希望する場合は、以下のサードパーティの貢献に興味があるかもしれません。

Ansible

Chef

Puppet

SaltStack

このドキュメントはオープンソースです。問題の報告やプルリクエストを送信して、改善にご協力ください。