lparstat コマンド

目的

論理区画 (LPAR) の関連情報および統計情報をレポートします。

構文

lparstat {-i [ -W | -x | -s | -P ] | -W | -s | -P | -d | -m [ -e [ r | R ] [ -p[w] ] ] | [ -H | -h ] | [-X [-o filename ] ] [ -c ] | [-E [w ] ] = [ Interval [ Count ] ] 変更の始め [-L] 変更の終わり }

説明

lparstat コマンドは、LPAR の関連情報および使用率の統計情報のレポートを提供します。このコマンドは、現在の LPAR に関連するパラメーターおよびハイパーバイザー情報のほか、LPAR の使用率統計を表示します。インターバル・メカニズムによって、一定のインターバルで、レポートの数をリトリーブできます。

lparstat コマンドのさまざまなオプションは相互に排他的です。 lparstat コマンドをオプションを指定せずに実行すると、ブート時以降の、LPAR に関連した使用率統計情報が入った単一レポートが生成されます。-h オプションを指定すると、レポートには、ハイパーバイザーに関連した要約統計情報が組み込まれます。interval および count が指定された場合は、上記のレポートには、interval 秒ごと、および count 反復回数ごとの繰り返しが表示されます。interval および count は、-i オプションと一緒に使用できません。root ユーザーのみが、-h および -H フラグを実行できます。

interval パラメーターは、各レポートの間隔を秒で指定します。interval パラメーターを指定しない場合、lparstat コマンドはシステム起動時以降の統計を含む単一のレポートを生成して終了します。count パラメーターは、interval パラメーターと一緒に指定する必要があります。count パラメーターを指定すると、その値によって、生成されるレポートの数と間隔 (秒数) が決まります。count パラメーターなしで interval パラメーターを指定すると、レポートは連続して生成されます。count パラメーターに、ゼロの値を指定しないでください。

-i フラグを指定せずに lparstat コマンドが起動されると、2 行の統計情報が表示されます。最初の行にはシステム構成が表示されます。これは、コマンドが開始されたときに一度、さらに、システム構成が変更されるたびに表示されます。 2 番目の行には使用率統計情報が入っており、これは一定のインターバルで表示され、さらに、これらの統計値が前のインターバルからの差分を生じているときにいつでも表示されます。

-X オプションを指定する場合、lparstat コマンドは XML ファイルを作成します。

以下の情報が、システム構成の行に表示されます。

type: 区画タイプを示します。この値は、dedicated または shared のいずれかになります。
mode: 区画プロセッサー・キャパシティーに上限が定められているか、あるいは上限が定められておらず、共用プールからのアイドル・サイクルを消費できるかを示します。専用 LPAR では上限が定められているか、またはドネーションです。
smt: この区画で同時マルチスレッド化が使用可能になっているか使用不可になっているかを示します。 2 つの SMT スレッドがある場合、この行には「on」と表示されます。ただし、2 個を超える SMT スレッドがある場合は、SMT スレッドの数が表示されます。
lcpu: オンライン論理プロセッサーの数を示します。
mem: オンラインのメモリー・キャパシティーを示します。
注: Active Memory Expansion が使用可能である場合、mem はこの LPAR 用に構成された拡張メモリー・サイズを指定します。ただし、環境変数 AME_MEMVIEW が TRUE に設定される場合、mem 値は実メモリー・サイズを指定します。
psize: プール内のオンライン物理プロセッサーの数を示します。
ent: 処理装置内のライセンス済み処理キャパシティーを示します。この情報は、区画タイプが共用である場合にのみ表示されます。

-m フラグを指定すると、システム構成行に次の情報が表示されます。

lcpu: オンライン論理プロセッサーの数を示します。
ent: 処理装置内のライセンス済み処理キャパシティーを示します。
mem: オンラインのメモリー・キャパシティーを示します。
注: Active Memory Expansion が使用可能である場合、mem はこの LPAR 用に構成された拡張メモリー・サイズを指定します。ただし、環境変数 AME_MEMVIEW が TRUE に設定される場合、mem 値は実メモリー・サイズを指定します。
mpsz: 区画が属するプールのメモリー・プール・サイズを示します (GB)。
iome: 区画のライセンス済み入出力メモリー (MB) を示します。
iomp: LPAR 内のライセンス済みメモリー・プールの数を示します。

-c フラグを指定すると、システム構成行に次の追加情報が表示されます。

mmode

システムのメモリー・モードを示します。mmode の値は次のとおりです。

項目	説明
Ded	Active Memory Sharing も Active Memory Expansion も使用不可
Shar	Active Memory Sharing が使用可能
Ded-E	Active Memory Expansion が使用可能
Shar-E	Active Memory Sharing と Active Memory Expansion の両方が使用可能

mem

LPAR の拡張メモリー・サイズを示します。

tmem

LPAR の実メモリー・サイズを示します。

以下の情報は、使用率の行に表示されます。

%user

ユーザー・レベル (アプリケーション) での実行中に使用されるライセンス済み処理キャパシティーのパーセンテージを示します。

専用区画の場合、ライセンス済み処理キャパシティーは物理プロセッサーの数です。

ライセンス済みキャパシティーを超える現行の物理プロセッサー消費量を伴う上限なし区画の場合は、そのパーセンテージは、消費される物理プロセッサーの数 (physc) に関連するようになります。

%sys

システム・レベル (カーネル) での実行中に使用されるライセンス済み処理キャパシティーのパーセンテージを示します。

専用区画の場合、ライセンス済み処理キャパシティーは物理プロセッサーの数です。

%idle

区画がアイドルで、未解決のディスク入出力要求がなかったときに使用されなかった、ライセンス済み処理キャパシティーのパーセンテージを示します。

専用区画の場合、ライセンス済み処理キャパシティーは物理プロセッサーの数です。

%wait

区画がアイドルで、未解決のディスク入出力要求があったときに使用されなかった、ライセンス済み処理キャパシティーのパーセンテージを示します。

専用区画の場合、ライセンス済み処理キャパシティーは物理プロセッサーの数です。

以下の統計情報は、区画タイプが共用または専用のドネーションである場合に表示されます。

physc: 消費された物理プロセッサーの数を示します。
vcsw: 仮想プロセッサー・ハードウェア優先使用である仮想コンテキスト・スイッチの数を示します。

以下の統計情報は、区画タイプが共用である場合にのみ表示されます。

%entc: 消費されたライセンス済みキャパシティーのパーセンテージを示します。このデータを計算する基になる時間基準が変動する場合があるため、ライセンス済みキャパシティーのパーセンテージが 100% を超えることがあります。この超過はサンプリング間隔が短い場合にのみ目立ちます。
lbusy: ユーザーおよびシステム・レベルで実行中に生じた論理プロセッサーの使用率のパーセンテージを示します。
app: 共用プール内の使用可能な物理プロセッサーを示します。
phint: 受信したファントム (このプール内の別の共用区画が宛先の) 割り込みの数を示します。

以下の統計情報は、-h フラグが指定された場合にのみ表示されます。

%hypv: ハイパーバイザーの呼び出しに費やされた物理プロセッサー消費量のパーセンテージを示します。
hcalls: 開始されたハイパーバイザー呼び出しの平均数を示します。

以下の統計情報は、ハードウェアが SPURR を使用でき、プロセッサーが公称速度で稼働していない場合にのみ表示されます。

%nsp: 現行の平均プロセッサー速度を、公称速度のパーセンテージで示します。

次の統計情報は、ターボ・モード・アカウンティングが使用不可の場合にのみ表示されます。

%utcyc: 不明のターボ・サイクルの合計パーセンテージを示します。

以下の統計情報は、-d フラグが指定された場合にのみ表示されます。

%utuser: ユーザー・モード実行 (アプリケーション) での不明ターボ・サイクルのパーセンテージを示します。
%utsys: カーネル・モード実行 (カーネル) での不明ターボ・サイクルのパーセンテージを示します。
%utidle: 区画がアイドルで、未解決のディスク入出力要求がない場合の、不明ターボ・サイクルのパーセンテージを示します。
%utwait: 区画がアイドルで、未解決のディスク入出力要求がある場合の、不明ターボ・サイクルのパーセンテージを示します。

-m フラグを指定すると、次のメトリックが表示されます。

physb: 物理プロセッサーがビジーであることを示します。
%entc: 消費されたライセンス済みキャパシティーのパーセンテージを示します。このデータを計算する基になる時間基準が変動する可能性があるため、ライセンス済みキャパシティーのパーセンテージが 100% を超えることがあります。この超過はサンプリング間隔が短い場合にのみ目立ちます。
vcsw: 仮想プロセッサー・ハードウェア優先使用である仮想コンテキスト・スイッチの数を示します。
hpi: 発生したハイパーバイザー・ページインの数を示します。
hpit: ハイパーバイザー・ページインの待機に費やされた時間をミリ秒で示します。
pmem: ハイパーバイザーによって LPAR に割り当てられる物理メモリーを GB で示します。
iomin: 入出力メモリー・プールのうち最小のライセンス済み入出力メモリーを MB で示します。
iomu: 使用されている LPAR のうちライセンス済み入出力メモリーを MB で示します。
iomf: 空きライセンス済み入出力メモリーを MB で示します。
iohwm: ライセンス済み入出力メモリー使用率の上限基準点を GB で示します。
iomaf: システム始動以降、ライセンス済み入出力メモリー・プールへの割り当て要求が失敗した合計回数を示します。

-e フラグを -m フラグと一緒に指定すると、ライセンス済み入出力メモリー・プール情報に関する次の情報が表示されます。

iompn: ライセンス済み入出力メモリー・プールの名前を示します。
iomin: 入出力メモリー・プールのうち最小のライセンス済み入出力メモリーを MB で示します。
iodes: 入出力メモリー・プールのうち希望するライセンス済み入出力メモリーを MB で示します。
ioinu: 使用中のライセンス済み入出力メモリー・プールを示します (MB)。
iores: 予約されている、ライセンス済み入出力メモリー・プールを示します (MB)。
iohwm: 入出力メモリー・プールのライセンス済み使用量の上限基準点を示します (MB)。
ioafl: システム始動以降、このライセンス済みの入出力メモリー・プールへの割り当て要求が失敗した合計回数を示します。

以下の統計情報は、-c フラグが指定された場合にのみ表示されます。

%xcpu: Active Memory Expansion (AME) アクティビティーでの使用率を示すパーセンテージ (論理区画による CPU 使用量全体に相対する率) を示します。
xphysc: Active Memory Expansion アクティビティーに使用される物理プロセッサーの数を示します。
dxm: LPAR の拡張メモリーの不足サイズを MB 単位で示します。
pgcol: Active Memory 共用アクティビティーの実行中に合体された、呼び出し側区画の論理実メモリー・ページをメガバイト単位で示します。
mpgcol: Active Memory 共用アクティビティーの実行中に、合体された区画のメモリー・プールによって呼び出されたメモリー・ページのメガバイト数を示します。その区画にプール全体の統計にアクセスする権限がない場合、メトリックにはゼロが表示されます。
ccol: Active Memory 共用アクティビティーの実行中にページの合体で使用された CPU の部分を示します。その区画にプール全体の統計にアクセスする権限がない場合、メトリックにはゼロが表示されます。

注: メモリー・ページの合体はユーザーが意識することなく行われる操作であり、この操作中に、ハイパーバイザーは重複ページを検出し、ユーザー読み取りページをすべて単一のコピーに送信し、その他の重複した物理メモリー・ページを再利用します。

フラグ

項目	説明
-c	デフォルトの lparstat 出力に LPAR のメモリー圧縮の統計を追加します。注: このオプションは、Active Memory Expansion が使用可能である場合のみ有効です。
-d	CPU 使用率詳細統計情報を表示します。ターボ・モード・アカウンティングが使用不可の場合は、lparstat コマンドは、専用、ドネーション、または共用の使用状況列 (%user、%sys、%idle、%wait、%entc、%idon、%bdon、%istol、および %bstol) と一緒に不明ターボ・サイクルのカテゴリー別に明細を表示します。
-e	LPAR のライセンス済み入出力メモリー・プールに関する情報を表示します。-e フラグは、–m フラグと一緒にのみ指定できます。 -m フラグを指定するときに表示されるメトリックを参照してください。
-E	Scaled Processor Utilization Resource Register (SPURR) に基づく使用率メトリックを報告します (SPURR 対応のプロセッサーで実行された場合)。
-h	デフォルトの lparstat 出力に、ハイパーバイザー統計情報の要約を追加します。
-H	詳細なハイパーバイザー情報を提供します。このオプションは基本的に箇々のハイパーバイザー呼び出しの統計を表示します。各ハイパーバイザー呼び出しの、このオプションによって表示されるさまざまなハイパーバイザー統計情報を以下に示します。統計情報説明呼び出し回数実行されたハイパーバイザー呼び出し。消費された合計時間このタイプの呼び出しで使われた合計時間のパーセンテージ。消費されたハイパーバイザー時間このタイプの呼び出しで使われたハイパーバイザー時間のパーセンテージ。平均呼び出し時間このタイプの呼び出しの平均呼び出し時間 (ナノ秒)。最大呼び出し時間このタイプの呼び出しの最大呼び出し時間 (ナノ秒)。
-i	LPAR 構成の詳細をリストします。-i オプションによって表示されるさまざまな詳細を以下にリストします。名前説明区画名 HMC で割り当てられた論理区画名。区画番号この論理区画の番号。省電力モードこの論理区画の省電力モード。オンライン仮想 CPU 現在オンラインになっている CPU (仮想エンジン) の数。最大仮想 CPU CPU (仮想エンジン) の最大可能数。オンライン・メモリー現在オンラインになっているメモリーの量。最大メモリーメモリーの最大可能量。タイプ LPAR が専用 CPU リソースを使用しているか共用 CPU リソースを使用しているか、および SMT がオンになっているかどうかを示します。タイプは、[Shared \| Dedicated] [ -SMT ] [ -# ] のフォーマットで表示されます。次のリストは、さまざまなタイプのフォーマットを説明したものです。 Shared - LPAR が共有プロセッサー・モードで実行されていることを示します。 Dedicated - LPAR が専用プロセッサー・モードで実行されていることを示します。 SMT[-#] - LPAR で SMT モードがオンになっており、SMT スレッドの数が 2 であることを示します。スレッドの数が 2 を超えている場合は、スレッドの数も表示されます。モード LPAR プロセッサー・キャパシティーに上限が定められているか、あるいは上限が定められておらず、共用プールのアイドル・サイクルを消費できるかを示します。専用 LPAR では上限が定められているか、またはドネーションです。ライセンス済みキャパシティーこの LPAR が受け取る資格のある処理装置の数。可変キャパシティーの重みこの LPAR に割り当てられた優先順位の重みで、エクストラ (アイドル) キャパシティーをこの LPAR にどのように割り当てるかを制御します。重み `-1` は、ソフト・キャップがあることを示します。最小キャパシティーこの LPAR が使用できると定義されている処理装置の最小数。ライセンス済みキャパシティーは、この値まで削減できます。最大キャパシティーこの LPAR が使用できると定義されている処理装置の最大数。ライセンス済みキャパシティーは、この値まで増加できます。キャパシティー増分ライセンス済みキャパシティーを変更するときに使用される細分度。整数の倍数の値は、専用 LPAR を示します。システム内の最大物理 CPU この LPAR を含むシステム内で可能な物理 CPU の数の最大数。
	(-i フラグによって表示される詳細は以下のとおりです。) システム内のアクティブ物理 CPU この LPAR を含むシステム内のアクティブ物理 CPU の現在の数。プール内のアクティブ CPU この LPAR の共用プロセッサー・プールに使用可能な CPU の最大数。システム内の共用物理 CPU 共用プロセッサーの LPAR で使用できる物理 CPU の数。プールの最大キャパシティーこの LPAR の共用プロセッサー・プールが使用できる処理装置の最大数。プールのライセンス済みキャパシティーこの LPAR の共用プロセッサー・プールが受け取る資格を持っている処理装置の数。未割り当てのキャパシティー LPAR グループ内の共用 LPAR から未割り当ての処理装置の合計数。この合計には、専用の LPAR からの未割り当ての処理装置は含まれません。これもこのグループに属している可能性があります。未割り当ての処理装置は、グループの任意の専用 LPAR (1.0 以上の場合) または共用 LPAR に割り振ることができます。物理 CPU パーセンテージこれらの LPAR の仮想 CPU と等価となる、全物理 CPU に相対の分数表記。これはライセンス済みキャパシティー / オンライン CPU の関数です。専用 LPAR は、100% の物理 CPU パーセンテージになります。2 台の処理装置のライセンス済みキャパシティーの 4Way 仮想では、50% の物理 CPU パーセンテージになります。最小メモリーこの LPAR が使用できると定義された最小メモリー。最小仮想 CPU この LPAR が使用できると定義された仮想 CPU の最小数。未割り当ての重み LPAR グループ内で現在未割り当ての可変プロセッサー・キャパシティーの重みの装置の数。区画グループ ID この LPAR がメンバーとして所属している LPAR グループ。共用プール ID この LPAR がメンバーとして所属している物理プロセッサーの共用プールの ID。
	(-i フラグによって表示される詳細は以下のとおりです。) メモリー・モードメモリー・モードが共用か専用かを示します。Active Memory Expansion が使用可能である場合、メモリー・モードにも Expanded と呼ばれる新規モードが含まれます。ライセンス済み入出力メモリーの合計 LPAR のライセンス済み入出力メモリー。可変メモリー・キャパシティーの重み LPAR の可変メモリー・キャパシティーの重み。メモリー・プール ID LPAR が属するプールのメモリー・プール ID。プール内の物理メモリー LPAR が属するプール内にある物理メモリー。ハイパーバイザー・ページ・サイズ LPAR 論理メモリー・ページのページインおよびページアウトにハイパーバイザーが使用するページ・サイズ。未割り当て可変メモリー・キャパシティーの重み LPAR の、未割り当ての可変メモリー・キャパシティーの重み。未割り当てライセンス済み入出力メモリー LPAR の、未割り当てのライセンス済み入出力メモリー。 LPAR のメモリー・グループ ID LPAR か属するワークロード・マネージャーグループのメモリー・グループ ID。ターゲット・メモリー拡張係数 LPAR 用に構成されたターゲット・メモリー拡張係数。注: ターゲット・メモリー拡張係数が表示されるのは、Active Memory Expansion が使用可能な場合です。ターゲット・メモリー拡張サイズ LPAR のターゲット拡張メモリー・サイズ。ターゲット拡張メモリー・サイズは、実メモリー・サイズにターゲット・メモリー拡張係数を掛けたものです。注: ターゲット・メモリー拡張サイズが表示されるのは、Active Memory Expansion が使用可能な場合です。省電力モード LPAR の省電力モード。サブプロセッサー・モード LPAR のサブプロセッサー・モード。 -i フラグは、単独で指定することも、-P、-W、および -s の各フラグと一緒に指定することもできます。
-L	Live Partition Mobility (LPM) 操作を LPAR に対して実行できるかどうかを表示します。
-m	以下の側面に関連する統計を表示します。論理メモリー LPAR の論理メモリーをバックアップする物理メモリー LPAR のライセンス済み入出力メモリー LPAR が属するプールに関するメモリー・プール情報 -m フラグを指定するときに表示されるメトリックについて詳しくは、『メトリック』のセクションを参照してください。
-o	XML 出力のファイル名を指定します。
-p	LPAR のページ合体統計に関する情報を表示します。 -p フラグは、-m フラグと一緒にのみ指定できます。-w および -p フラグを指定して lparstat コマンドを実行すると、その結果として、-e フラグによって表示されるすべてのメトリックが単一行に表示されます。
-P	エネルギー管理チューニング・パラメーターに関する情報を表示します。 -P フラグは、単独で指定することも、-i、-W、および -s の各フラグと一緒に指定することもできます。
-r	コマンドの最初に、ライセンス済み入出力メモリーの上限基準点をリセットします。このフラグは、-m フラグおよび -e フラグと一緒にのみ使用できます。
-R	それぞれのモニター間隔の最初に、上限基準点をリセットします。-r と -R フラグの両方を指定した場合は、-R フラグが有効になります。
-s	LPAR 情報を表示します。-s フラグは、以下の詳細を表示します。サービス区画 ID ハードウェア管理コンソール (HMC) によって割り当てられたサービス区画 ID。構成済み LPAR 数 HMC 上に構成されている LPAR の数。 -s フラグは、単独で指定することも、-P、-i、および -W の各フラグと一緒に指定することもできます。
-t	間隔をおいてコマンドが実行される時刻を HH:MM:SS 形式で表示します。
-W	workload partition (WPAR) 構成に関する詳細をリストします。コマンドがグローバル環境から実行される場合は、WPAR キーの値は 0 です。-W フラグにより、以下の詳細が表示されます。 WPAR キー WPAR 静的 ID。 WPAR 構成済み ID WPAR 動的 ID。 WPAR 最大 CPU リソース・セット内のプロセッサーの数。数が制限されていない場合は、値 0 が表示されます。 WPAR 有効 CPU 有効リソース・セット内のプロセッサーの数。数が制限されていない場合は、値 0 が表示されます。 WPAR CPU パーセンテージ WPAR プロセッサー制限パーセンテージ。 -W フラグは、単独で指定することも、-P、-i、および -s の各フラグと一緒に指定することもできます。
-x	LPAR のセキュリティー・モード設定をリストします。
-X	XML 出力を生成します。デフォルトのファイル名は lparstat_DDMMYYHHMM.xml です。ただし、ユーザーが –o オプションを使用して別のファイル名を指定する場合を除きます。

注: プール使用効率権限 (PUA) が使用可能でない場合には、app 列は表示されません。

例

デフォルトの LPAR 統計を取得するには、次のコマンドを入力します。
```
lparstat 1 1 
```
デフォルトの LPAR 統計をハイパーバイザーの要約統計とともに取得するには、次のコマンドを入力します。
```
lparstat -h 1 1
```
区画に関する情報を取得するには、次のコマンドを入力します。
```
lparstat -i
```
詳細なハイパーバイザー統計を取得するには、次のコマンドを入力します。
```
lparstat -H 1 1
```
共用メモリー・プールおよび区画のライセンス済み入出力メモリーに関する統計を取得するには、次のコマンドを入力します。
```
lparstat -m
```
LPAR 内の入出力メモリー・プール数に関する統計を取得するには、次のコマンドを入力します。
```
lparstat -me
```
LPAR が共用モードで、4 SMT スレッドで実行されている場合、タイプは次のフォーマットになります。
```
Type - Shared-SMT-4
```
LPAR が専用モードで、2 SMT スレッドで実行されている場合、タイプは次のフォーマットになります。
```
Type - Dedicated-SMT
```
Active Memory Expansion が使用可能な場合に LPAR でのメモリー圧縮の統計を計算するには、次のコマンドを入力してください。
```
lparstat -c 1 1
```
LPAR 内のページ合体に関する統計を取得するには、次のコマンドを入力します。
```
lparstat -mp
```

ファイル

項目	説明
/usr/bin/lparstat	lparstat コマンドが入っています。