p4misc/p4prometheus repository overview

⁠p4prometheus調査用環境

本docker-compose.ymlを使用すると以下3つのコンテナが稼働します。

• helixcoreコンテナ(Dockerfileで構築)
  • Helix Core : 1666ポート
  • node_exporter : 9100ポート
  • p4prometheus
  • crond
• Prometheusコンテナ(公式のコンテナをそのまま使用)
  • Prometheus : 9090ポート
• Grafanaコンテナ(公式のコンテナをそのまま使用)
  • Grafana : 3000ポート

docker-compose.yml内でexternalネットワークを指定しています。 docker network create -d bridge helix-core-networkで事前にネットワークを作成しておく必要があります。

⁠Helix Coreのインストールと設定について

公式の手順に沿ってインストールしています。

1. Linuxパッケージベースのインストール⁠
2. インストール後の設定⁠

インストール時の設定とインストール後のディレクトリ構成は以下のとおりです。
ただし、メトリクスディレクトリはインストールによって作成されるものではなく、p4prometheus用に作成しています。

※ superユーザのパスワードは稼働後に変更をしてください

⁠node_exporterのインストールと設定について

インストールにあたって特別なことはしていません。 Dockerfile内の ## Install p4prometheus のブロックをご参照ください。

起動時のオプションで Helix Coreのメトリクスディレクトリ /opt/perforce/servers/master/metrics のデータを参照するように指示します。

⁠p4prometheusのインストールと設定について

公式の手順に沿ってインストールしています。

1. Install p4prometheus - details⁠

起動時のオプションで p4prometheus.yml を設定ファイルとして与えます。
この設定ファイルの中で以下の値を設定しています。

⁠使用方法

1. docker network create -d bridge helix-core-networkで、externalネットワークを作成します。
2. docker-compose buildで、イメージをビルドまたは取得します。
3. docker-compose up -dで、作成または取得したイメージを用いてコンテナを起動します。
4. Dockerホストマシン上で操作する場合は、http://localhost:3000でGrafanaにアクセスします。
5. usernameとpasswordの両方にadminと入力します。
   
6. パスワードを変更するよう促されるので、パスワードを入力します。
   
7. Add data sourceをクリックします。
   
8. Prometheusをクリックします。
   
9. URLにhttp://localhost:9090、AccessにBrowserを指定してSave & Testをクリックします。
   
10. +ボタンを押して、Importをクリックします。
    
11. Upload .json fileをクリックします。
    
12. 本リポジトリに登録されているp4_stats_dashboard.jsonを選択します。
    
13. Importをクリックします。
    
14. いくつか収集できていないデータがありますが、サンプルのダッシュボードが表示されます。

⁠備考

Helix Coreコンテナの状態を調査する場合は、docker exec -it helixcore /bin/bashを実行してコンテナにログインしてください。