jstat - Java 仮想マシン統計データ監視ツール

• 概要
• 説明
• 仮想マシン識別子
• オプション
    - 一般的なオプション
    - 出力オプション
• 例
• 関連項目

jstat [ generalOption | outputOptions vmid [interval[s|ms] [count]] ]

generalOption

単独で使用する一般的なコマンド行オプションです (-help、-options、または -version)。

outputOptions

単一の statOption と、-t、-h、および -J オプションのいずれかを組み合わせた、1 つまたは複数の出力オプションです。

vmid

ターゲットの Java 仮想マシン (JVM) を示す文字列である仮想マシン識別子です。一般的な構文は次のようになります。

[protocol:][//]lvmid[@hostname[:port]/servername]

vmid 文字列の構文の大部分は、URI の構文に対応しています。vmid は、ローカル JVM を表す単純な整数から、通信プロトコル、ポート番号、および他の実装固有の値を示す複雑な構造まで、さまざまに異なります。詳細は、「仮想マシン識別子」を参照してください。

interval[s|ms]

秒 (s) またはミリ秒 (ms) のうち指定した単位でのサンプリング間隔です。デフォルトの単位はミリ秒です。 正の整数値を使用する必要があります。 指定した場合、jstat は間隔ごとに出力を生成します。

count

表示するサンプル数です。既定値は無限です。つまり、jstat は、ターゲット JVM が終了するまで、または jstat コマンドが終了するまで、統計データを表示します。正の整数値を使用する必要があります。

jstat ツールは、設置されている HotSpot Java 仮想マシン (JVM) のパフォーマンス統計データを表示します。ターゲット JVM は、仮想マシン識別子、つまり下記の vmid オプションによって識別されます。

注: このユーティリティはサポート対象外であり、将来の J2SE SDK のバージョンでは利用できなくなる可能性があります。現在、Windows 98 および Windows Me プラットフォームでは使用できません。

仮想マシン識別子

vmid 文字列の構文の大部分は、URI の構文に対応しています。

[protocol:][//]lvmid[@hostname][:port][/servername]

protocol

通信プロトコルです。protocol が省略され、hostname が指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカルプロトコルになります。protocol が省略され、hostname が指定されている場合は、デフォルトプロトコルは rmi になります。

lvmid

ターゲット JVM のローカル仮想マシン識別子です。lvmid は、システム上の JVM を一意に識別するプラットフォーム固有の値です。lvmid は、仮想マシン識別子の唯一の必須要素です。lvmid は、絶対というわけではありませんが、一般的にはターゲット JVM プロセスに対するオペレーティングシステムのプロセス識別子です。jps コマンドを使用して、lvmid を指定できます。また、Unix プラットフォームではps コマンドを使用して、Windows では Windows タスクマネージャを使用して、lvmid を指定できます。

hostname

ターゲットホストを示すホスト名または IP アドレスです。hostname が省略されている場合は、ターゲットホストはローカルホストになります。

port

リモートサーバと通信するためのデフォルトポートです。hostname が省略されているか、protocol で最適化されたローカルプロトコルが指定されている場合、port は無視されます。そうでなければ、port パラメータの扱いは、実装によって異なります。デフォルトの rmi プロトコルの場合、port は、リモートホスト上の rmiregistry のポート番号を示します。port が省略され、protocol で rmi が指定されている場合、デフォルトの rmiregistry ポート (1099) が使用されます。

servername

このパラメータの扱いは、実装によって異なります。最適化されたローカルプロトコルの場合、このフィールドは無視されます。rmi プロトコルの場合は、このパラメータは、リモートホスト上の RMI リソースオブジェクトの名前を示します。

jstat コマンドは、一般的なオプションと出力オプションの 2 つのタイプのオプションをサポートしています。一般的なオプションを使用した場合、jstat は簡単な使用率およびバージョン情報を表示します。出力オプションでは、統計データ出力の内容と形式を指定します。

注: すべてのオプションとその機能は、将来のリリースで変更または廃止される可能性があります。

一般的なオプション

いずれかの一般的なオプションを指定した場合、他のオプションまたはパラメータは一切指定できません。

-help

ヘルプメッセージを表示します。

-version

バージョン情報を表示します。

-options

統計データオプションを一覧表示します。下記の「出力オプション」の節を参照してください。

一般的なオプションを指定しない場合に、出力オプションを指定できます。出力オプションは、jstat の出力の内容および形式を指定し、単一の statOption と、他のいずれかの出力オプション (-h、-t、および -J) とで構成されます。 statOption は最初に記述する必要があります。

出力は、各列が空白で区切られたテーブルの形式で構成されます。タイトルを記したヘッダ行に、各列の説明が記されます。 -h オプションを使用して、ヘッダを表示する頻度を設定します。 通常、列のヘッダ名はオプションが異なっている場合でも一貫しています。一般に、2 つのオプションで同じ名前の列が使用されていれば、2 つの列のデータソースは同じになります。

-t オプションを使用すると、Timestamp というラベルの付いたタイムスタンプの列が、出力の最初の列として表示されます。Timestamp 列には、ターゲット JVM の起動からの経過時間が、秒単位で表示されます。タイムスタンプの精度は、さまざまな要因によって異なり、大量の負荷のかかったシステムでのスレッドスケジュールの遅延により変動します。

interval および count パラメータを使用して、jstat がその出力を表示する頻度と回数をそれぞれ指定します。

注: 将来のリリースでこの形式は変更される可能性があるため、jstat の出力を解析するスクリプトは作成しないことをお勧めします。jstat 出力を解析するスクリプトを作成する場合は、このツールの将来のリリースで、そのスクリプトを変更しなければならないことに留意してください。

-statOption

jstat が表示する統計データ情報を指定します。次の表には、利用可能なオプションが一覧表示されています。 特定のプラットフォームのインストールについて、オプションを一覧表示するには、一般的なオプションの -options を使用します。

オプション	表示内容
class	クラスローダの動作に関する統計データ
compiler	HotSpot Just-in-Time コンパイラの動作に関する統計データ
gc	ガベージコレクトされたヒープの動作に関する統計データ
gccapacity	世代ごとの容量と対応する領域に関する統計データ
gccause	ガベージコレクション統計データの概要 (-gcutil と同じ) と、直前および現在 (適用可能な場合) のガベージコレクションイベントの原因
gcnew	New 世代の動作に関する統計データ
gcnewcapacity	New 世代のサイズと対応する領域に関する統計データ
gcold	Old 世代および Permanent 世代の動作に関する統計データ
gcoldcapacity	Old 世代のサイズに関する統計データ
gcpermcapacity	Permanent 世代のサイズに関する統計データ
gcutil	ガベージコレクション統計データの概要
printcompilation	HotSpot コンパイル方法の統計データ

-h n

n サンプル (出力行) ごとに列ヘッダを表示。ただし、n は正の整数値。デフォルト値は 0。このとき、データの最初の行の上に列ヘッダが表示される

-t n

タイムスタンプ列を出力の最初の列として表示。タイムスタンプは、ターゲット JVM の起動時からの経過時間

-J javaOption

javaOption を java アプリケーション起動ツールへ渡す。たとえば、-J-Xms48m と指定すると、起動メモリは 48Mバイトに設定される。オプションの完全なリストについては、次のドキュメントを参照

• 「java - Java アプリケーション起動ツール (Solaris)」
• 「java - Java アプリケーション起動ツール (Linux)」
• 「java - Java アプリケーション起動ツール (Windows)」

statOption と出力

以降の表では、jstat が statOption ごとに出力する列について概要を示します。

-class オプション

-compiler オプション

-gc オプション

-gccapacity オプション

-gccause オプション

このオプションは、-gcutil オプションと同じガベージコレクション統計データの概要を表示しますが、最後のガベージコレクションイベントと (適用可能な場合は) 現在のガベージコレクションイベントの原因が含まれます。-gcutil で一覧表示される列の他に、このオプションでは次の列が追加されます。

-gcnew オプション

-gcnewcapacity オプション

-gcold オプション

-gcoldcapacity オプション

-gcpermcapacity オプション

-gcutil オプション

-printcompilation オプション

この項では、21891 の lvmid を持つローカル JVM を監視する例を示します。

gcutil オプションの使用

この例は、lvmid 21891 に接続して、250 ミリ秒間隔で 7 つのサンプルを取得し、-gcutil オプションでの指定に従って出力を表示します。

jstat -gcutil 21891 250 7
  S0     S1     E      O      P     YGC    YGCT    FGC    FGCT     GCT
 12.44   0.00  27.20   9.49  96.70    78    0.176     5    0.495    0.672
 12.44   0.00  62.16   9.49  96.70    78    0.176     5    0.495    0.672
 12.44   0.00  83.97   9.49  96.70    78    0.176     5    0.495    0.672
  0.00   7.74   0.00   9.51  96.70    79    0.177     5    0.495    0.673
  0.00   7.74  23.37   9.51  96.70    79    0.177     5    0.495    0.673
  0.00   7.74  43.82   9.51  96.70    79    0.177     5    0.495    0.673
  0.00   7.74  58.11   9.51  96.71    79    0.177     5    0.495    0.673

この例の出力は、Young 世代のコレクションが 3 番目と 4 番目のサンプル間で行われたことを示しています。コレクションには 0.001 秒かかっており、オブジェクトが Eden 領域 (E) から Old 領域 (O) に昇格したため、Old 領域の使用率は 9.49% から 9.51% に増加しています。Survivor 領域は、コレクション前は 12.44% が使用されていましたが、コレクション後は 7.74% しか使用されていません。

この例は、lvmid 21891 に接続して、250 ミリ秒間隔でサンプルを取得し、-gcutil オプションでの指定に従って出力を表示します。さらに、-h3 オプションを使用して、データが 3 行表示されるごとに列ヘッダを出力します。

jstat -gcnew -h3 21891 250
 S0C    S1C    S0U    S1U   TT MTT  DSS      EC       EU     YGC     YGCT
  64.0   64.0    0.0   31.7 31  31   32.0    512.0    178.6    249    0.203
  64.0   64.0    0.0   31.7 31  31   32.0    512.0    355.5    249    0.203
  64.0   64.0   35.4    0.0  2  31   32.0    512.0     21.9    250    0.204
 S0C    S1C    S0U    S1U   TT MTT  DSS      EC       EU     YGC     YGCT
  64.0   64.0   35.4    0.0  2  31   32.0    512.0    245.9    250    0.204
  64.0   64.0   35.4    0.0  2  31   32.0    512.0    421.1    250    0.204
  64.0   64.0    0.0   19.0 31  31   32.0    512.0     84.4    251    0.204
 S0C    S1C    S0U    S1U   TT MTT  DSS      EC       EU     YGC     YGCT
  64.0   64.0    0.0   19.0 31  31   32.0    512.0    306.7    251    0.204

この例では、ヘッダ文字列の繰り返しが見られるほかにも、2 番目と 3 番目のサンプル間で Young GC が行われたことがわかります。この継続時間は 0.001 秒でした。このコレクションでは、Survivor 領域 0 の使用率 (S0U) が適切な Survivor サイズ (DSS) を超過することになるライブデータが検出されました。この結果、オブジェクトは、Old 世代 (この出力には非表示) へ昇格され、殿堂入りしきい値 (TT) が、31 から 2 へ降格されました。

別のコレクションが、5 番目と 6 番目のサンプル間で行われています。このコレクションでは、Survivor がほとんど見られず、殿堂入りしきい値を 31 に戻しました。

この例は、lvmid 21891 へ接続し、250 ミリ秒間隔で 3 つのサンプルを取得しています。-t オプションを使用して、最初の列にサンプルごとのタイムスタンプを表示しています。

jstat -gcoldcapacity -t 21891 250 3
Timestamp          OGCMN        OGCMX         OGC           OC       YGC   FGC    FGCT    GCT
          150.1       1408.0      60544.0      11696.0      11696.0   194    80    2.874   3.799
          150.4       1408.0      60544.0      13820.0      13820.0   194    81    2.938   3.863
          150.7       1408.0      60544.0      13820.0      13820.0   194    81    2.938   3.863

Timestamp 列には、ターゲット JVM の起動時からの経過時間が、秒単位でレポートされています。さらに、-gcoldcapacity 出力では、割り当て要求または昇格要求あるいはその両方を満たすためにヒープが拡張するごとに、Old 世代の容量 (OGC) と Old 領域の容量 (OC) とが増加していることがわかります。Old 世代の容量 (OGC) は、81 番目のフル GC (FGC) 後に、11696 KB から 13820 KB へ増加しています。Old 世代 (および領域) の最大容量は、60544 KB (OGCMX) なので、まだ拡張できる余裕が残されています。

この例は、-gcutil オプションを使用して、remote.domain というシステム上の lvmid 40496 に接続し、サンプルを秒単位で無期限に取得しています。

jstat -gcutil 40496@remote.domain 1000
... output omitted

lvmid は、リモートホストの名前と結合されて、40496@remote.domain の vmid を構成しています。結果として、この vmid は、rmi プロトコルを使用して、リモートホスト上のデフォルトの jstatd サーバと通信します。jstatd サーバは、rmiregistry を使用して、デフォルトの rmiregistry ポート (ポート 1099) にバインドされた remote.domain に配置されれます。

• 「java - Java アプリケーション起動ツール」
• 「jps - Java 仮想マシンプロセスステータスツール」
• 「jstatd - 仮想マシン jstat デーモン」
• 「rmiregistry - Java リモートオブジェクトレジストリ」

Copyright © 2003 Sun Microsystems, Inc.All Rights Reserved.

Java ソフトウェア