はじめに

ノードのパフォーマンスをリアルタイムで監視することで、スムーズかつ効率的に実行されていることを確認できます。go-quaiクライアントは、ノードの健康状態とパフォーマンスを追跡できる監視ソリューションをバンドルしています。このガイドでは、GrafanaとPrometheusを使用してノードを監視するための設定方法を説明します。

前提条件

Quai Networkノード監視を有効にするQuai Networkノード。
Grafanaオープンソースの分析および監視ソリューション。
Prometheusオープンソースの監視およびアラートツールキット。

依存関係のインストール

外部ノードの監視を設定している場合は、PrometheusとGrafanaのポートをローカルマシンに転送する必要があります。 Grafanaはデフォルトでポート3000、Prometheusはポート9090で実行されます。

Prometheus

Prometheusのインストールは、お好みのパッケージマネージャーを使用してコマンドラインから行うことができます。Linuxマシンでは、次のコマンドを実行してPrometheusをインストールします:
sudo apt install prometheus -y
初回インストール時には、Prometheusサービスを起動時に開始するように有効にすると便利です。これにより、マシンを再起動するたびに手動でサービスを開始する必要がなくなります。Prometheusサービスを有効にするには、次のコマンドを実行します:
sudo systemctl enable prometheus

Grafana

公式Grafanaダウンロードページの手順に従ってGrafanaをインストールできます。 例えば、Ubuntuでは、次のコマンドを使用してGrafanaをインストールできます:
sudo apt-get install -y adduser libfontconfig1 musl
wget https://dl.grafana.com/oss/release/grafana_10.4.2_amd64.deb
sudo dpkg -i grafana_10.4.2_amd64.deb

設定

Prometheusは、ノードからメトリクスをスクレイプするための設定ファイルが必要です。go-quaiには、使用できる事前設定されたPrometheus設定ファイルがあります。この設定ファイルを使用するには、次のコマンドを実行します:
# go-quaiディレクトリに移動
cd go-quai

# 設定ファイルをコピー
sudo cp metrics_config/prometheus.yml /etc/prometheus/
設定ファイルのコピーは一度だけ行う必要があります。すでにファイルをコピーしている場合は、再度コマンドを実行する必要はありません。

ノード監視の初期化

ノードの監視を開始するには、PrometheusとGrafanaの両方が実行されていることを確認する必要があります。次のコマンドを使用して両方のサービスを開始できます:
sudo systemctl start prometheus
sudo systemctl start grafana-server.service
両方のサービスが実行されたら、--metrics.enabledフラグを使用してQuai Networkノードを開始する必要があります。これにより、Prometheusがノードからメトリクスをスクレイプできるようになります。--metrics.enabledフラグを使用してノードを開始するには、通常のノード起動コマンドにメトリクスフラグを追加して実行します:
# メトリクスフラグを追加してノードを開始
./build/bin/go-quai start <--startup-flags> --metrics.enabled
他のgo-quai起動フラグに慣れていない場合は、ノードの実行ガイドを参照してください。

Grafanaへのアクセス

Grafanaにアクセスするには、Webブラウザを開いてhttp://localhost:3000に移動します。ログインを求められます。デフォルトのユーザー名とパスワードは両方ともadminです。
ローカルマシンを監視している場合は、デフォルトのパスワードとユーザー名をそのまま使用するか、変更することができます。外部ノードを監視している場合、つまりポートを転送している場合は、デフォルトのパスワードとユーザー名を変更することを強く推奨します

GrafanaへのPrometheusの追加

Grafanaにログインしたら、Prometheusをデータソースとして追加する必要があります。これを行うには、次の手順に従います:
1

接続メニューを開く

左側のメニューでConnectionsをクリックします。
2

新しい接続を追加

接続メニューで、Add new connectionをクリックします。
3

Prometheusを選択

データソースのリストからPrometheusを選択します。検索する必要があるかもしれません。
4

新しいデータソースを追加

右上のAdd new data sourceをクリックします。これにより、Prometheusを設定できる設定タブに移動します。
5

PrometheusサーバーURLを設定

設定タブのConnectionセクションで、次のURLを入力します:
  • ローカルマシンを監視している場合はhttp://localhost:9090
  • 外部ノードを監視している場合はhttp://EXTERNALIPADDRESS:9090
Prometheusをデータソースとして追加した後、ノードを監視するためのダッシュボードを作成できます。これを行うには、次の手順に従います:
1

ダッシュボードを開く

左側のメニューでDashboardsをクリックします。
2

新しいダッシュボードを作成

Newボタンをクリックします。
3

設定をインポート

Importボタンをクリックします。
4

設定を貼り付け

metrics_config/grafana_metrics.jsonにある設定ファイルをテキストボックスに貼り付けます。設定ファイルはこちらで確認できます。

ノードの監視

データソースを設定して設定ファイルをインポートした後、ノードの健康状態とパフォーマンスを表示する下記のようなダッシュボードが表示されるはずです。ノードはリアルタイムで監視されるようになりました。