zonestat - アクティブなゾーン統計の報告
zonestat [-z zonelist ] [-r reslist] [ -n namelist] [-T u | d | i] [-R reports] [-q] [ -x] [-b brandlist] [-p [-P lines]] [-S cols] interval [ duration [report]]
zonestat ユーティリティーは、現在実行中のゾーンの cpu、メモリー、ネットワーク、およびリソース制御使用率について報告します。各ゾーンの使用率は、システムのリソースとゾーンの構成済み制限の両方の割合 (パーセント) として報告されます。
zonestat ユーティリティーは、指定された間隔で一連の間隔レポートを出力します。また、指定された間隔で 1 つ以上のサマリーレポートも任意で出力します。
デフォルトの出力は、cpu、物理メモリー、仮想メモリー、ネットワークの使用率のサマリーです。–r オプションを使用すると、特定のリソースに関する詳細な出力を選択できます。
非大域ゾーン (NGZ) から実行すると、NGZ から参照可能な pset のみが報告されます。NGZ の出力には、メモリーや制限などのその他のすべてのシステムリソースが含まれます。
報告されるすべてのリソースについて、NGZ の使用量が出力されます。システム、大域ゾーン、およびその他のすべてのゾーンによる各リソースの使用量は、[system] で使用されたものとして報告されます。
solaris-kz ブランドゾーン内では、そのゾーンの使用状況のみ表示できます。
ネットワークリソースでは、NGZ の使用量のみが出力されます。NGZ は、ほかのゾーンのネットワークリソースと統計からは見えません。
zonestat ユーティリティーを使用するには、proc_info 特権が必要です。この特権は、基本特権セットのメンバーです。
サポートしているオプションは、次のとおりです。
報告するリストリソース名を指定します。pset リソースでは、これは pset の名前です。physical-memory 、locked-memory、および virtual-memory リソースでは、名前は mem_default および vm_default のみです。ネットワークリソースでは、これはデータリンクの名前です。
dedicated-cpu pset は、その dedicated-cpu pool pset 名 (SYSzone_<zonename>) または単にその zonename で指定できます。
psrset で作成された pset は、その psrset プール pset 名 (SYSpsrset_<id>) または単にその pset id で指定できます。
sysstats および fsstats の場合、それらに属するすべてのリソース名を名前に使用できます。この場合、名前で指定した列だけが出力されます。例 7 を参照してください。
リソースセットについて報告するときは、コンマ区切りリストに加えて複数の –n オプションを指定できます。
解析可能な出力。
安定した機械解析可能な形式を使用して出力します。各フィールドはコロン (:) で区切ります。行形式は次のとおりです。
report type:resource:field[:field]*
-T が指定されている場合は、各行に接頭辞としてタイムスタンプが付きます。
報告タイプは、report-total、report-average 、report-high、および interval です。
リソースタイプは、header、summary、physical-memory、virtual-memory、locked-memory、processor-set、processes、lwps、sysv-shared-memory、sysv-shmids、sysv-semids、sysv-msgids、lofi、network、sysstats、fsstats です。
header リソースは、間隔またはサマリーレポートの開始を示すために使用される特別なリソースです。header リソース間のすべての出力行は、同じ報告に属します。
残りのフィールドはリソースタイプに固有のものです。詳細は、zonestat ユーティリティーの出力を参照してください。
既存のすべての出力フィールドは安定しています。将来のバージョンでは、新しい報告タイプおよびリソースタイプが導入される可能性があります。さらに、将来のバージョンでは、既存の出力 n 行の末尾に新しいフィールドが追加される可能性もあります。
大域ゾーンで実行すると、solaris-kz ブランドゾーンに対して提供される統計情報は、ホストの観点からになるため、ゾーン内と異なることがあります。solaris-kz(7) を参照してください。
解析可能な出力について、解析可能な出力内の出力する行を指定します。次の行のタイプから 1 つ以上を選択できます。
各間隔で、サマリーレポートに間隔情報やカウント情報などの詳細を出力する「header (ヘッダー)」が含まれます。
各リソースを記述する行。
システムによる各リソースの使用率。これには、カーネル、および特定のゾーンに関与することのない、すべてのリソース消費が含まれます。zonestat が非大域ゾーン内から実行される場合、この値はシステムおよびその他のすべてのゾーンで消費される総リソースとなります。ネットワークリソースタイプの system 使用率はサポートされていません。
各リソースの合計使用率。
各リソースのゾーンごとの使用率を詳細に示す行。
静寂モード。サマリーレポートのみを出力します (–R オプションが必要)。すべての間隔レポートは省略されます。
報告するリソースタイプを指定します。設定可能なリソースは、physical-memory、virtual-memory、locked-memory、processor-set、processes、lwps、shm-memory、shm-ids、sem-ids、msg-ids、lofi、network、sysstats、fsstats です。
特に、sysstats は、syscall、fork、vfork、fork-fail、exec、semop の合計数を示しますが、fsstats は、読み取り呼び出し数、書き込み呼び出し数、rdwr() で読み込まれたバイト数、rdwr() で書き込まれたバイト数、およびパス名検索回数を示します。
cpu、physical-memory、 virtual memory、network 使用率のサマリー。
physical-memory、virtual-memory、および locked-memory。
processor-set
デフォルトの pset のみ。
processes、lwps、lofi。
ネットワークのデータリンク。
shm-memory、shm-ids、 sem-ids、msg-ids。
すべてのリソースタイプ
デフォルトでは、summary リソースが出力されます。
リソースタイプセットについて指定するときは、コンマ区切りリストに加えて複数の -r オプションを指定できます。
システムの cpu は pset にパーティション化できます。デフォルトでは、すべての cpu が pset_default という名前の単一の pset にあります。
メモリーはセットへのパーティション化には対応していません。これらのリソースに対する zonestat ユーティリティーの出力では、mem_default および vm_default という名前で表示されます。
all リソースは、すべてのリソースタイプが報告されるように指定します。
このオプションで指定されたブランドのみを表示します。
サマリーレポートを出力します。サポートされる報告タイプについては、下記を参照してください。サマリーレポートセットには、コンマ区切りリストに加えて複数の -R オプションを指定できます。
リソースごとに、次の詳細を示すサマリーレポートを出力します。
コマンド呼び出しの開始以降に使用された合計 cpu。各ゾーンで使用される割合には、ゾーンが実行されていなかった時間も含まれます。たとえば、ゾーンが実行中に 100% のcpu を使用しても、間隔の半分は停止していた場合、サマリーレポートにはゾーンが 50% の cpu 時間を使用したことが示されます。
コマンド呼び出し以降に報告されたすべての間隔で使用された平均リソース。この平均の計算には、ゾーンが実行されなかった間隔も含まれます。たとえば、ゾーンが実行中に平均で 100M の物理メモリーを使用しても、間隔の半分でしか実行していなかった場合、サマリーレポートにはゾーンが平均で 50M の物理メモリーを使用したことが示されます。
物理帯域幅を使用しているすべてのデータリンクによって送受信された全バイト数の合計合計はコマンドの呼び出しが開始されてから計算され、秒あたりのバイト数に標準化されます。使用された割合は、使用可能な合計帯域幅に基づいて計算されます。
ゾーンに表示されるすべての CPU で使用されるリソースの合計。
total と同様ですが、ゾーンが実行されている間隔のみが計算に含まれます。たとえば、ゾーンが単一の間隔のみで実行されていて、その間隔中にゾーンが 200M の仮想メモリーを使用した場合、サマリーレポート前に報告された間隔の数に関係なく平均仮想メモリーは 200M になります。
zonestat ユーティリティー呼び出しの間隔中に、各リソースおよびゾーンの最大使用量を詳細に示すサマリーレポートを出力します。
各リソースを利用するゾーンをソートします。
次のソート列を指定できます。
ゾーン名で英数字順にソートします。
使用されるリソースの数量でソートします。ネットワークリソースでは、これはバイトでソートした場合と同じです。
これはデフォルトです。
構成されている上限でソートします。
使用されている上限の割合 (パーセント) でソートします。
割り当てられている共有でソートします。
使用されている共有の割合 (パーセント) でソートします。
送受信された合計バイト数でネットワークをソートします。
有線で受信されたバイト数の割合でネットワークをソートします。
有線で送信されたバイト数の割合でネットワークをソートします。
使用された帯域幅の割合でネットワークをソートします。
サマリーの CPU 使用量でソートします。これはデフォルトです。
サマリーの物理メモリー使用量でソートします。
サマリーの仮想メモリー使用量でソートします。
サマリーのネットワーク使用量でソートします。
使用される対応したリソースの数量でソートします。
サマリーのネットワーク使用量でソートします。
各レポートのタイムスタンプを含みます。次の形式がサポートされています。
拡張表示で詳細情報を表示します。たとえば、ネットワークリソースで使用した場合、拡張表示には各仮想データリンクの詳細が一覧表示されます。
報告するゾーンの一覧を指定します。デフォルトでは、すべてのゾーンが報告されます。
ゾーンセットについて報告するときは、コンマ区切りリストに加えて複数の –z オプションを指定できます。出力には、指定されたゾーンで使用されたリソースが含まれます。
次のオペランドがサポートされています。
各間隔レポート間で一時停止する長さを秒数で指定します。「デフォルト」の間隔では、ゾーン監視サービスの構成済み間隔が使用されます。zonestatd(8) を参照してください。
interval は必須です。ゼロの間隔は許可されていません。間隔は、10s や 1m のように、[nh][nm][ns] の形式で指定できます。
報告する間隔の数を指定します。指定しない場合、デフォルトでは infinity に設定されます。コマンド期間は (interval * duration) です。ゼロの期間は無効です。値 inf を指定して、明示的に infinity を選択することもできます。
期間は、[nh][ nm][ns] の形式でも指定できます。この場合、期間は実行時間の期間であると解釈されます。実際の期間は、間隔のもっとも近い倍数に切り上げられます。
サマリーレポート期間を指定します。たとえば、4 のレポートでは 4 間隔ごとに報告が生成されます。コマンド期間が報告の倍数ではない場合、最後の報告は残りの間隔に属します。
報告は、[n h][nm][ns] の形式でも指定できます。この場合、レポートは指定された期間に、もっとも近い間隔に切り上げられて出力されます。コマンド期間が報告の倍数ではない場合、最後の報告は残りの間隔に属します。
–R が必要です。–R が指定されていても、報告は指定されていない場合、報告期間はコマンド期間全体となり、指定された報告が実行の最後に生成されます。
次の一覧には、コマンド出力の列ヘッダーが定義されています。
物理ホストで使用可能なメモリーの合計量。
物理ホストで使用可能なリソースの最大量。
pset に割り当てられた cpu の数
pset に割り当てられた cpu のうち、プロセスを実行できる cpu の数。
システムが pset に割り当てられる cpu の最大数および最小数。
リソースを使用しているゾーン。この列には、ゾーン名に加えて次のものを含めることができます。
システム全体で使用されるリソースの合計数量。
カーネルで使用されるリソース、または特定のゾーンに関連付けない方法で使用されるリソースの数量。
zonestat が非大域ゾーン内で使用される場合、[system] はシステムおよびその他のすべてのゾーンで使用される総リソースを指定します。
ネットワークリソースの場合、ネットワークのシステム使用量は使用できません。
使用されているリソースの量。
合計リソースの割合 (パーセント) として使用されているリソースの量。
ゾーンから横取りされた CPU 時間の量。横取りされた時間は、一部のゾーンブランドでのみサポートされます。横取りされた時間の値には、CPU リソースをほかの目的に使用しているホストのためにゾーンを実行できなかった時間が反映されます。横取りされた時間の詳細は、solaris-kz(7) を参照してください。
[system] 行の場合は、現在のシステムの横取りされた時間が報告されます。[total] 行の場合は、現在のシステムとシステム内のすべてのゾーンの横取りされた時間の合計が報告されます。
使用可能な CPU 合計時間の割合 (パーセント) としての横取りされた CPU 時間の量。
ゾーンがバインドされたプロセッサセットで合計 cpu の割合 (パーセント) として使用される cpu の量。ゾーンが大域ゾーンである場合、または psrset(8) psets が使用されている場合、ゾーンには複数の pset にバインドされたプロセスのみを含めることができます。ゾーンに複数のバインディングが見つかった場合、%PART はバインドされたすべての psets が使用される割合になります。[total] および [system] では、%PART はシステム上のすべての cpu が使用される割合 (パーセント) になります。
特定のリソースに上限を設定するようにゾーンが構成されている場合、この列にその上限が表示されます。
ゾーンの構成済み上限の割合として使用されるリソースの量。
ゾーンに割り当てられている共有の数。[total] 行では、リソースを共有するすべてのゾーンに割り当てられた共有の合計数です。共有を使用するようにゾーンが構成されていなくても、共有を使用するように構成されているその他のゾーンとリソースを共有している場合、この列にはゾーンの no-fss が含まれます。
ゾーンに割り当てられている合計共有の割合。たとえば、2 つのゾーン (それぞれ 10 共有) が 1 つの pset を共有する場合、各ゾーンの %SHR は 50% になります。
ゾーンに割り当てられている共有のうち、リソース 100% の割合。共有はリソースの競合がある場合にのみ強制されるため、ゾーンの %SHRU は 100% を超えることが可能です。
データリンクまたは仮想リンクによって送受信されたバイト数。
物理帯域幅を消費する受信バイト数。
物理帯域幅を消費する送信バイト数。
PRBYTE の受信に使用できる物理帯域幅の割合。
POBYTE の送信に使用できる物理帯域幅の割合。
使用可能な合計物理帯域幅の割合で表示した PRBYTE と POBYTE の合計。
データリンクの名前。
データリンク上で構成された最大帯域幅
構成済みの最大帯域幅の割合で表示したすべての送受信バイト数の合計
各リソース名で使用されるリソースの量。
次のコマンドは、cpu およびメモリー使用率のサマリーを 5 秒ごとに表示します。
# zonestat 5 1
SUMMARY Cpus/Online: 4/4 Physical: 8063M Virtual: 11.8G
---CPU--- --PHYSMEM-- ---VMEM--- ---NET---
ZONE USED %PART USED %USED USED %USED PBYTE %PUSE
[total] 0.23 5.76% 3211M 39.8% 4191M 34.6% 350M 18.7%
[system] 0.03 0.83% 2791M 34.6% 3890M 32.1% - -
SUMMARY Cpus/Online: 48/48 PhysMem: 95.9G VirtMem: 99G
----------CPU---------- --PhysMem-- --VirtMem-- --PhysNet--
ZONE USED %PART STLN %STLN USED %USED USED %USED PBYTE %PUSE\
[total] 2.04 4.27% 1.02 2.13% 29.4G 30.7% 31.1G 31.1% 228 0.00%
[system] 0.00 0.00% - - 12.6G 13.2% 30.3G 30.3% - -
global 0.03 0.07% - - 542M 0.55% 657M 0.64% 228 0.00%
zoneA 0.00 0.03% - - 117M 0.11% 99M 0.09% 0 0.00%
zoneB 1.99 99.9% 1.02 51.0% 8265M 8.41% 3092K 0.00% 0 0.00%
使用例 2 zonestat を使用した解析可能な出力の生成
次のコマンドは、解析可能な出力を生成します。各 pset リソースを使用するゾーンごとに 1 行を 5 秒間隔で出力します。
# zonestat -p -P zones -r psets 5 1使用例 3 zonestat を使用したデフォルトの pset についての報告
次のコマンドは、デフォルトの pset について 1 秒に 1 回、1 分間を対象として報告します。
# zonestat -r default-pset 1 1m使用例 4 zonestat を使用した合計および最大使用効率の報告
次のコマンドは、10 秒に 1 回、24 時間を対象としてメッセージを表示することなく監視し、1 時間ごとに合計および最大の報告を生成します。
# zonestat -q -R total,high 10s 24h 1h使用例 5 zonestat を使用したデータリンク使用率の報告
次のコマンドは、e1000g0 という名前のデータリンクについて 5 秒間隔で 5 回報告します。
# zonestat -r network -n e1000g0 5 5使用例 6 zonestat を使用した sysstats の報告
次のコマンドは sysstats を報告します。
$ zonestat -r sysstats 1 1
Collecting data for first interval...
Interval: 1, Duration: 0:00:01
SYSSTATS
ZONE syscall fork vfork fork-fail exec sema
[total] 9043 4 0 0 0 0
[system] 0 0 0 0 0 0
a-zone 17 0 0 0 0 0
b-zone 1 0 0 0 0 0
global 9017 4 0 0 0 0
test-zone-1 8 0 0 0 0 0
使用例 7 zonestat を使用した、fork、exec、および name-lookup のみの数の報告
次のコマンドは、fork、exec、および name-lookup の数を報告します。
# zonestat -n fork,exec,name-lookup 1 1
Collecting data for first interval...
Interval: 1, Duration: 0:00:01
SYSSTATS
ZONE fork exec
[total] 4 0
[system] 0 0
a-zone 0 0
b-zone 0 0
global 4 0
test-zone-1 0 0
FSSTATS
ZONE name-lookup
[total] 213
[system] 0
a-zone 0
b-zone 0
global 213
test-zone-1 0
次の終了ステータスが返されます。
正常終了。
エラーが発生しました。
無効な使用法。
svc:system/zones_monitoring: デフォルトで実行なし、または応答なし。
属性についての詳細は、マニュアルページの attributes(7) を参照してください。
|
コマンド呼び出しおよび解析可能な出力は「確実」です。人間が読める形式の出力 (デフォルト出力) は「不確実」です。
date(1), prctl(1), time(2), timezone(5), attributes(7), privileges(7), resource-controls(7), solaris-kz(7), pooladm(8), poolcfg(8), psrset(8), rcapadm(8), zoneadm(8), zonecfg(8), zonestatd(8)
zonestat ユーティリティーは、ゾーン監視サービス svc/system/zonestat:default に依存します。zonestat ユーティリティーの実行中に zonestat サービスが停止した場合、zonestat コマンド呼び出しは追加報告を出力せずに終了します。次の報告期間に達する前に zonestat が (CTRL/c、SIGINT によって) 中断された場合、報告 (–R) が出力されます。