第5章 メトリクスの取得

PCP からは CLI または web UI インターフェイスを使ってメトリクスを取得できます。PCP には多くの CLI ツールが用意されており、ライブデータまたはアーカイブ化されたソースからのデータを出力できます。web UI インターフェイスは、Grafana および Vector web アプリケーションが提供します。Vector は PCP デーモンに直接接続し、ライブデータのみを表示できます。Grafana は PCP アーカイブファイルからデータを読み取り、最大 1 年前までのものを表示することができます。

5.1. CLI によるメトリクスの取得

PCP の CLI ツールを使用すると、ライブまたはアーカイブファイルからメトリクスを取得できます。

5.1.1. CLI によるライブメトリクスの取得

ディスクパーティションの書き込みインスタンスに関するメトリクスを出力するには、以下のコマンドを実行します。 

# pmval -f 1 disk.partitions.write

この例では、PCP はディスクパーティションへの書き込み数のカウンター値をレート値に変換します。-f 1 は、値を小数第 2 位で四捨五入するように指定します。

出力例

metric:    disk.partitions.write
host:      satellite.example.com
semantics: cumulative counter (converting to rate)
units:     count (converting to count / sec)
samples:   all

                 vda1                  vda2                   sr0
                  0.0                  12.0                   0.0
                  0.0                   1.0                   0.0
                  0.0                   1.0                   0.0
                  0.0                   2.0                   0.0

システムメトリクスを 2 秒間隔でモニターするには、以下のコマンドを実行します。 

# pmstat -t 2sec

5.1.2. CLI によるアーカイブ化されたメトリクスの取得

PCP CLI ツールを使ってアーカイブファイルからメトリクスを取得できます。これを実行するには、--archive パラメーターを追加してアーカイブファイルを指定します。

  • アーカイブファイル作成時に有効になっていた全メトリクスを一覧表示するには、以下のコマンドを実行します。 

    pminfo --archive archive_file

  • アーカイブファイルでカバーされているホストと時間を確認するには、以下のコマンドを実行します。 

    # pmdumplog -l archive_file

例

  • アーカイブファイルがカバーしている期間の各パーティションのディスク書き込みを一覧表示するには、以下のコマンドを実行します。 

    # pmval --archive /var/log/pcp/pmlogger/satellite.example.com/20180816.00.10 \
  -f 1 disk.partitions.write

  • 14:00 から 14:15 までの時間で 2 秒間隔でのパーティション毎のディスク書き込み操作を一覧表示するには、以下のコマンドを実行します。 

    # pmval --archive /var/log/pcp/pmlogger/satellite.example.com/20180816.00.10 \
  -d -t 2sec \
  -f 3 disk.partitions.write \
  -S @14:00 -T @14:15

  • 14:00 から 14:30 までの時間で、最小値/最大値および実際の最小値/最大値を含むすべてのパフォーマンスメトリクスの平均値を一覧表示するには、以下のコマンドを実行します。出力は表形式になります。 

    # pmlogsummary /var/log/pcp/pmlogger/satellite.example.com/20180816.00.10 \
  -HlfiImM \
  -S @14:00 \
  -T @14:30 \
  disk.partitions.write \
  mem.freemem

  • 14:00 時以降にアーカイブに保存されたシステムメトリクスを一覧表示するには、以下のコマンドを実行します。メトリクスは top ツールと同様のフォーマットで表示されます。 

    # pcp --archive /var/log/pcp/pmlogger/satellite.example.com/20180816.00.10 \
  -S @14:00 \
  atop

5.2. Web UI によるメトリクスの取得

PCP メトリクスへの web UI インターフェイスにアクセスするには、以下のいずれかの URL で web アプリケーションを開きます。

Vector
http://satellite.example.com:44323/vector
Grafana
http://satellite.example.com:44323/grafana

これらのアプリケーションでは両方ともダッシュボード形式のビューが提供され、デフォルトのウィジェットがメトリクス値を表示します。メトリクスは要件に応じて追加したり、削除したりすることができます。また、各ウィジェットで表示する期間を選択できます。アーカイブ化されたメトリクスからカスタムの時間枠を選択できるのは、Grafana のみになります。

Grafana の使用方法に関する詳細は、Grafana Labs web サイトを参照してください。Vector の使用方法に関する詳細は、Vector web サイトを参照してください。

図5.1 Grafana ダッシュボードの例

grafana screenshot

図5.2 Vector ダッシュボードの例

vector screenshot