第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 でのメトリクスの取得
Vector および Grafana Web アプリケーションでは、ダッシュボードスタイルのビューを提供し、デフォルトのウィジェットにはメトリクスの値が表示されます。要件に合わせてメトリクスを追加および削除できます。
ウィジェットごとに表示期間を選択することもできます。アーカイブされたメトリクスからカスタムの時間範囲を選択できるのは、Grafana のみです。
Grafana の使用方法に関する詳細は、Grafana Labs Web サイトを参照してください。Vector の使用方法に関する詳細は、Vector Web サイトを参照してください。
手順
Performance Co-Pilot の Webアプリケーション UI でメトリクスを取得するには、次の手順を実行します。
- http://satellite.example.com:44323 の URL を開きます。
- PCP Web UI で、アクセスする Web アプリケーションのダッシュボードを選択します。
図5.1 Grafana ダッシュボードの例
図5.2 Vector ダッシュボードの例