この章では、asadmin コマンド行ユーティリティーを使用して、Sun GlassFishTM Enterprise Server v3 のコンポーネントとサービスを監視する方法について説明します。Enterprise Server リソースを監視するための JConsole の設定手順についても説明します。
ここでは、次のテーマを取り上げます。
管理コンソール を使用して監視を行う場合の手順は、管理コンソール のオンラインヘルプで説明します。
REST インタフェースを使用して監視を行う方法については、「REST インタフェースによる Enterprise Server の管理」を参照してください。
「監視」は、パフォーマンスの向上や問題の解決のために、システムの統計を調査する処理です。監視サービスでは、1 秒あたりの要求数、平均応答時間、スループットなどの運用上の統計を追跡および表示できます。Enterprise Server に配備されたさまざまなコンポーネントとサービスの状態を監視することで、パフォーマンスのボトルネックの識別、障害の予測、根本原因の分析を行い、すべての機能を期待どおりに動作させることができます。監視によって収集されたデータは、パフォーマンスの調整や容量計画にも役立ちます。
Enterprise Server のこのリリースでは、監視はモジュール方式で公開され、多くのクライアントモジュールが監視統計にアクセスして、これらを表示することができます。これらのクライアントには、管理コンソール、asadmin ユーティリティー、AMX、および REST インタフェースが含まれます。
ここでは、次のテーマを取り上げます。
「監視可能なオブジェクト」は、監視の対象に指定できるコンポーネント、サブコンポーネント、またはサービスです。Enterprise Server は、ツリー構造を使って監視可能なオブジェクトを追跡します。ツリーは動的であるため、Enterprise Server のコンポーネントが追加または削除されるときに、ツリーも変更されます。
ツリー内の監視可能なオブジェクトは、そのオブジェクトで監視できる対象を正確に表す子オブジェクト (ノード) を持ちます。すべての子オブジェクトのアドレス指定にはドット (.) 文字を区切り記号として使用します。このようなドット区切りの名前は、「ドット表記名」と呼ばれます。ドット表記名の詳細は、dotted-names(5ASC) のマニュアルページを参照してください。
次のコマンドは、インスタンス server の監視可能な子オブジェクトを一覧表示します。
asadmin> list --monitor "server.*" |
server.applications server.connector-service server.http-service server.jms-service server.containers.jruby server.jvm server.network server.orb server.resources server.security server.thread-pool server.transaction-service server.web |
各オブジェクトはドット表記名で表されます。また、監視可能なオブジェクトの特定の属性も、ドット表記名で指定します。たとえば、jvm オブジェクトには memory 属性と maxheapsize という名前の統計があります。この属性は次のドット表記名で表します。
server.jvm.memory.maxheapsize
オブジェクトが監視可能であっても、常に監視する必要はありません。監視を有効にする手順については、「監視の設定」を参照してください。
監視可能なオブジェクトは、それぞれ階層的なツリー構造を持ちます。ツリー中の「*statistics」などの置換可能な文字列は、統計を表示できる属性の名前を表しています。
ここでは、次のノードのツリー階層を説明します。
applications ツリーには、次のノードが含まれます。
server.applications |--- application1 | |--- ejb-module-1 | | |--- ejb1 * | | |--- bean-cache (for entity/sfsb) * | | |--- bean-pool (for slsb/mdb/entity) * | | |--- bean-methods | | |---method1 * | | |---method2 * | | |--- timers (for s1sb/entity/mdb) * | |--- web-module-1 | | |--- virtual-server-1 * | | |---servlet1 * | | |---servlet2 * |--- standalone-web-module-1 | | |----- virtual-server-2 * | | |---servlet3 * | | |---servlet4 * | | |----- virtual-server-3 * | | |---servlet3 *(same servlet on different vs) | | |---servlet5 * |--- standalone-ejb-module-1 | | |--- ejb2 * | | |--- bean-cache (for entity/sfsb) * | | |--- bean-pool (for slsb/mdb/entity) * | | |--- bean-methods | | |--- method1 * | | |--- method2 * | | |--- timers (for s1sb/entity/mdb) * |--- jersey-application-1 | |--- jersey | | |--- resources resource-0 hitcount *statistic |--- application2
ドット表記名は、server.applications.hello.server.request.maxtime のようになります。
EJB の method ノード以下のドット表記名は、server.applications.ejbsfapp1.ejbsfapp1ejbmod1\.jar.SFApp1EJB1 のようになります。
Jersey のドット表記名は、server.applications.helloworld-webapp.jersey.resources.resource-0.hitcount .resourcehitcount-count のようになります。
使用可能な統計については、「EJB 統計」、「Jersey の統計」、および 「Web の統計」 を参照してください。
connector-service ツリーには、コネクタ接続プールなどの、プールの監視可能な属性が格納されます。connector-service ツリーには、次のノードが含まれます。
server.connector-service resource-adapter-1 connection-pools pool-1 work-management
ドット表記名は、server.connector-service.resource-adapter-1.connection-pools.pool-1 のようになります。使用可能な統計については、「JMS サービスおよびコネクタサービスの統計」を参照してください。
http-service ツリー階層には、次のノードが含まれます。
server.http-service virtual-server request *statistic _asadmin request *statistic
virtual-server ノード以下のドット表記名は、server.http-service.virtual-server1.request.requestcount のようになります。使用可能な統計については、「HTTP サービスの統計」を参照してください。
jms-service ツリーには、接続ファクトリ (リソースアダプタの接続プール) と作業管理 (Message Queue リソースアダプタ用) の監視可能な属性が格納されます。jms-service ツリーには、次のノードが含まれます。
server.jms-service connection-factories connection-factory-1 work-management
connection-factories ノード以下のドット表記名は、server.jms-service.connection-factories.connection-factory-1 のようになります。この表記名は、この接続ファクトリのすべての統計を表します。使用可能な統計については、「JMS サービスおよびコネクタサービスの統計」を参照してください。
jruby ツリーには、次のノードが含まれます。
server.containers.jruby.applications jruby-application *statistic http *statistic runtime-pool *statistic |
使用可能な統計については、「JRuby の統計」を参照してください。
jvm ツリーには、次のノードが含まれます。
server.jvm class-loading-system compilation-system garbage-collectors memory operating-system runtime
memory ノード以下のドット表記名は、server.jvm.memory.maxheapsize のようになります。使用可能な統計については、「JVM の統計」を参照してください。
ネットワークの統計は、admin-listener 、http-listener-1、http-listener-2 などのネットワークリスナーに適用されます。network ツリーには、次のノードが含まれます。
server.network type-of-listener keep-alive *statistic file-cache *statistic thread-pool *statistic connection-queue *statistic
network ノード以下のドット表記名は、server.network.admin-listener.keep-alive.maxrequests-count のようになります。使用可能な統計については、「ネットワークの統計」を参照してください。
orb ツリーには、接続マネージャーの監視可能な属性が格納されます。orb ツリーには、次のノードが含まれます。
server.orb transport connectioncache inbound *statistic outbound *statistic
ドット表記名は、server.orb.transport.connectioncache.inbound.connectionsidle-count のようになります。使用可能な統計については、「ORB の統計 (接続マネージャー)」を参照してください。
resources ツリーには、JDBC 接続プールやコネクタ接続プールなどの、プールの監視可能な属性が格納されます。resources ツリーには、次のノードが含まれます。
server.resources connection-pool request *statistic
ドット表記名は、server.resources.jdbc-connection-pool1.numconnfree.count のようになります。使用可能な統計については、「リソースの統計 (接続プール)」を参照してください。
security ツリーには、次のノードが含まれます。
server.security ejb *statistic web *statistic realm *statistic
ドット表記名は、server.security.realm.realmcount-starttime のようになります。使用可能な統計については、「セキュリティーの統計」を参照してください。
thread-pool ツリー階層には、接続マネージャーの監視可能な属性が格納され、次のノードが含まれます。
server.thread-pool orb threadpool thread-pool-1 *statistic
ドット表記名は、server.thread-pool.orb.threadpool.thread-pool-1.averagetimeinqueue-current のようになります。使用可能な統計については、「スレッドプールの統計」を参照してください。
transaction-service ツリーには、トランザクションをロールバックするためのトランザクションサブシステムに関して、監視可能な属性が格納されます。transaction-service ツリーには、次のノードが含まれます。
server.transaction-service statistic
ドット表記名は、server.tranaction-service.activeids のようになります。使用可能な統計については、「トランザクションサービスの統計」を参照してください。
web ツリーには、次のノードが含まれます。
server.web jsp *statistic servlet *statistic session *statistic request *statistic
servlet ノードのドット表記名は、server.web.servlet.activeservletsloadedcount のようになります。使用可能な統計については、「Web モジュールの共通統計」を参照してください。
一般的に、アドオンコンポーネントは、Enterprise Server が実行時に収集できる統計を生成します。監視機能を追加することで、アドオンコンポーネントは Enterprise Server の配布で提供されているコンポーネントと同じ方法で、Enterprise Server に統計を提供できるようになります。結果として、コンポーネントの製造元にかかわらず、インストールされているすべての Enterprise Server コンポーネントの統計を、同じ管理インタフェースを使用して監視することができます。
Enterprise Server のサービスとコンポーネントを監視するために、次の asadmin サブコマンドが提供されています。
enable-monitoring、disable-monitoring、または get および set サブコマンドは、監視を有効または無効にするために使用します。手順については、「監視の設定」を参照してください。
monitor --type サブコマンドは、特定のタイプの監視可能なオブジェクトの基本データを表示するために使用します。手順については、「共通の監視データの表示」を参照してください。
list --monitor サブコマンドは、monitor サブコマンドで監視できるオブジェクトを表示するために使用します。ガイドラインと手順については、「list および get サブコマンドを監視に使用する場合のガイドライン」を参照してください。
get サブコマンドは、属性や値などの総合的なデータをドット表記名で表示するために使用します。get サブコマンドでワイルドカードのパラメータを使用すると、任意の監視可能なオブジェクトで使用可能なすべての属性を表示できます。詳細は、「list および get サブコマンドを監視に使用する場合のガイドライン」を参照してください。
デフォルトでは、Enterprise Server の監視サービスは有効になっていますが、各モジュールの監視は有効になっていません。モジュールの監視を有効にするには、モジュールの監視レベルを LOW または HIGH に変更します。監視の必要がないオブジェクトでは、監視レベルを OFF のままにすることもできます。
LOW。作成数やバイト数などの簡単な統計が含まれます。
HIGH。簡単な統計に加え、メソッドの数や実行時間などのメソッドの統計が含まれます。
OFF。監視を行いません。パフォーマンスへの影響はありません。
ここでは、次のタスクを説明します。
enable-monitoring サブコマンドを使用して、監視サービス自体を有効にするか、個々のモジュールの監視を有効にします。監視はただちに有効になります。Enterprise Server の再起動は必要ありません。
set(1) サブコマンドを使用して、モジュールの監視を有効にすることもできます。set コマンドの使用は動的な手順ではないため、変更を有効にするには Enterprise Server を再起動する必要があります。
現在監視が有効になっているサービスとコンポーネントを確認します。
asadmin> get server.monitoring-service.module-monitoring-levels.* |
この例の出力は、HTTP サービスでは監視が有効でなく (OFF)、その他のオブジェクトでは有効であることを示しています。
configs.config.server-config.monitoring-service.module-monitoring-levels.web-container=HIGH configs.config.server-config.monitoring-service.module-monitoring-levels.http-service=OFF configs.config.server-config.monitoring-service.module-monitoring-levels.jvm=HIGH |
enable-monitoring(1) サブコマンドを使用して、監視を有効にします。
サーバーの再起動は必要ありません。
この例では、個々のモジュールの監視に影響を与えずに、監視サービスを有効にします。
asadmin> enable-monitoring Command enable-monitoring executed successfully |
この例では、ejb-container モジュールの監視を有効にします。
asadmin> enable-monitoring --level ejb-container=HIGH Command enable-monitoring executed successfully |
この例では、監視レベルを HIGH に設定することで、HTTP サービスの監視を有効にします。変更を有効にするには、サーバーを再起動する必要があります。
asadmin> set server.monitoring-service.module-monitoring-levels.http-service=HIGH Command set executed successfully |
コマンド行に asadmin help enable-monitoring と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。
disable-monitoring サブコマンドを使用して、監視サービス自体を無効にするか、個々のモジュールの監視を無効にします。監視はただちに停止されます。Enterprise Server の再起動は必要ありません。
set(1) サブコマンドを使用して、モジュールの監視を無効にすることもできます。set コマンドの使用は動的な手順ではないため、変更を有効にするには Enterprise Server を再起動する必要があります。
現在監視が有効になっているサービスとコンポーネントを確認します。
asadmin get server.monitoring-service.module-monitoring-levels.* |
この例の出力は、web-container 、http-service、および jvm で監視が有効であることを示しています。
configs.config.server-config.monitoring-service.module-monitoring-levels.web-container=HIGH configs.config.server-config.monitoring-service.module-monitoring-levels.http-service=HIGH configs.config.server-config.monitoring-service.module-monitoring-levels.jvm=HIGH |
disable-monitoring(1) サブコマンドを使用して、サービスまたはモジュールの監視を無効にします。
サーバーの再起動は必要ありません。
この例では、個々のモジュールの監視レベルを変更することなく、監視サービスを無効にします。
asadmin> disable-monitoring Command disable-monitoring executed successfully |
この例では、指定したモジュールの監視を無効にします。これらのモジュールの監視レベルは OFF に設定されます。
asadmin> disable-monitoring --modules web-container,ejb-container Command disable-monitoring executed successfully |
この例では、HTTP サービスの監視を無効にします。変更を有効にするには、サーバーを再起動する必要があります。
asadmin> set server.monitoring-service.module-monitoring-levels.http-service=OFF Command set executed successfully |
コマンド行に asadmin help disable-monitoring と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。
monitor サブコマンドを使用して、共通で監視されるオブジェクトについての基本的なデータを表示できます。
monitor サブコマンドの --type オプションを使用して、httplistener、jvm、webmodule などの、データを表示するオブジェクトを指定します。タイプを指定せずに monitor サブコマンドを使用すると、エラーメッセージが表示されます。
サブコマンドの出力は、表形式で続けて表示されます。--interval オプションを使用すると、特定の間隔 (デフォルトでは 30 秒) で出力を表示することができます。
監視可能なオブジェクトのデータを表示する前に、対象のオブジェクトで監視を設定する必要があります。「監視を有効にする 」を参照してください。
監視する監視可能なオブジェクトのタイプを決定します。
v3 では、jvm、httplistener 、および webmodule を選択できます。
monitor(1) サブコマンドを使用して、監視データを要求します。
この例では、インスタンス server の jvm タイプの共通データを要求します。
asadmin> monitor --type jvm server UpTime(ms) Heap and NonHeap Memory(bytes) current min max low high count 9437266 8585216 619642880 0 0 93093888 9467250 8585216 619642880 0 0 93093888 |
コマンド行に asadmin help monitor と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。
共通の監視統計について、次の節で説明します。
httplistener タイプに関して利用可能な統計を、次の表に示します。
表 8–1 HTTP リスナーの共通監視統計
Statistic |
説明 |
---|---|
ec |
エラー数。エラー数の累積値です。 |
mt |
最大時間。要求あたりの最長応答時間です。累積値ではなく、応答時間の中で最大の値です。 |
pt |
処理時間。各要求の処理にかかった時間の累積値。処理時間は、要求全体での要求処理時間の平均になります。 |
rc |
要求数。現時点までに処理された要求の累積数。 |
jvm タイプに関して利用可能な統計を、次の表に示します。
表 8–2 JVM の共通監視統計
Statistic |
説明 |
---|---|
count |
JVM マシンでの使用が保証されているメモリー量 (バイト)。 |
high |
他のリリースとの互換性を維持するために使用されます。 |
low |
他のリリースとの互換性を維持するために使用されます。 |
max |
メモリー管理用として使用可能なメモリーの最大サイズ。 |
min |
起動中のメモリー管理用に JVM マシンがオペレーティングシステムに要求するメモリー量の初期値 (バイト)。 |
UpTime |
直前の起動日時からの JVM マシンの稼働時間 (ミリ秒)。 |
webmodule タイプに関して利用可能な統計を、次の表に示します。
表 8–3 Web モジュールの共通監視統計
Statistic |
説明 |
---|---|
ajlc |
読み込まれているアクティブな JavaServer PagesTM (JSPTM) テクノロジページの数。 |
asc |
現在のアクティブなセッション。 |
aslc |
読み込まれているアクティブなサーブレットの数。 |
ast |
アクティブなセッションの合計数。 |
mjlc |
読み込まれている JSP ページの最大数。 |
mslc |
読み込まれているサーブレットの最大数 |
rst |
拒否されたセッションの合計数。 |
st |
セッションの合計数。 |
tjlc |
読み込まれている JSP ページの合計数。 |
tslc |
読み込まれているサーブレットの合計数。 |
ツリー構造に対して list および get サブコマンドをドット表記名を使用して適用することで、各統計の説明や測定単位など、より総合的な監視データを表示することができます。
ここでは、次のテーマを取り上げます。
list コマンドと get コマンドでドット表記名を使用する場合は、基本として次の内容が前提となります。
list サブコマンドにドット表記名を指定する場合、ドット表記名のあとにワイルドカード (*) を指定しないと、現在のノードの直接の子だけが一覧表示されます。たとえば、次のサブコマンドは server ノードに属する直接の子をすべて表示します。
list --monitor server
list サブコマンドにドット表記名を指定する場合、ドット表記名の後ろに .* の形式のワイルドカードを指定すると、指定したノードから子ノードの階層ツリーが一覧表示されます。たとえば、次のサブコマンドは applications ノード以下のすべての子ノードを、それぞれの子ノードも含めてすべて表示します。
list --monitor server.applications.*
list サブコマンドにドット表記名を指定する場合、ドット表記名の前または後ろに、*dottedname、dotted * name、または dottedname * の形式のワイルドカードを指定すると、指定したマッチングパターンで表される正規表現に一致する、すべてのノードとその子ノードが一覧表示されます。
get サブコマンドのあとに .* または * を指定すると、指定したノードに含まれる属性とその値のセットが取得されます。
例として、list および get サブコマンドに resources ノードのドット表記名を使用した場合の出力を、次の表に示します。
表 8–4 リソースレベルのドット表記名の例
サブコマンド |
ドット表記名 |
出力 |
---|---|---|
list --monitor |
server.resources |
プール名の一覧。 |
list --monitor |
server.resources.connection-pool1 |
属性は表示されず、代わりに「get --monitor サブコマンドを使用して、このノードの属性と値を表示してください」というメッセージが表示されます。 |
get --monitor |
server.resources.connection-pool1.* |
接続プールの属性に対応した属性と値のリスト。 |
ドット表記名の詳細は、dotted-names(5ASC) のマニュアルページを参照してください。
monitor サブコマンドは多くの状況で役に立ちますが、すべての監視可能なオブジェクトの完全なリストを表示することはできません。特定のオブジェクトタイプの総合的なデータを操作するには、list --monitor サブコマンドおよび get --monitor サブコマンドのあとに、監視可能なオブジェクトのドット表記名を指定します。
監視可能なオブジェクトの情報を表示する前に、対象のオブジェクトで監視を設定する必要があります。必要な場合は、「監視を有効にする 」を参照してください。
list(1) サブコマンドを使用して、監視が有効なオブジェクトを一覧表示します。
たとえば、次のサブコマンドは、インスタンス server で監視が有効になっているコンポーネントとサービスをすべて表示します。
asadmin> list --monitor "*" server.web server.connector-service server.orb server.jms-serviceserver.jvm server.applications server.http-service server.thread-pools |
get(1) サブコマンドを使用して、監視対象のコンポーネントまたはサービスのデータを取得します。
この例では、インスタンス serverで、オブジェクトタイプ jvm のすべての属性に関する情報を取得します。
asadmin> get --monitor server.jvm.* server.jvm.class-loading-system.loadedclasscount = 3715 server.jvm.class-loading-system.totalloadedclasscount = 3731 server.jvm.class-loading-system.unloadedclasscount = 16 server.jvm.compilation-system.name-current = HotSpot Client Compiler server.jvm.compilation-system.totalcompilationtime = 769 server.jvm.garbage-collectors.Copy.collectioncount = 285 server.jvm.garbage-collectors.Copy.collectiontime = 980 server.jvm.garbage-collectors.MarkSweepCompact.collectioncount = 2 server.jvm.garbage-collectors.MarkSweepCompact.collectiontime = 383 server.jvm.memory.committedheapsize = 23498752 server.jvm.memory.committednonheapsize = 13598720 server.jvm.memory.initheapsize = 0 server.jvm.memory.initnonheapsize = 8585216 server.jvm.memory.maxheapsize = 66650112 server.jvm.memory.maxnonheapsize = 100663296 server.jvm.memory.objectpendingfinalizationcount = 0 server.jvm.memory.usedheapsize = 19741184 server.jvm.memory.usednonheapsize = 13398352 server.jvm.operating-system.arch-current = x86 server.jvm.operating-system.availableprocessors = 2 server.jvm.operating-system.name-current = Windows XP server.jvm.operating-system.version-current = 5.1 server.jvm.runtime.classpath-current = glassfish.jar server.jvm.runtime.inputarguments-current = [] server.jvm.runtime.managementspecversion-current = 1.0 server.jvm.runtime.name-current = 4372@ABBAGANI_WORK server.jvm.runtime.specname-current = Java Virtual Machine Specification server.jvm.runtime.specvendor-current = Sun Microsystems Inc. server.jvm.runtime.specversion-current = 1.0 server.jvm.runtime.uptime = 84813 server.jvm.runtime.vmname-current = Java HotSpot(TM) Client VM server.jvm.runtime.vmvendor-current = Sun Microsystems Inc. server.jvm.runtime.vmversion-current = 1.5.0_11-b03 |
この例では、インスタンス server の監視可能なアプリケーションをすべて表示します。
asadmin> list --monitor server.applications.* server.applications.app1 server.applications.app2 server.applications.app1.virtual-server1 server.applications.app2.virtual-server1 |
この例では、アプリケーション hello のすべての属性に関する情報を取得します。
asadmin> get --monitor server.applications.hello.* server.applications.hello.server.activatedsessionstotal = 0 server.applications.hello.server.activejspsloadedcount = 1 server.applications.hello.server.activeservletsloadedcount = 1 server.applications.hello.server.activesessionscurrent = 1 server.applications.hello.server.activesessionshigh = 1 server.applications.hello.server.errorcount = 0 server.applications.hello.server.expiredsessionstotal = 0 server.applications.hello.server.maxjspsloadedcount = 1 server.applications.hello.server.maxservletsloadedcount = 0 server.applications.hello.server.maxtime = 0 server.applications.hello.server.passivatedsessionstotal = 0 server.applications.hello.server.persistedsessionstotal = 0 server.applications.hello.server.processingtime = 0.0 server.applications.hello.server.rejectedsessionstotal = 0 server.applications.hello.server.requestcount = 0 server.applications.hello.server.sessionstotal = server.applications.hello.server.totaljspsloadedcount = 0 server.applications.hello.server.totalservletsloadedcount = 0 |
この例では、インスタンス server の jvm 属性 runtime.vmversion-current に関する情報を取得します。
asadmin> get --monitor server.jvm.runtime.vmversion-current server.jvm.runtime.vmversion-current = 10.0-b23 |
目的の統計を表すドット表記名を指定することで、総合的な監視統計を取得できます。たとえば、次のドット表記名では、virtual-server1 の HTTP サービスに対する要求の累積数が表示されます。
server.http-service.virtual-server1.request.requestcount
監視可能なオブジェクトのそれぞれで使用可能な統計を、次の節の表に示します。
EJB は、「アプリケーションのツリー階層」に示したオブジェクトツリー内に含まれます。次のドット表記名パターンを使用して、アプリケーションの統計を取得します。
server.applications.appname.ejbmodulename.ejbname.bean-cache.statistic
アプリケーションに関して利用可能な統計を、次の節で説明します。
EJB キャッシュの統計では、次のドット表記名パターンを使用します。
server.applications.appname.ejbmodulename.bean-cache.ejbname.statistic
EJB キャッシュに関して利用可能な統計を、次の表に示します。
表 8–5 EJB キャッシュの監視統計
Statistic |
データ型 |
説明 |
---|---|---|
cachemisses |
RangeStatistic |
ユーザー要求に対する Bean がキャッシュ内で見つからなかった回数。 |
cachehits |
RangeStatistic |
ユーザー要求に対するエントリがキャッシュ内で見つかった回数。 |
numbeansincache |
RangeStatistic |
キャッシュ内の Beans 数。これは現在のキャッシュサイズです。 |
numpassivations |
CountStatistic |
非活性化された Bean の数。ステートフルセッション Beans にのみ適用されます。 |
numpassivationerrors |
CountStatistic |
非活性化中に発生したエラーの数。ステートフルセッション Beans にのみ適用されます。 |
numexpiredsessionsremoved |
CountStatistic |
クリーンアップスレッドによって削除された期限切れセッションの数。ステートフルセッション Beans にのみ適用されます。 |
numpassivationsuccess |
CountStatistic |
非活性化が正常に終了した回数。ステートフルセッション Beans にのみ適用されます。 |
EJB コンテナの統計では、次のドット表記名パターンを使用します。
server.applications.appname.ejbmodulename.container.ejbname
EJB コンテナに関して利用可能な統計を、次の表に示します。
表 8–6 EJB コンテナの監視統計
Statistic |
データ型 |
説明 |
---|---|---|
createcount |
CountStatistic |
特定の EJB に対する create メソッドの呼び出し回数。 |
messagecount |
CountStatistic |
特定のメッセージ駆動型 Bean に対して受信されたメッセージの数。 |
methodreadycount |
RangeStatistic |
MethodReady 状態にあるステートフルまたはステートレスセッション Beans の数。 |
passivecount |
RangeStatistic |
Passive 状態にあるステートフルセッション Beans の数。 |
pooledcount |
RangeStatistic |
プールされた状態にあるエンティティー Bean の数。 |
readycount |
RangeStatistic |
実行可能状態にあるエンティティー Bean の数。 |
removecount |
CountStatistic |
特定の EJB に対する remove メソッドの呼び出し回数。 |
EJB メソッドの統計では、次のドット表記名パターンを使用します。
server.applications.appname.ejbmodulename.bean-methods.ejbname.statistic
EJB メソッドの呼び出しに関して利用可能な統計を、次の表に示します。
表 8–7 EJB メソッドの監視統計
Statistic |
データ型 |
説明 |
---|---|---|
executiontime |
CountStatistic |
成功または失敗した最後の操作実行時にメソッド実行に費やされた時間 (ミリ秒)。この情報は、EJB コンテナの監視が有効になっている場合に、ステートレスおよびステートフルのセッション Beans とエンティティー Beans に対して収集されます。 |
methodstatistic |
TimeStatistic |
特定の操作の呼び出し回数。その呼び出しにかかった合計時間など。 |
totalnumerrors |
CountStatistic |
メソッド実行時に例外が発生した回数。この情報は、EJB コンテナの監視が有効になっている場合に、ステートレスおよびステートフルのセッション Beans とエンティティー Beans に対して収集されます。 |
totalnumsuccess |
CountStatistic |
メソッドが正常に実行された回数。この情報は、EJB コンテナの監視が有効になっている場合に、ステートレスおよびステートフルのセッション Beans とエンティティー Beans に対して収集されます。 |
EJB プールの統計では、次のドット表記名パターンを使用します。
server.applications.appname.ejbmodulename.bean-pool.ejbname.statistic表 8–8 EJB プールの監視統計
Statistic |
データ型 |
説明 |
---|---|---|
jmsmaxmessagesload |
CountStatistic |
メッセージ駆動型 Bean のサービスを提供するために JMS セッション内に一度にロード可能なメッセージの最大数。デフォルトは 1 です。メッセージ駆動型 Beans 用のプールにのみ適用されます。 |
numbeansinpool |
RangeStatistic |
関連付けられたプール内の EJB 数。プールの変化に関する情報を提供します。 |
numthreadswaiting |
RangeStatistic |
未使用 Beans を取得するために待機しているスレッドの数。これは、要求が過剰である可能性を示します。 |
totalbeanscreated |
CountStatistic |
関連付けられたプール内でデータ収集開始後に作成された Beans の数。 |
totalbeansdestroyed |
CountStatistic |
関連付けられたプール内でデータ収集開始後に破棄された Beans の数。 |
server.applications.appname.ejbmodulename.timers.ejbname.statistic表 8–9 タイマーの監視統計
Statistic |
データ型 |
説明 |
---|---|---|
numtimerscreated |
CountStatistic |
システム内で作成されたタイマーの数。 |
numtimersdelivered |
CountStatistic |
システムによって配信されたタイマーの数。 |
numtimersremoved |
CountStatistic |
システムから削除されたタイマーの数。 |
HTTP サービスは、「HTTP サービスのツリー階層」に示したオブジェクトツリー内に含まれます。
HTTP サービスの統計を、次の節で説明します。
HTTP サービス仮想サーバーの統計では、次のドット表記名パターンを使用します。
server.http-service.virtual-server.request.statistic
仮想サーバーに関する HTTP サービスの統計を、次の表に示します。
表 8–10 HTTP サービス仮想サーバーの監視統計
Statistic |
データ型 |
説明 |
---|---|---|
count200 |
CountStatistic |
状態コードが 200 である応答の数。 |
count2xx |
CountStatistic |
状態コードが 2xx の範囲内にある応答の数。 |
count302 |
CountStatistic |
状態コードが 302 である応答の数。 |
count304 |
CountStatistic |
状態コードが 304 である応答の数。 |
count3xx |
CountStatistic |
状態コードが 3xx の範囲内にある応答の数。 |
count400 |
CountStatistic |
状態コードが 400 である応答の数。 |
count401 |
CountStatistic |
状態コードが 401 である応答の数。 |
count403 |
CountStatistic |
状態コードが 403 である応答の数。 |
count404 |
CountStatistic |
状態コードが 404 である応答の数。 |
count4xx |
CountStatistic |
状態コードが 4xx の範囲内にある応答の数。 |
count503 |
CountStatistic |
状態コードが 503 である応答の数。 |
count5xx |
CountStatistic |
状態コードが 5xx の範囲内にある応答の数。 |
countother |
CountStatistic |
状態コードが 2xx、3xx、4xx、および 5xx の範囲外である応答の数。 |
errorcount |
CountStatistic |
エラー回数の累計値。エラー回数は、応答コードが 400 以上になった場合の回数を表します。 |
hosts |
StringStatistic |
仮想サーバーのホスト (エイリアス) 名。 |
maxtime |
CountStatistic |
要求あたりの最長応答時間です。累積値ではなく、応答時間の中で最大の値です。 |
processingtime |
CountStatistic |
各要求の処理にかかった時間の累積値。処理時間は、要求数全体での要求処理時間の平均値になります。 |
requestcount |
CountStatistic |
現時点までに処理された要求の累積数。 |
state |
StringStatistic |
仮想サーバーの状態 |
Jersey は、「アプリケーションのツリー階層」に示したオブジェクトツリー内に含まれます。
Jersey の統計では、次のドット表記名パターンを使用します。
server.applications.jersey-application.jersey.resources.resource-0.hitcount.statistic表 8–11 Jersey の統計
Statistic |
データ型 |
説明 |
---|---|---|
resourcehitcount |
CountStatistic |
このリソースクラスでのヒット数。 |
rootresourcehitcount |
CountStatistic |
このルートリソースクラスでのヒット数。 |
JMS サービスとコネクタサービスは、「JMS およびコンテナサービスのツリー階層」に示したオブジェクトツリー内に含まれます。
JMS サービスとコネクタサービスの統計を、次の節で説明します。
JMS サービスとコネクタサービスの接続プールの統計では、次のドット表記名パターンを使用します。
server.connector-service.resource-adapter-1.connection-pool.statistic
コネクタ接続プールに関して利用可能な JMS サービスとコネクタサービスの統計を、次の表に示します。
表 8–12 コネクタ接続プールの監視統計 (JMS)
Statistic |
データ型 |
説明 |
---|---|---|
averageconnwaittime |
CountStatistic |
接続プールからサービスを受けるまでにかかった平均接続待ち時間。 |
connectionrequestwaittime |
RangeStatistic |
接続要求の最長待ち時間と最短待ち時間。現在の値は、プールのサービスを最後に受けた要求の待ち時間を示します。 |
numconnfailedvalidation |
CountStatistic |
開始時刻から前回のサンプリング時刻までの間に検証に失敗した接続プール内の接続の合計数。 |
numconnused |
RangeStatistic |
現在使用されている合計接続数に加え、過去に使用された接続の最大数 (ハイウォーターマーク) に関する情報も提供します。 |
numconnfree |
RangeStatistic |
前回のサンプリング時点におけるプール内の未使用接続の合計数。 |
numconntimedout |
CountStatistic |
開始時刻から前回のサンプリング時刻までの間にタイムアウトしたプール内の接続の合計数。 |
numconncreated |
CountStatistic |
前回のリセット後に作成された物理接続の数。 |
numconndestroyed |
CountStatistic |
前回のリセット後に破棄された物理接続の数。 |
numconnacquired |
CountStatistic |
プールから取得された論理接続の数。 |
numconnreleased |
CountStatistic |
プールに解放された論理接続の数。 |
waitqueuelenght |
CountStatistic |
サービスを受けるためにキュー内で待機している接続要求の数。 |
JMS サービスとコネクタサービスの作業管理の統計では、次のドット表記名パターンを使用します。
server.connector-service.resource-adapter-1.work-management.statistic
コネクタ作業管理に関して利用可能な JMS サービスとコネクタサービスの統計を、次の表に示します。
表 8–13 コネクタ作業管理の監視統計 (JMS)
Statistic |
データ型 |
説明 |
---|---|---|
activeworkcount |
RangeStatistic |
コネクタによって実行された作業オブジェクトの数。 |
completedworkcount |
CountStatistic |
完了した作業オブジェクトの数。 |
rejectedworkcount |
CountStatistic |
Enterprise Server によって拒否された作業オブジェクトの数。 |
submittedworkcount |
CountStatistic |
コネクタモジュールによって送信された作業オブジェクトの数。 |
waitqueuelength |
RangeStatistic |
実行される前にキュー内で待機している作業オブジェクトの数。 |
workrequestwaittime |
RangeStatistic |
作業オブジェクトが実行されるまでの最長待ち時間と最短待ち時間。 |
JRuby は、「JRuby のツリー階層」に示したオブジェクトツリー内に含まれます。
JRuby に関して利用可能な統計を、次の節で説明します。
JRuby コンテナの統計では、次のドット表記名パターンを使用します。
server.containers.jruby.applications.jruby-application.statistic
JRuby コンテナに関して利用可能な統計を、次の表に示します。
表 8–14 JRuby コンテナの統計
Statistic |
データ型 |
説明 |
---|---|---|
environment |
StringStatistic |
JRuby アプリケーション環境。 |
appname |
StringStatistic |
Ruby アプリケーション名。 |
contextpath |
StringStatistic |
Ruby アプリケーションのコンテキストパス。 |
jrubyversion |
StringStatistic |
JRuby のバージョン。 |
rubyframework |
StringStatistic |
Ruby アプリケーションフレームワーク。 |
JRuby ランタイムの統計では、次のドット表記名パターンを使用します。
server.containers.jruby.applications.jruby-application.runtime.statistic
JRuby ランタイムに関して利用可能な統計を、次の表に示します。
表 8–15 JRuby ランタイムの統計
Statistic |
データ型 |
説明 |
---|---|---|
activeruntimes |
CountStatistic |
現在アクティブなランタイムの数。 |
appname |
StringStatistic |
Ruby アプリケーション名。 |
hardmaximum |
CountStatistic |
アクティブなランタイムの最大数。 |
hardminimum |
CountStatistic |
アクティブなランタイムの最小数。 |
JRuby HTTP サービスの統計では、次のドット表記名パターンを使用します。
server.containers.jruby.applications.jruby-application.http.statistic
JRuby HTTP サービスに関して利用可能な統計を、次の表に示します。
表 8–16 JRuby HTTP サービスの統計
Statistic |
データ型 |
説明 |
---|---|---|
address |
StringStatistic |
サーバーアドレス。 |
appname |
StringStatistic |
Ruby アプリケーション名。 |
averageprocessingtime |
CountStatistic |
平均要求処理時間 (ミリ秒)。 |
contextpath |
StringStatistic |
Ruby アプリケーションのコンテキストパス。 |
count2xx |
CountStatistic |
状態コードが 2xx の範囲内にある応答の数。 |
count200 |
CountStatistic |
状態コードが 200 である応答の数。 |
count3xx |
CountStatistic |
状態コードが 3xx の範囲内にある応答の数。 |
count302 |
CountStatistic |
状態コードが 302 である応答の数。 |
Count304 |
CountStatistic |
状態コードが 304 である応答の数。 |
count4xx |
CountStatistic |
状態コードが 4xx の範囲内にある応答の数。 |
count400 |
CountStatistic |
状態コードが 400 である応答の数。 |
count401 |
CountStatistic |
状態コードが 401 である応答の数。 |
count403 |
CountStatistic |
状態コードが 403 である応答の数。 |
count404 |
CountStatistic |
状態コードが 404 である応答の数。 |
count5xx |
CountStatistic |
状態コードが 5xx の範囲内にある応答の数。 |
count503 |
CountStatistic |
状態コードが 503 である応答の数。 |
countother |
CountStatistic |
状態コードがその他の値である応答の数。 |
errorcount |
CountStatistic |
状態コードが 400 より大きい応答の数。 |
requests/seconds |
CountStatistic |
1 秒あたりの要求数。 |
JVM は、「JVM のツリー階層」に示したオブジェクトツリー内に含まれます。
Java プラットフォームの仮想マシン (JavaTM 仮想マシン、または JVM マシン) に関して利用可能な統計を、次の節で説明します。
JVM クラス読み込みシステムの統計では、次のドット表記名パターンを使用します。
server.jvm.class-loading-system.statistic
Java SE では、JVM から追加の監視情報を取得できます。監視レベルを「低」に設定すると、この追加情報の表示が有効になります。監視レベルを「高」に設定すると、さらにシステム内の各ライブスレッドに関する情報も表示されます。Java SE で利用可能な追加監視機能の詳細は、『Monitoring and Management for the Java Platform』を参照してください。この文書は、http://java.sun.com/javase/6/docs/technotes/guides/management/ で入手できます。
Java SE 監視ツールについては、http://java.sun.com/javase/6/docs/technotes/tools/#manage を参照してください。
Java SE の JVM で利用可能なクラス読み込み関連の統計を、次の表に示します。
表 8–17 Java SE のクラス読み込みに関する JVM の監視統計
Statistic |
データ型 |
説明 |
---|---|---|
loadedclasscount |
CountStatistic |
JVM 内に現在読み込まれているクラスの数。 |
totalloadedclasscount |
CountStatistic |
JVM の実行開始後に読み込まれたクラスの合計数。 |
unloadedclasscount |
CountStatistic |
JVM の実行開始後に JVM から読み込み解除されたクラスの数。 |
Java SE の JVM で利用可能なスレッド関連の統計を、次の図に示します。
表 8–18 Java SE に関する JVM の監視統計 - スレッド
Statistic |
データ型 |
説明 |
---|---|---|
allthreadids |
StringStatistic |
すべてのライブスレッド ID のリスト。 |
currentthreadcputime |
CountStatistic |
CPU 時間の測定が有効になっている場合は、現在のスレッドに対する CPU 時間 (ナノ秒)。CPU 時間の測定が無効になっている場合は、-1 が返されます。 |
daemonthreadcount |
CountStatistic |
ライブデーモンスレッドの現在の数。 |
monitordeadlockedthreads |
StringStatistic |
監視デッドロックが発生しているスレッド ID のリスト。 |
peakthreadcount |
CountStatistic |
JVM 起動後またはピーク値リセット後におけるライブスレッドのピーク数。 |
threadcount |
CountStatistic |
ライブデーモンスレッドと非デーモンスレッドの現在の数。 |
totalstartedthreadcount |
CountStatistic |
JVM が起動されて以来、作成されたスレッド、起動されたスレッド、作成および起動されたスレッドの合計数。 |
JVM コンパイルシステムの統計では、次のドット表記名パターンを使用します。
server.jvm.compilation-system.statistic
Java SE の JVM のコンパイルに関して利用可能な統計を、次の表に示します。
表 8–19 Java SE のコンパイルに関する JVM の監視統計
Statistic |
データ型 |
説明 |
---|---|---|
name-current |
StringStatistic |
現在のコンパイラの名前。 |
totalcompilationtime |
CountStatistic |
コンパイルに費やされた時間の累計 (ミリ秒)。 |
JVM ガベージコレクタの統計では、次のドット表記名パターンを使用します。
server.jvm.garbage-collectors.statistic
Java SE の JVM のガベージコレクションに関して利用可能な統計を、次の表に示します。
表 8–20 Java SE のガベージコレクタに関する JVM の監視統計
Statistic |
データ型 |
説明 |
---|---|---|
collectioncount |
CountStatistic |
実行されたコレクションの合計回数。 |
collectiontime |
CountStatistic |
コレクションに費やされた時間の累計 (ミリ秒)。 |
JVM メモリーの統計では、次のドット表記名パターンを使用します。
server.jvm.memory.statistic
Java SE の JVM のメモリーに関して利用可能な統計を、次の表に示します。
表 8–21 Java SE のメモリーに関する JVM の監視統計
Statistic |
データ型 |
説明 |
---|---|---|
committedheapsize |
CountStatistic |
JVM 用としてコミットされたヒープメモリーのサイズ (バイト)。 |
committednonheapsize |
CountStatistic |
JVM 用としてコミットされた非ヒープメモリーのサイズ (バイト)。 |
initheapsize |
CountStatistic |
JVM が最初に要求したヒープのサイズ。 |
initnonheapsize |
CountStatistic |
JVM が最初に要求した非ヒープ領域のサイズ |
maxheapsize |
CountStatistic |
メモリー管理用として使用可能なヒープメモリーの最大サイズ (バイト)。 |
maxnonheapsize |
CountStatistic |
メモリー管理用として使用可能な非ヒープメモリーの最大サイズ (バイト)。 |
objectpendingfinalizationcount |
CountStatistic |
ファイナライズを保留しているオブジェクトの概算数。 |
usedheapsize |
CountStatistic |
現在使用されているヒープのサイズ。 |
usednonheapsize |
CountStatistic |
現在使用されている非ヒープ領域のサイズ。 |
JVM オペレーティングシステムの統計では、次のドット表記名パターンを使用します。
server.jvm.operating-system.statistic
Java SE の JVM マシンのオペレーティングシステムに関して利用可能な統計を、次の表に示します。
表 8–22 Java SE のオペレーティングシステムに関する JVM の統計
Statistic |
データ型 |
説明 |
---|---|---|
arch-current |
StringStatistic |
オペレーティングシステムのアーキテクチャー。 |
availableprocessors |
CountStatistic |
JVM が使用できるプロセッサの数。 |
name-current |
StringStatistic |
オペレーティングシステムの名前。 |
version-current |
StringStatistic |
オペレーティングシステムのバージョン。 |
JVM ランタイムの統計では、次のドット表記名パターンを使用します。
server.jvm.runtime.statistic
Java SE の JVM ランタイムに関して利用可能な統計を、次の表に示します。
表 8–23 Java SE のランタイムに関する JVM の監視統計
Statistic |
データ型 |
説明 |
---|---|---|
classpath-current |
StringStatistic |
システムクラスローダーがクラスファイルの検索時に使用するクラスパス。 |
inputarguments-current |
StringStatistic |
JVM に渡される入力引数 (main メソッドへの引数は含まない)。 |
managementspecversion-current |
StringStatistic |
JVM で実装される管理仕様のバージョン。 |
name-current |
StringStatistic |
実行中の JVM を表す名前 |
specname-current |
StringStatistic |
JVM 仕様の名前。 |
specvendor-current |
StringStatistic |
JVM 仕様のベンダー。 |
specversion-current |
StringStatistic |
JVM 仕様のバージョン。 |
uptime |
CountStatistic |
JVM の稼働時間 (ミリ秒)。 |
vmname-current |
StringStatistic |
JVM 実装の名前。 |
vmvendor-current |
StringStatistic |
JVM 実装のベンダー。 |
vmversion-current |
StringStatistic |
JVM 実装のバージョン。 |
ネットワークは、「ネットワークのツリー階層」に示したオブジェクトツリー内に含まれます。
ネットワークの統計を、次の節で説明します。
ネットワークキープアライブの統計では、次のドット表記名パターンを使用します。
server.network.type-of-listener.keep-alive.statistic
ネットワークキープアライブに関して利用可能な統計を、次の表に示します。
表 8–24 ネットワークキープアライブの統計
Statistic |
データ型 |
説明 |
---|---|---|
countconnections |
CountStatistic |
キープアライブモードの接続の数。 |
counttimeouts |
CountStatistic |
タイムアウトしたキープアライブ接続の数。 |
secondstimeouts |
CountStatistic |
キープアライブのタイムアウト値 (秒)。 |
maxrequests |
CountStatistic |
1 つのキープアライブ接続で許可されている要求の最大数。 |
countflushes |
CountStatistic |
閉じられたキープアライブ接続の数。 |
counthits |
CountStatistic |
キープアライブモードの接続で受信した要求の数。 |
countrefusals |
CountStatistic |
拒否されたキープアライブ接続の数。 |
ネットワーク接続キューの統計では、次のドット表記名パターンを使用します。
server.network.type-of-listener.connection-queue.statistic
ネットワーク接続キューに関して利用可能な統計を、次の表に示します。
表 8–25 ネットワーク接続キューの統計
Statistic |
データ型 |
説明 |
---|---|---|
countopenconnections |
CountStatistic |
開いている接続またはアクティブな接続の数。 |
countoverflows |
CountStatistic |
キューがいっぱいになったために接続を格納できなかった回数。 |
countqueued |
CountStatistic |
キュー内に現在存在している接続の数。 |
countqueued15minutesaverage |
CountStatistic |
キューに格納されている接続数の過去 15 分間における平均値。 |
countqueued1minuteaverage |
CountStatistic |
キューに格納されている接続数の過去 1 分間における平均値。 |
countqueued5minutesaverage |
CountStatistic |
キューに格納されている接続数の過去 5 分間における平均値。 |
counttotalconnections |
CountStatistic |
受け付けられた接続の合計数。 |
counttotalqueued |
CountStatistic |
キューに格納された接続の合計数。 |
maxqueued |
CountStatistic |
接続キューの最大サイズ。 |
peakqueued |
CountStatistic |
キュー内に同時に存在していた接続の最大数。 |
tickstotalqueued |
CountStatistic |
接続がキュー内で費やした合計ティック数 (未サポート)。 |
ネットワークファイルキャッシュの統計では、次のドット表記名パターンを使用します。
server.network.type-of-listener.file-cache.statistic
ネットワークファイルキャッシュに関して利用可能な統計を、次の表に示します。
表 8–26 ネットワークファイルキャッシュの統計
Statistic |
データ型 |
説明 |
---|---|---|
contenthits |
CountStatistic |
キャッシュファイルコンテンツのヒット数。 |
contentmisses |
CountStatistic |
キャッシュファイルコンテンツの失敗数。 |
heapsize |
CountStatistic |
現在のキャッシュサイズ (バイト)。 |
hits |
CountStatistic |
キャッシュ検索のヒット数。 |
infohits |
CountStatistic |
キャッシュファイル情報のヒット数。 |
infomisses |
CountStatistic |
キャッシュファイル情報の失敗数。 |
mappedmemorysize |
CountStatistic |
キャッシュ用に割り当てられたメモリーのサイズ (バイト)。 |
maxheapsize |
CountStatistic |
キャッシュ用のヒープ領域の最大サイズ (バイト)。 |
maxmappedmemorysize |
CountStatistic |
キャッシュ用の最大メモリーマップサイズ (バイト)。 |
misses |
CountStatistic |
キャッシュ検索に失敗したデータタイプの数。 |
opencacheentries |
CountStatistic |
現在開いているキャッシュエントリの数。 |
ネットワークスレッドプールの統計では、次のドット表記名パターンを使用します。
server.network.type-of-listener.thread-pool.statistic
ネットワークスレッドプールに関して利用可能な統計を、次の表に示します。
表 8–27 ネットワークスレッドプールの統計
Statistic |
データ型 |
説明 |
---|---|---|
corethreads |
CountStatistic |
スレッドプールに含まれるスレッドのコア数。 |
currentthreadcount |
CountStatistic |
リスナースレッドプール内に現在存在している要求処理スレッドの数。 |
currentthreadsbusy |
CountStatistic |
要求処理用リスナースレッドプール内で現在使用されている要求処理スレッドの数。 |
maxthreads |
CountStatistic |
スレッドプールで許可されているスレッドの最大数。 |
totalexecutedtasks |
CountStatistic |
スレッドプールで実行されたタスクの合計数。 |
ORB は、「ORB のツリー階層」に示したオブジェクトツリー内に含まれます。
ORB の統計では、次のドット表記名パターンを使用します。
server.orb.transport.connectioncache.inbound.statistic server.orb.transport.connectioncache.outbound.statistic
ORB の接続マネージャーに関して利用可能な統計を、次の表に示します。
表 8–28 ORB の監視統計 (接続マネージャー)
Statistic |
データ型 |
説明 |
---|---|---|
connectionsidle |
CountStatistic |
ORB への接続のうち、アイドル状態の接続の合計数。 |
connectionsinuse |
CountStatistic |
ORB への接続のうち、使用中の接続の合計数。 |
totalconnections |
BoundedRangeStatistic |
ORB への接続の合計数。 |
接続プールリソースを監視することで、実行時にパフォーマンスの測定やリソースの使用状況の取得を行えます。接続は負荷が大きく、アプリケーションでは頻繁にパフォーマンスのボトルネックとなります。接続プールの解放状況と新しい接続の作成状況、および特定のプールから接続を取得するために待機中であるスレッドの数を監視することが重要です。
接続プールリソースは、「リソースのツリー階層」に示したオブジェクトツリー内に含まれます。
接続プールの統計では、次のドット表記名パターンを使用します。
server.resources.connection-pool.statistic
接続プールの統計を、次の表に示します。
表 8–29 リソースの監視統計 (接続プール)
Statistic |
データ型 |
説明 |
---|---|---|
averageconnwaittime |
CountStatistic |
成功した接続要求あたりの平均待ち時間。 |
connrequestwaittime |
RangeStatistic |
前回のサンプリング以降の、接続要求の最長待ち時間と最短待ち時間 (ミリ秒)。現在の値は、プールで処理された直前の要求の待ち時間を示します。 |
numconnfailedvalidation |
CountStatistic |
開始時刻から前回のサンプリング時刻までの間に検証に失敗した接続プール内の接続数。 |
numconnused |
RangeStatistic |
現在使用されている接続数と、過去に使用された接続の最大数 (ハイウォーターマーク) に関する情報。 |
numconnfree |
RangeStatistic |
前回のサンプリング時点におけるプール内の未使用の接続の数。 |
numconntimedout |
CountStatistic |
開始時刻から前回のサンプリング時刻までの間にタイムアウトしたプール内の接続の数。 |
numconncreated |
CountStatistic |
前回のリセット後にプールによって作成された物理接続の数。 |
numconndestroyed |
CountStatistic |
前回のリセット後に破棄された物理接続の数。 |
numconnacquired |
CountStatistic |
前回のサンプリング以降に、プールから取得された論理接続の数。 |
numconnreleased |
CountStatistic |
前回のサンプリング以降に、プールに戻された接続の数。 |
numconnnotsuccessfullymatched |
CountStatistic |
マッチング中に拒否された接続の数。 |
numconnsuccessfullymatched |
CountStatistic |
マッチングに成功した接続の数。 |
numpotentialconnleak |
CountStatistic |
潜在的な接続リークの数。 |
waitqueuelength |
CountStatistic |
キュー内で処理されるのを待機している接続要求の数。 |
セキュリティーは、「セキュリティーのツリー階層」に示したオブジェクトツリー内に含まれます。
セキュリティーに関して利用可能な統計を、次の節で説明します。
EJB セキュリティーの統計では、次のドット表記名パターンを使用します。
server.security.ejb.statistic
EJB セキュリティーに関して利用可能な統計を、次の表に示します。
表 8–30 EJB セキュリティーの監視統計
Statistic |
データ型 |
説明 |
---|---|---|
policyconfigurationcount |
CountStatistic |
ポリシー構成の数。 |
securitymanagercount |
CountStatistic |
EJB セキュリティーマネージャーの数。 |
Web セキュリティーの統計では、次のドット表記名パターンを使用します。
server.security.web.statistic
Web セキュリティーに関して利用可能な統計を、次の表に示します。
表 8–31 Web セキュリティーの監視統計
Statistic |
データ型 |
説明 |
---|---|---|
websecuritymanagercount |
CountStatistic |
セキュリティーマネージャーの数。 |
webpolicyconfigurationcount |
CountStatistic |
ポリシー構成オブジェクトの数。 |
レルムセキュリティーの統計では、次のドット表記名パターンを使用します。
server.security.realm.statistic
レルムセキュリティーに関して利用可能な統計を、次の表に示します。
表 8–32 レルムセキュリティーの監視統計
Statistic |
データ型 |
説明 |
---|---|---|
realmcount |
CountStatistic |
レルムの数。 |
スレッドプールは、「スレッドプールのツリー階層」に示したオブジェクトツリー内に含まれます。
スレッドプールに関して利用可能な統計を、次の節で説明します。
スレッドプールの統計では、次のドット表記名パターンを使用します。
server.thread-pool.thread-pool.statistic
スレッドプールに関して利用可能な統計を、次の表に示します。
表 8–33 スレッドプールの監視統計
Statistic |
データ型 |
説明 |
---|---|---|
averagetimeinqueue |
BoundedRangeStatistic |
キュー内の要求が処理されるまでの平均待ち時間 (ミリ秒)。 |
averageworkcompletiontime |
BoundedRangeStatistic |
割り当てが完了するまでの平均時間 (ミリ秒)。 |
currentbusythreads |
CountStatistic |
ビジースレッドの数。 |
currentnumberofthreads |
BoundedRangeStatistic |
要求処理スレッドの現在の数。 |
numberofavailablethreads |
CountStatistic |
使用可能なスレッドの数。 |
numberofworkitemsinqueue |
BoundedRangeStatistic |
キューで待機している作業項目の現在の数。 |
totalworkitemsadded |
CountStatistic |
前回のサンプリング以降に、作業キューに追加された作業項目の合計。 |
Java SE の JVM で利用可能な ThreadInfo 関連の統計を、次の図に示します。
表 8–34 Java SE に関する JVM の監視統計 - スレッド情報
Statistic |
データ型 |
説明 |
---|---|---|
blockedcount |
CountStatistic |
このスレッドが BLOCKED 状態に入った合計回数。 |
blockedtime |
CountStatistic |
このスレッドが BLOCKED 状態に入ったあと経過した時間 (ミリ秒)。スレッド競合監視が無効になっている場合は、-1 が返されます。 |
lockname |
StringStatistic |
このスレッドが獲得をブロックされている監視ロック、またはこのスレッドが Object.wait メソッド経由で通知されるのを待っている監視ロックの文字列表現。 |
lockownerid |
CountStatistic |
このスレッドのブロック対象オブジェクトの監視ロックを保持しているスレッドの ID。 |
lockownername |
StringStatistic |
このスレッドのブロック対象オブジェクトの監視ロックを保持しているスレッドの名前。 |
stacktrace |
StringStatistic |
このスレッドに関連付けられているスタックトレース。 |
threadid |
CountStatistic |
スレッドの ID。 |
threadname |
StringStatistic |
スレッドの名前 |
threadstate |
StringStatistic |
スレッドの状態。 |
waitedtime |
CountStatistic |
スレッドが WAITING 状態に入ったあと経過した時間 (ミリ秒)。スレッド競合監視が無効になっている場合は、-1 が返されます。 |
waitedcount |
CountStatistic |
スレッドが WAITING 状態または TIMED_WAITING 状態になった合計回数。 |
トランザクションサービスを使用すると、クライアントはトランザクションサブシステムをフリーズして、トランザクションをロールバックしたり、フリーズ時点で処理中であったトランザクションを特定することができます。トランザクションサービスは、「トランザクションサービスのツリー階層」に示したオブジェクトツリー内に含まれます。
トランザクションサービスの統計では、次のドット表記名パターンを使用します。
server.transaction-service.statistic
トランザクションサービスに関して利用可能な統計を、次の表に示します。
表 8–35 トランザクションサービスの監視統計
Statistic |
データ型 |
説明 |
---|---|---|
activecount |
CountStatistic |
現在アクティブなトランザクションの数。 |
activeids |
StringStatistic |
現在アクティブなトランザクションの ID。それらの各トランザクションは、トランザクションサービスのフリーズ後にロールバックすることができます。 |
committedcount |
CountStatistic |
コミットされたトランザクションの数。 |
rolledbackcount |
CountStatistic |
ロールバックされたトランザクションの数。 |
state |
StringStatistic |
トランザクションがフリーズされたかどうかを示します。 |
Web モジュールは、「Web のツリー階層」に示したオブジェクトツリー内に含まれます。
Web モジュールサーブレットの統計では、次のドット表記名パターンを使用します。
server.applications.web-module.virtual-server.servlet.statistic server.applications.application.web-module.virtual-server.servlet.statistic
利用可能な Web モジュールサーブレットの統計を、次の表に示します。
表 8–36 Web モジュールサーブレットの統計
Statistic |
データ型 |
説明 |
---|---|---|
errorcount |
CountStatistic |
応答コードが 400 以上になった場合の累計件数。 |
maxtime |
CountStatistic |
Web コンテナの要求待ち状態の最大継続時間。 |
processingtime |
CountStatistic |
各要求の処理に要した時間の累計値。この処理時間は、要求処理時間を要求数で割って得られた平均値です。 |
requestcount |
CountStatistic |
その時点までに処理された要求の合計数。 |
servicetime |
CountStatistic |
応答時間の総計 (ミリ秒)。 |
Web JSP の統計では、次のドット表記名パターンを使用します。
server.applications.web-module.virtual-server.statistic server.applications.application.web-module.virtual-server.statistic
利用可能な Web JSP 統計を、次の表に示します。
表 8–37 Web JSP の監視統計
Statistic |
データ型 |
説明 |
---|---|---|
jspcount-current |
RangeStatistic |
アクティブな JSP ページの数。 |
jsperrorcount |
CountStatistic |
JSP ページの呼び出しでトリガーされたエラーの合計数。 |
jspreloadedcount |
CountStatistic |
再読み込みされた JSP ページの合計数。 |
totaljspcount |
CountStatistic |
これまでに読み込まれた JSP ページの合計数。 |
Web 要求の統計では、次のドット表記名パターンを使用します。
server.applications.web-module.virtual-server.statistic server.applications.application.web-module.virtual-server.statistic
利用可能な Web 要求統計を、次の表に示します。
表 8–38 Web 要求の監視統計
Statistic |
データ型 |
説明 |
---|---|---|
errorcount |
CountStatistic |
エラー回数の累計値。エラー回数は、応答コードが 400 以上になった場合の回数を表します。 |
maxtime |
CountStatistic |
要求あたりの最長応答時間です。累積値ではなく、応答時間の中で最大の値です。 |
processingtime |
CountStatistic |
平均要求処理時間 (ミリ秒)。 |
requestcount |
CountStatistic |
現時点までに処理された要求の累積数。 |
Web サーブレットの統計では、次のドット表記名パターンを使用します。
server.applications.web-module.virtual-server.statistic server.applications.application.web-module.virtual-server.statistic
利用可能な Web サーブレットの統計を、次の表に示します。
表 8–39 Web サーブレットの監視統計
Statistic |
データ型 |
説明 |
---|---|---|
activeservletsloadedcount |
RangeStatistic |
現在読み込まれているサーブレットの数。 |
servletprocessingtimes |
CountStatistic |
サーブレット処理時間の累積値 (ミリ秒)。 |
totalservletsloadedcount |
CountStatistic |
Web モジュールに読み込まれたサーブレットの累積数。 |
Web セッションの統計では、次のドット表記名パターンを使用します。
server.applications.web-module.virtual-server.statistic server.applications.application.web-module.virtual-server.statistic
利用可能な Web セッションの統計を、次の表に示します。
表 8–40 Web セッションの監視統計
Statistic |
データ型 |
説明 |
---|---|---|
activatedsessionstotal |
CountStatistic |
アクティブ化されたセッションの合計数。 |
activesessionscurrent |
RangeStatistic |
現在のアクティブセッションの数。 |
activesessionshigh |
CountStatistic |
現在のアクティブセッションの最大数。 |
expiredsessionstotal |
CountStatistic |
期限切れセッションの合計数。 |
passivatedsessionstotal |
CountStatistic |
パッシブ化されたセッションの合計数。 |
persistedsessionstotal |
CountStatistic |
持続化されたセッションの合計数。 |
rejectedsessionstotal |
CountStatistic |
拒否されたセッションの合計数。 |
sessionstotal |
CountStatistic |
作成されたセッションの合計数。 |
Java SE には、MBean Server に接続し、サーバーに登録されている MBean を表示するためのツールが用意されています。JConsole は一般的な JMX コネクタクライアントであり、標準 Java SE ディストリビューションの一部として利用できます。Enterprise Server で使用できるように JConsole を設定すると、Enterprise Server は JMX コネクタのサーバー側となり、JConsole は JMX コネクタのクライアント側となります。
Java SE 6 では、Platform MBean Server を含めること、および仮想マシンを設定するための管理対象 Bean (MBean) を含めることにより、仮想マシンの管理と監視を拡張します。
すべての MBean を表示するために、Enterprise Server にはシステム JMX コネクタサーバーという標準 JMX コネクタサーバーの構成が用意されています。Enterprise Server の起動時に、この JMX コネクタサーバーのインスタンスが起動します。規格に準拠する JMX コネクタクライアントはすべて、JMX コネクタサーバーを使用してサーバーに接続できます。
デフォルトでは、Enterprise Server はセキュリティー保護されていないシステム JMX コネクタサーバーを使用するように設定されています。この設定で問題がある場合は、JMX コネクタを削除できます。ただし、address を locahost に設定することにより、特定の IP アドレス (たとえば、ループバックアドレス) へのアクセスが制限される場合があります。
ドメインを起動します。
手順については、「ドメインの起動」を参照してください。
JDK_HOME /bin/jconsole の形式を使用して、JConsole を起動します。
次に例を示します。
/usr/java/bin/jconsole |
JConsole の「Connect to Agent」ウィンドウが表示されます。
「リモート」タブをクリックし、ホスト名とポート番号を入力します。
JConsole には常にリモートで接続してください。リモート以外で接続した場合は、MBean が自動的に読み込まれません。
「接続」をクリックします。
「Remote Process」テキストボックスに、JMX サービス URL を指定します。
次に例を示します。
service:jmx:rmi:///jndi/rmi://localhost:8686/jmxrmi |
JMX サービス URL は、サーバーによって起動時に発行され、次のような形式になります。
[#|2009-12-03T10:25:17.737-0800|INFO|glassfishv3.0| javax.enterprise.system.tools.admin.org.glassfish.server|_ThreadID=20; _ThreadName=Thread-26;|JMXStartupService: Started JMXConnector, JMXService URL = service:jmx:rmi://localhost:8686/jndi/rmi://localhost:8686/jmxrmi|#] |
ただし、ほとんどの場合は、簡単に host:port (192.168.1.150:8686 など) を入力するだけで十分です。長いサービス URL は必要ありません。
localhost の代わりに別のホスト名を指定することもできます。jmx-connector の構成が変更されている場合は、デフォルトのポート番号 (8686) が変更されている場合があります。
「接続」をクリックします。
JConsole ウィンドウの各種タブに、MBean、JVM 情報などが表示されます。監視に利用できる MBean のほとんどは、amx および java.lang ドメインにあります。
JConsole の詳細は、http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html を参照してください。