第 20 章 コンポーネントとサービスの監視

この章では、Communications Server の管理コンソールを使ってコンポーネントを監視する方法について説明します。この章で説明する内容は次のとおりです。

• 「監視について」

• 「監視の有効化と無効化」

• 「監視データの表示」

• 「JConsole の使用」

監視について

• 「Communications Server での監視」

• 「監視の概要」

• 「監視可能なオブジェクトのツリー構造について」

• 「監視対象のコンポーネントとサービスの統計について」

Communications Server での監視

監視機能を使用して Communications Server のサーバーインスタンスに配備されている各種コンポーネントおよびサービスの実行時状態を把握します。実行時コンポーネントとプロセスに関する情報を使用して、チューニングに関わるパフォーマンスボトルネックを識別し、処理能力を計画し、障害を見積もり、障害の場合の原因を分析して、期待どおりの機能性を確保できます。

監視をオンにすると、オーバーヘッドの増大によりパフォーマンスが低下します。

管理ルールを使用して、サーバーに関する潜在的な問題を通知することもできます。さらにオプションで、サーバーが一定のパフォーマンスしきい値に達したときに措置を講じることもできます。詳細については、第 21 章管理ルールの設定を参照してください。

監視の概要

Communications Server を監視するには、次の手順を実行します。

1. 管理コンソールまたは asadmin ツールを使用して、特定のサービスおよびコンポーネントの監視を有効にします。

   この手順の詳細については、「監視の有効化と無効化」を参照してください。

2. 管理コンソールまたは asadmin ツールを使用して、特定のサービスおよびコンポーネントの監視データを表示します。

   この手順の詳細については、「監視データの表示」を参照してください。

監視可能なオブジェクトのツリー構造について

Communications Server は、ツリー構造を使って監視可能なオブジェクトを追跡します。監視オブジェクトのツリーは動的であり、インスタンス内におけるコンポーネントの追加、更新、削除に応じて変更されます。ツリー内のルートオブジェクトは、server などのサーバーインスタンス名です。開発者プロファイルでは、1 つのサーバーインスタンスしか使用できません。

次のコマンドを実行すると、ツリーのトップレベルが表示されます。

asadmin> list --user adminuser --monitor server
server.applications
server.http-service
server.sip-service
server.connector-service
server.converged-load-balancer
server.jms-service
server.jvm
server.orb
server.resources
server.thread-pools

次の各節では、これらのサブツリーについて説明します。

• 「アプリケーションのツリー」

• 「SIP サービスのツリー」

• 「融合ロードバランサのツリー」

• 「HTTP サービスのツリー」

• 「リソースのツリー」

• 「コネクタサービスのツリー」

• 「JMS サービスのツリー」

• 「ORB のツリー」

• 「スレッドプールのツリー」

アプリケーションのツリー

次の図に、エンタープライズアプリケーションの各種コンポーネントのトップノードと子ノードを示します。監視統計が利用可能なノードには、アスタリスク (*) を付けています。詳細については、「EJB コンテナの統計」を参照してください。

例 20–1 アプリケーションノードのツリー構造

applications
   |--- application1
   |    |--- ejb-module-1
   |    |        |--- ejb1 *
   |    |                  |--- cache (for entity/sfsb) *
   |    |                  |--- pool (for slsb/mdb/entity) *
   |    |                  |--- methods
   |    |                       |---method1 *
   |    |                       |---method2 *
   |    |                  |--- stateful-session-store (for sfsb)*
   |    |                  |--- 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 *
   |    |                  |--- cache (for entity/sfsb) *
   |    |                  |--- pool (for slsb/mdb/entity) *
   |    |                  |--- methods
   |    |                       |--- method1 *
   |    |                       |--- method2 *
   |--- application2

SIP サービスのツリー

SIP サービスのノードを、次の図に示します。監視情報が利用可能なノードには、アスタリスク (*) を付けています。「SIP サービスの統計」を参照してください。

例 20–2 SIP サービスのツリー構造

sip-service
         |--- network-manager*
					|--request-received*
					|--request-sent*
					|--request-received*
					|--request-sent* 	 	
					|--sip-listener*
 			 |---overload-protection-manager*
			 |---session-manager*
			 |---transaction-manager*

融合ロードバランサのツリー

融合ロードバランサのノードを、次の図に示します。監視情報が利用可能なノードには、アスタリスク (*) を付けています。「融合ロードバランサの統計」を参照してください。

例 20–3 融合ロードバランサのツリー構造

converged-load-balancer
       

HTTP サービスのツリー

HTTP サービスのノードを、次の図に示します。監視情報が利用可能なノードには、アスタリスク (*) を付けています。「HTTP サービスの統計」を参照してください。

例 20–4 HTTP サービスの図 (開発者プロファイル版)

http-service
         |--- virtual-server-1
              |--- http-listener-1 *
              |--- http-listener-2 *
         |--- virtual-server-2
              |--- http-listener-1 *
              |--- http-listener-2 *

例 20–5 HTTP サービスの図 (クラスタおよびエンタープライズプロファイル版)

http-service *
             |---connection-queue *
             |---dns *
             |---file-cache *
             |---keep-alive *
             |---virtual-server-1*
             |        |--- request *
             |---virtual-server-2*
             |        |--- request *

リソースのツリー

リソースノードには、JDBC 接続プールやコネクタ接続プールなどのプールの監視可能な属性が格納されます。次の図に、各種リソースコンポーネントのトップノードと子ノードを示します。監視統計が利用可能なノードには、アスタリスク (*) を付けています。「JDBC 接続プールの統計」を参照してください。

例 20–6 リソースの図

resources
        |---connection-pool1(either connector-connection-pool or jdbc)*
        |---connection-pool2(either connector-connection-pool or jdbc)*

コネクタサービスのツリー

コネクタサービスノードには、コネクタ接続プールなどのプールの監視可能な属性が格納されます。次の図に、各種コネクタサービスコンポーネントのトップノードと子ノードを示します。監視統計が利用可能なノードには、アスタリスク (*) を付けています。「JMS サービスおよびコネクタサービスの統計」を参照してください。

例 20–7 コネクタサービスの図

connector-service
        |--- resource-adapter-1
        |        |-- connection-pools
        |        |        |-- pool-1 (All pool stats for this pool)
        |        |-- work-management (All work mgmt stats for this RA)

JMS サービスのツリー

JMS サービスノードには、コネクタ接続プールなどのプールの監視可能な属性が格納されます。次の図に、各種 JMS サービスコンポーネントのトップノードと子ノードを示します。監視統計が利用可能なノードには、アスタリスク (*) を付けています。

例 20–8 JMS サービスの図

jms-service
        |-- connection-factories [AKA conn. pools in the RA world]
        |        |-- connection-factory-1 (All CF stats for this CF)
        |-- work-management (All work mgmt stats for the MQ-RA)

ORB のツリー

ORB ノードには、接続マネージャーの監視可能な属性が格納されます。次の図に、各種 ORB コンポーネントのトップノードと子ノードを示します。監視統計が利用可能なノードには、アスタリスク (*) を付けています。「ORB の接続マネージャーの統計」を参照してください。

例 20–9 ORB の図

orb
        |--- connection-managers
        |        |--- connection-manager-1 *
        |        |--- connection-manager-1 *

スレッドプールのツリー

スレッドプールノードには、接続マネージャーの監視可能な属性が格納されます。次の図に、各種 ORB コンポーネントのトップノードと子ノードを示します。監視統計が利用可能なノードには、アスタリスク (*) を付けています。「スレッドプールの統計」を参照してください。

例 20–10 スレッドプールの図

thread-pools
        |    |--- thread-pool-1 *
        |    |--- thread-pool-2 *

監視対象のコンポーネントとサービスの統計について

この節では、利用可能な監視統計について説明します。

• 「SIP サービスの統計」

• 「融合ロードバランサの統計」

• 「EJB コンテナの統計」

• 「Web コンテナの統計」

• 「HTTP サービスの統計」

• 「JDBC 接続プールの統計」

• 「JMS サービスおよびコネクタサービスの統計」

• 「ORB の接続マネージャーの統計」

• 「スレッドプールの統計」

• 「トランザクションサービスの統計」

• 「Java 仮想マシン (JVM) の統計」

• 「Java SE の JVM 統計」

SIP サービスの統計

SIP サービスの統計を次の表に示します。

• 表 20–1

• 表 20–2

  ---

  注 –

  送信した要求で収集される統計は、表 20–2 に示す受信した要求の統計に似ています。統計は、ACK や BYE など、複数の SIP メッセージのタイプについて収集されます。

  ---

• 表 20–3

  ---

  注 –

  送信した応答で収集される統計は、表 20–3 に示す受信した応答の統計に似ています。統計は、1xx や 3xx など、複数の SIP メッセージのタイプについて収集されます。

  ---

• 表 20–4

• 表 20–5

• 表 20–6

融合ロードバランサの統計

EJB コンテナの統計

EJB コンテナの統計を次の表に示します。

• 表 20–9

• 表 20–10

• 表 20–11

• 表 20–12

• 表 20–13

EJB 統計を次の表に示します。

EJB メソッド呼び出しに関して利用可能な統計を、次の表に示します。

EJB プールに関して利用可能な統計を、次の表に示します。

EJB キャッシュに関して利用可能な統計を、次の表に示します。

タイマーに関して利用可能な統計を、次の表に示します。

Web コンテナの統計

Web コンテナは、「アプリケーションのツリー」に示したオブジェクトツリー内に含まれます。Web コンテナの統計は、個々の Web アプリケーションごとに表示されます。Web コンテナのサーブレットに関して利用可能な統計を表 20–14 に、Web モジュールに関して利用可能な統計を表 20–15 に示します。

Web モジュールに関して利用可能な統計を、「Web コンテナの統計」に示します。

HTTP サービスの統計

開発者プロファイルの HTTP サービスに関して利用可能な統計を、次の表に示します。

JDBC 接続プールの統計

JDBC リソースを監視することで、パフォーマンスを測定するとともに、実行時のリソースの使用状況を把握します。JDBC 接続の作成はコストのかかる処理であり、アプリケーションのパフォーマンス上のボトルネックになることが多いため、JDBC 接続プールで新しい接続がどのように解放/作成されているかや、特定のプールから接続を取得するために待機しているスレッドがどれくらい存在するかを監視することが不可欠です。

JDBC 接続プールに関して利用可能な統計を、次の表に示します。

JMS サービスおよびコネクタサービスの統計

コネクタ接続プールに関して利用可能な統計を、表 20–18 に示します。コネクタ作業管理に関する統計を、表 20–19 に示します。

コネクタ作業管理に関して利用可能な統計を、次の図に示します。

ORB の接続マネージャーの統計

ORB の接続マネージャーに関して利用可能な統計を、次の図に示します。

スレッドプールの統計

スレッドプールに関して利用可能な統計を、次の表に示します。

トランザクションサービスの統計

トランザクションサービスを使えば、クライアントはトランザクションサブシステムをフリーズできます。フリーズすると、トランザクションをロールバックしたり、フリーズ時点で処理中であったトランザクションを特定したりできます。トランザクションサービスに関して利用可能な統計を、次の表に示します。

Java 仮想マシン (JVM) の統計

JVM の監視可能な属性は、常に有効になっています。JVM に関して利用可能な統計を、次の表に示します。

Java SE の JVM 統計

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 で利用可能なクラス読み込み関連の統計を、次の図に示します。

Java SE の JVM で利用可能なコンパイル関連の統計を、次の図に示します。

Java SE の JVM で利用可能なガベージコレクション関連の統計を、次の図に示します。

Java SE の JVM で利用可能なメモリー関連の統計を、次の図に示します。

Java SE の JVM で利用可能なオペレーティングシステム関連の統計を、次の図に示します。

Java SE の JVM で利用可能なランタイム関連の統計を、次の図に示します。

Java SE の JVM で利用可能な ThreadInfo 関連の統計を、次の図に示します。

Java SE の JVM で利用可能なスレッド関連の統計を、次の図に示します。

監視の有効化と無効化

ここでは、次の内容について説明します。

• 「管理コンソールを使用した監視レベルの設定」

• 「asadmin を使用して監視レベルを設定する」

管理コンソールを使用した監視レベルの設定

管理コンソールを使用して監視を設定するには、次の手順に従います。

• 開発者プロファイルの場合は、「設定」->「監視」の順に選択します。

• クラスタおよびエンタープライズプロファイルの場合は、「設定」->「設定」->「監視」の順に選択します。

デフォルトでは、すべてのコンポーネントおよびサービスについて監視はオフになっています。監視をオンにするには、コンボボックスから「LOW」または「HIGH」を選択します。監視をオフにするには、コンボボックスから「OFF」を選択します。

監視の設定の詳細については、管理コンソールで利用可能なオンラインヘルプを参照してください。

asadmin を使用して監視レベルを設定する

1. get コマンドを使って監視が現在有効になっているサービスとコンポーネントを確認します。

   asadmin> get --user admin-user server.monitoring-service.module-monitoring-levels.*

   次の結果が返されます。

   server.monitoring-service.module-monitoring-levels. connector-connection-pool = OFF server.monitoring-service.module-monitoring-levels. connector-service = OFF server.monitoring-service.module-monitoring-levels.ejb-container = OFF server.monitoring-service.module-monitoring-levels.http-service = OFF server.monitoring-service.module-monitoring-levels.sip-service = OFF server.monitoring-service.module-monitoring-levels.jdbc-connection-pool = OFF server.monitoring-service.module-monitoring-levels.jms-service = OFF server.monitoring-service.module-monitoring-levels.jvm = OFF server.monitoring-service.module-monitoring-levels.orb = OFF server.monitoring-service.module-monitoring-levels.thread-pool = OFF server.monitoring-service.module-monitoring-levels.transaction-service = OFF server.monitoring-service.module-monitoring-levels.web-container = OFF

2. set コマンドを使って監視を有効にします。

   たとえば、HTTP サービスの監視を有効にするには、次のようにします。

   asadmin> set --user admin-user server.monitoring-service.module-monitoring-levels.http-service=LOW

   監視を無効にするには、set コマンドを使って監視レベルに OFF を指定します。

監視データの表示

• 「管理コンソールでの監視データの表示」

• 「asadmin ツールによる監視データの表示」

管理コンソールでの監視データの表示

開発者プロファイルの場合、監視データを表示するには、「Application Server」->「監視」の順に選択します。

クラスタおよびエンタープライズプロファイルの場合、スタンドアロンインスタンスの監視データを表示するには、「スタンドアロンインスタンス」->「インスタンス」->「監視」の順に選択します。クラスタ化されたインスタンスの監視データを表示するには、「クラスタ」->「クラスタ」->「インスタンス」->「監視」の順に選択します。

JVM、サーバー、アプリケーション、スレッドプール、SIP サービス、HTTP サービス、トランザクションサービス、ログ統計、および呼び出しフロー統計の監視データを選択して表示できます。「監視可能なオブジェクトのツリー構造について」を参照してください。

監視の表示または設定の詳細については、管理コンソールで利用可能なオンラインヘルプを参照してください。

各コンポーネントやサービスの属性の詳細については、「監視対象のコンポーネントとサービスの統計について」を参照してください。

asadmin ツールによる監視データの表示

ここでは、次の内容について説明します。

• 「asadmin monitor コマンドを使用して監視データを表示する」

• 「asadmin get および asadmin list コマンドを使用して監視データを表示する」

• 「ドット表記名とその指定方法について」

• 「list コマンドと get コマンドの例」

• 「list --user admin-user --monitor コマンドの例」

• 「get --user admin-user --monitor コマンドの例」

• 「PetStore サンプルを使用する」

• 「すべてのレベルにおける list コマンドと get コマンドの予想出力」

asadmin monitor コマンドを使用して監視データを表示する

asadmin で監視データを表示する方法は 2 とおりあります。最初の方法では、monitor コマンドを使用します。このコマンドは、一般的な監視統計を出力します。統計情報を絞り込むためのオプションと、出力をコンマ区切り (CSV) ファイルに取り込むためのオプションがあります。

1. 監視データを表示するには、monitor コマンドを使用して、監視データのタイプを指定します。監視データのタイプには、httplistener、siplistener、keepalive、filecache、connectionqueue、jdbcpool、jvm、threadpool、servlet、connection、connectorpool、endpoint、entitybean、messagedriven、statefulsession、statelesssession、httpservice、または webmodule があります。

   たとえば、server 上の jvm のデータを表示するには、次のように入力します。

   asadmin>monitor --type jvm --user adminuser server

   JVM Monitoring UpTime(ms) HeapSize(bytes) current min max low high count 327142979 0 531628032 0 45940736 45940736

2. 監視データを表示して CSV ファイルに出力を送信するには、filename オプションを使用します。次に例を示します。

   asadmin> monitor --type jvm --filename myoutputfile --user adminuser server

asadmin get および asadmin list コマンドを使用して監視データを表示する

ほとんどの状況で monitor コマンドを使用できます。ただし、monitor コマンドでは、監視可能なすべてのオブジェクトの完全なリストは表示できません。asadmin ツールを使用して監視可能なすべてのデータを表示するには、asadmin list および asadmin get コマンドに続けて監視可能なオブジェクトのドット表記名を使用します。手順を次に示します。

1. 監視可能なオブジェクトの名前を表示するには、asadmin list コマンドを使用します。

   たとえば、サーバーインスタンスで監視が有効なアプリケーションコンポーネントおよびサブシステムのリストを表示するには、次のコマンドを端末ウィンドウに入力します。

   asadmin> list --user adminuser --monitor server

   前述のコマンドは、監視が有効なアプリケーションコンポーネントおよびサブシステムの次のようなリストを返します。

   server.resources server.connector-service server.orb server.jms-service server.jvm server.applications server.http-service server.sip-service server.thread-pools

   list コマンドのその他の使用例については、「list コマンドと get コマンドの例」を参照してください。list コマンドで使用できるドット表記名の詳細については、「ドット表記名とその指定方法について」を参照してください。

2. 監視が有効なアプリケーションコンポーネントまたはサブシステムの監視統計を表示するには、asadmin get コマンドを使用します。

   統計を取得するには、asadmin get コマンドを端末ウィンドウに入力して、前述の手順の list コマンドで表示された名前を指定します。次の例では、特定のオブジェクトのサブシステムからすべての属性を取得します。

   asadmin> get --user adminuser --monitor server.jvm.*

   このコマンドは次の属性およびデータを返します。

   server.jvm.dotted-name = server.jvm server.jvm.heapsize-current = 21241856 server.jvm.heapsize-description = Provides statistical information about the JVM's memory heap size. server.jvm.heapsize-highwatermark = 21241856 server.jvm.heapsize-lastsampletime = 1080232913938 server.jvm.heapsize-lowerbound = 0 server.jvm.heapsize-lowwatermark = 0 server.jvm.heapsize-name = JvmHeapSize server.jvm.heapsize-starttime = 1080234457308 server.jvm.heapsize-unit = bytes server.jvm.heapsize-upperbound = 518979584 server.jvm.uptime-count = 1080234457308 server.jvm.uptime-description = Provides the amount of time the JVM has been running. server.jvm.uptime-lastsampletime = 1080234457308 server.jvm.uptime-name = JvmUpTime server.jvm.uptime-starttime = 1080232913928 server.jvm.uptime-unit = milliseconds

   get コマンドのその他の使用例については、「list コマンドと get コマンドの例」を参照してください。get コマンドで使用できるドット表記名の詳細については、「ドット表記名とその指定方法について」を参照してください。

ドット表記名とその指定方法について

asadmin list コマンドと asadmin get コマンドでは、監視可能オブジェクトのドット表記名を指定します。すべての子オブジェクトのアドレス指定にはドット (.) 文字が区切り文字として使用され、それらの名前は「ドット表記名」と呼ばれます。子ノードが単独タイプの場合、その監視オブジェクトタイプを指定するだけで、そのオブジェクトを指定できます。それ以外の場合は、type.name 形式の名前を指定する必要があります。

たとえば、http-service は、有効な監視可能オブジェクトタイプの 1 つであり、単独タイプです。インスタンス server の http-service を表す単独タイプの子ノードを指定する場合、ドット表記名は次のようになります。

server.http-service

もう 1 つ例を挙げます。applications は、有効な監視可能オブジェクトタイプですが、単独タイプではありません。たとえば、アプリケーション PetStore を表す、単独タイプでない子ノードを指定するには、ドット表記名は次のようになります。

server.applications.petstore

また、監視可能なオブジェクトの特定の属性も、ドット表記名で指定します。たとえば、http-service には、bytesreceived-lastsampletime という名前の監視可能な属性があります。次の名前は、bytesreceived 属性を指定していることになります。

server.http-service.server.http-listener-1.
  bytesreceived-lastsampletime

管理者は、asadmin list コマンドと asadmin get コマンドの有効なドット表記名を覚えておく必要はありません。list コマンドを使えば、利用可能な監視可能オブジェクトが表示され、ワイルドカードパラメータ付きの get コマンドを使えば、任意 の監視可能オブジェクトで利用可能なすべての属性を確認することができます。

list コマンドと get コマンドでドット表記名を使用する場合、根本的に次のことを前提としています。

• list コマンドでドット表記名の後にワイルドカード (*) が指定されていなかった場合、現在のノードの直接の子ノードが結果として返される。たとえば、list --user adminuser --monitor server を実行した場合、server ノードに属するすべての直接の子ノードが一覧表示される。

• list コマンドでドット表記名の後に .* 形式のワイルドカードが指定されていた場合、現在のノードの子ノード階層ツリーが結果として返される。たとえば、list --user adminuser --monitor server.applications.* を実行した場合、applications のすべての子ノードに加え、それらの配下にある子ノードなども一覧表示される。

• list コマンドで *dottedname、dotted * name、dotted name * のいずれかの形式でドット表記名の前後にのワイルドカードが指定されていた場合、そのマッチングパターンによって生成された正規表現にマッチするすべてのノードとそれらの子ノードが、結果として返される。

• get コマンドの末尾に「.*」、「*」のいずれかが指定されていた場合、マッチング対象の現在のノードに属する属性とその値のセットが、結果として返される。

詳細については、「すべてのレベルにおける list コマンドと get コマンドの予想出力」を参照してください。

list コマンドと get コマンドの例

ここでは、次の内容について説明します。

• 「list --user admin-user --monitor コマンドの例」

• 「get --user admin-user --monitor コマンドの例」

list --user admin-user --monitor コマンドの例

list コマンドは、指定されたサーバーインスタンス名で現在監視されているアプリケーションコンポーネントやサブシステムに関する情報を提供します。このコマンドを使えば、特定のサーバーインスタンスの監視可能なコンポーネントやそのサブコンポーネントを表示できます。list のより詳しい例については、「すべてのレベルにおける list コマンドと get コマンドの予想出力」を参照してください。

例 1

asadmin> list --user admin-user --monitor server

前述のコマンドは、監視が有効なアプリケーションコンポーネントおよびサブシステムの次のようなリストを返します。

server.resources
server.orb
server.jvm
server.jms-service
server.connector-service
server.applications
server.http-service
server.thread-pools

また、指定されたサーバーインスタンス内で現在監視されているアプリケーションを一覧表示することも可能です。これは、get コマンドを使って特定のアプリケーションの特定の監視統計を取得する場合に便利です。

例 2

asadmin> list --user admin-user --monitor server.applications

次の結果が返されます。

server.applications.adminapp
 server.applications.admingui
server.applications.myApp

より包括的な例については、「PetStore サンプルを使用する」を参照してください。

get --user admin-user --monitor コマンドの例

このコマンドは、次の監視対象情報を取得します。

• 特定のコンポーネントまたはサブシステム内で監視されているすべての属性

• 特定のコンポーネントまたはサブシステム内で監視されている特定の属性

  特定のコンポーネントまたはサブシステムに存在しない属性が要求された場合、エラーが返されます。同様に、特定のコンポーネントまたはサブシステムのアクティブでない属性が要求された場合も、エラーが返されます。

  get コマンドの使用方法の詳細については、「すべてのレベルにおける list コマンドと get コマンドの予想出力」を参照してください。

例 1

特定のオブジェクトのすべての属性をサブシステムから取得します。

asadmin> get --user admin-user --monitor server.jvm.*

次の結果が返されます。

server.jvm.dotted-name= server.jvm
server.jvm.heapsize-current = 21241856
server.jvm.heapsize-description = Provides statistical information about 
   the JVM's memory heap size.
server.jvm.heapsize-highwatermark = 21241856
server.jvm.heapsize-lastsampletime = 1080232913938
server.jvm.heapsize-lowerbound = 0
server.jvm.heapsize-lowwatermark = 0
server.jvm.heapsize-name = JvmHeapSize
server.jvm.heapsize-starttime = 1080234457308
server.jvm.heapsize-unit = bytes
server.jvm.heapsize-upperbound = 518979584
server.jvm.uptime-count = 1080234457308
server.jvm.uptime-description = Provides the amount of time the JVM has 
   been running.
server.jvm.uptime-lastsampletime = 1080234457308
server.jvm.uptime-name = JvmUpTime
server.jvm.uptime-starttime = 1080232913928
server.jvm.uptime-unit = milliseconds

例 2

特定の Java EE アプリケーションからすべての属性を取得します。

asadmin> get --user admin-user --monitor server.applications.myJavaEEApp.*

次の結果が返されます。

No matches resulted from the wildcard expression.
CLI137 Command get failed.

Java EE アプリケーションレベルで公開されている監視可能な属性が存在しないため、このような応答が表示されました。

例 3

特定のサブシステムから特定の属性を取得します。

asadmin> get --user admin-user --monitor server.jvm.uptime-lastsampletime

次の結果が返されます。

server.jvm.uptime-lastsampletime = 1093215374813

例 4

特定のサブシステム属性内から未知の属性を取得します。

asadmin> get --user admin-user --monitor server.jvm.badname

次の結果が返されます。

No such attribute found from reflecting the corresponding Stats 
interface: [badname]
CLI137 Command get failed.

PetStore サンプルを使用する

次の例は、asadmin ツールを監視目的でどのように使えばよいかを示したものです。

あるユーザーが、Communications Server 上に配備済みのサンプル Petstore アプリケーションに含まれる特定のメソッドの呼び出し回数を調査しようとしています。その配備先インスタンスの名前は、server です。list コマンドと get コマンドを併用することで、そのメソッドの目的の統計情報にアクセスします。

1. Communications Server と asadmin ツールを起動します。

2. いくつかの有用な環境変数を設定することで、それらの値をコマンドごとに入力しないですむようにします。

   asadmin> export AS_ADMIN_USER=admin AS_ADMIN_PASSWORD=admin123 asadmin>export AS_ADMIN_HOST=localhost AS_ADMIN_PORT=4848

3. インスタンス server の監視可能なコンポーネントを一覧表示します。

   asadmin> list --user adminuser --monitor server*

   次のような出力結果が返されます。

   server server.applications server.applications.CometEJB server.applications.ConverterApp server.applications.petstore server.http-service server.resources server.thread-pools

   この監視可能なコンポーネントの一覧には、thread-pools、http-service、resources、および配備済みで有効化されているすべての applicationsが含まれています。

4. PetStore アプリケーションの監視可能なサブコンポーネントを一覧表示します (--monitor の代わりに -m を使用可能)。

   asadmin> list -m server.applications.petstore

   次の結果が返されます。

   server.applications.petstore.signon-ejb_jar server.applications.petstore.catalog-ejb_jar server.applications.petstore.uidgen-ejb_jar server.applications.petstore.customer-ejb_jar server.applications.petstore.petstore-ejb_jar server.applications.petstore.petstore\.war server.applications.petstore.AsyncSenderJAR_jar server.applications.petstore.cart-ejb_jar

5. Petstore アプリケーションの EJB モジュール signon-ejb_jar の監視可能なサブコンポーネントを一覧表示します。

   asadmin> list -m server.applications.petstore.signon-ejb_jar

   次の結果が返されます。

   server.applications.petstore.signon-ejb_jar.SignOnEJB server.applications.petstore.signon-ejb_jar.UserEJB

6. Petstore アプリケーションの EJB モジュール signon-ejb_jar のエンティティー Bean UserEJB に含まれる監視可能なサブコンポーネントを一覧表示します。

   asadmin> list -m server.applications.petstore.signon-ejb_jar.UserEJB

   次の結果が返されます (ドット表記名はスペースの関係で削除してある)。

   server.applications.petstore.signon-ejb_jar.UserEJB.bean-cache server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods server.applications.petstore.signon-ejb_jar.UserEJB.bean-pool

7. PetStore アプリケーションの EJB モジュール signon-ejb_jar のエンティティー Bean UserEJB に含まれるメソッド getUserName 内の監視可能なサブコンポーネントを一覧表示します。

   asadmin> list -m server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods.getUserName

   次の結果が返されます。

   Nothing to list at server.applications.petstore.signon-ejb_jar. UserEJB.bean-methods.getUserName. To get the valid names beginning with a string, use the wildcard "*" character. For example, to list all names that begin with "server", use "list server*".

8. メソッドに対する監視可能なサブコンポーネントは存在しません。メソッド getUserName の監視可能なすべての統計を取得します。

   asadmin> get -m server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods.getUserName.*

   次の結果が返されます。

   server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.executiontime-count = 0 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.executiontime-description = Provides the time in milliseconds spent during the last successful/unsuccessful attempt to execute the operation. server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.executiontime-lastsampletime = 1079981809259 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.executiontime-name = ExecutionTime server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.executiontime-starttime = 1079980593137 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.executiontime-unit = count server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-count = 0 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-description = Provides the number of times an operation was called, the total time that was spent during the invocation and so on. server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-lastsampletime = 1079980593137 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-maxtime = 0 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-mintime = 0 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-name = ExecutionTime server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-starttime = 1079980593137 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-totaltime = 0 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-unit = server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumerrors-count = 0 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumerrors-description = Provides the total number of errors that occured during invocation or execution of an operation. server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumerrors-lastsampletime = 1079981809273 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumerrors-name = TotalNumErrors server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumerrors-starttime = 1079980593137 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumerrors-unit = count server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumsuccess-count = 0 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumsuccess-description = Provides the total number of successful invocations of the method. server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumsuccess-lastsampletime = 1079981809255 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumsuccess-name = TotalNumSuccess server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumsuccess-starttime = 1079980593137 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumsuccess-unit = count

9. また、実行回数など、特定の統計を取得するには、次のようなコマンドを使用します。

   asadmin> get -m server.applications.petstore.signon-ejb_jar. UserEJB.bean-methods.getUserName.executiontime-count

   次の結果が返されます。

   server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.executiontime-count = 1

すべてのレベルにおける list コマンドと get コマンドの予想出力

次の各表は、ツリーの各レベルにおけるコマンド、ドット表記名、および対応する出力を示したものです。

server.applicationsserver.thread-poolsserver.
resourcesserver.http-serviceserver.transaction-
serviceserver.orb.connection-managersserver.orb.
connection-managers.orb\.Connections\.Inbound\.
AcceptedConnectionsserver.jvm

次の表に、アプリケーションレベルに対するコマンド、ドット表記名、および対応する出力を示します。

appl1app2web-module1_warejb-module2_jar...

次の表に、アプリケーションレベルのスタンドアロンモジュールとエンタープライズアプリケーションのコマンド、ドット表記名、および対応する出力を示します。

CreateCount_CountCreateCount_
DescriptionCreateCount_
LastSampleTimeCreateCount_
NameCreateCount_
StartTimeCreateCount_
UnitMethodReadyCount_
CurrentMethodReadyCount_
DescriptionMethodReadyCount_
HighWaterMarkMethodReadyCount_
LastSampleTimeMethodReadyCount_
LowWaterMarkMethodReadyCount_
NameMethodReadyCount_
StartTimeMethodReadyCount_
UnitRemoveCount_CountRemoveCount_
DescriptionRemoveCount_
LastSampleTimeRemoveCount_
NameRemoveCount_StartTimeAttribute 
RemoveCount_Unit

次の表に、HTTP サービスレベルに対するコマンド、ドット表記名、および対応する出力を示します。

次の表に、スレッドプールレベルに対するコマンド、ドット表記名、および対応する出力を示します。

次の表に、リソースレベルに対するコマンド、ドット表記名、および対応する出力を示します。

次の表に、トランザクションサービスレベルに対するコマンド、ドット表記名、および対応する出力を示します。

次の表に、ORB レベルに対するコマンド、ドット表記名、および対応する出力を示します。

次の表に、JVM レベルに対するコマンド、ドット表記名、および対応する出力を示します。

JConsole の使用

ここでは、次の内容について説明します。

• 「JConsole から Application Server への接続のセキュリティーを有効にする」

• 「JConsole を Application Server に接続する前提条件」

• 「JConsole を Application Server に接続する」

• 「安全に JConsole を Application Server に接続する」

Communications Server の管理と監視は、JMX テクノロジをベースにしています。つまり、Communications Server の JVM で実行している MBeanServer では、管理対象コンポーネントは MBean で表されます。

Java SE 5 では、Platform MBean Server を含めること、および JVM を設定するための MBean を含めることにより、JVM の管理と監視を拡張します。Communications Server は、これらの拡張機能を利用して、MBean を Platform MBean Server に登録します。JMX コネクタクライアントには、JVM MBean と Communications Server MBean が統合表示されます。

すべての MBean を表示するために、Communications Server にはシステム JMX コネクタサーバーという標準 JMX コネクタサーバーの設定が用意されています。Communications Server の起動時に、この JMX コネクタサーバーのインスタンスが起動します。規格に準拠する JMX コネクタクライアントはすべて、このコネクタサーバーを使用してサーバーに接続できます。

Java SE には、MBean Server に接続し、そこに登録されている MBean を表示するためのツールも用意されています。JConsole は一般的な JMX コネクタクライアントであり、標準 Java SE ディストリビューションの一部として利用できます。JConsole の詳細は、http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html を参照してください。

Communications Server で使用できるように JConsole を設定すると、Communications Server は JMX コネクタのサーバー側となり、JConsole は JMX コネクタの優先クライアント側となります。「JConsole を Application Server に接続する」に、正常な接続を作成する方法が示されています。

JConsole から Application Server への接続のセキュリティーを有効にする

Communications Server 、つまりJMX コネクタサーバー側への接続方法は、接続のトランスポート層のセキュリティーによって若干異なります。サーバー側がセキュリティー保護されている (トランスポート層のセキュリティーが保証されている) 場合、クライアント側で実行する設定があります。

• Communications Server の開発者プロファイルの場合、デフォルトでは、セキュリティー保護されていないシステム JMX コネクタサーバーが設定されます。

• Communications Server のクラスタおよびエンタープライズプロファイルの場合、デフォルトでは、セキュリティー保護されたシステム JMX コネクタサーバーが設定されます。

• 通信に使用されるプロトコルは、RMI/JRMP です。JMX コネクタのセキュリティーが有効な場合、使用されるプロトコルは SSL 上の RMI/JRMP です。

  ---

  注 –

  SSL 上の RMI では、クライアントが目的のサーバーと通信できるようにするための追加チェックは行われません。そのため、JConsole の使用時は、悪意のあるホストにユーザー名とパスワードを送信している可能性が常にあります。セキュリティーが安全であるかどうかの確認は、管理者に完全に委ねられています。

  ---

開発者プロファイルドメインを appserver.sun.com のようなマシンにインストールすると、ドメイン管理サーバー (DAS) の domain.xml ファイルに次のようなエントリが含まれます。

<!- – The JSR 160 "system-jmx-connector" – –> <jmx-connector accept-all="false" address="0.0.0.0" auth-realm-name="admin-realm" enabled="true" name="system" port="8686" protocol="rmi_jrmp" security-enabled="false"/> <!- – The JSR 160 "system-jmx-connector" – –>

JMX コネクタの security-enabled フラグは false です。クラスタまたはエンタープライズプロファイルが稼働している場合、または開発者プロファイルの JMX コネクタのセキュリティーを有効にした場合、このフラグは true に設定されます。

<!- – The JSR 160 "system-jmx-connector" – –> <jmx-connector accept-all="false" address="0.0.0.0" auth-realm-name="admin-realm" enabled="true" name="system" port="8686" protocol="rmi_jrmp" security-enabled="true"/> ...</jmx-connector> <!- – The JSR 160 "system-jmx-connector" – –>

JConsole を Application Server に接続する前提条件

JConsole の設定は、2 つに分かれます。 サーバー側とクライアント側です。この例では、Communications Server ドメインは、強力な Solaris サーバーである appserver.sun.com と呼ばれるマシンにインストールされます。これがサーバー側です。

クライアント側にも Communications Server のインストールがあります。ここでは、クライアント側は Windows マシンで、Java SE 6.0 と Communications Server がインストールされているものとします。

クライアント側で Communications Server のインストールが必要になるのは、Communications Server ドメインのリモートマシン上でセキュリティーが有効な場合 (クラスタおよびエンタープライズプロファイルのデフォルト) だけです。前述の Solaris マシンで Communications Server 開発者プロファイルドメインを管理する場合、このクライアントマシンに Communications Server のインストールは必要ありません。

同じマシン上にサーバー側とクライアント側がある場合、localhost を使用してホスト名を指定できます。

JConsole を Application Server に接続する

この手順では、JMX コネクタでセキュリティーを有効にしないで JConsole を Communications Server に接続する方法について説明します。デフォルトでは、開発者プロファイルの Communications Server のセキュリティーは有効になっていません。

1. appserver.sun.com でドメインを起動します。

2. JDK_HOME/bin/jconsole を実行して JConsole を起動します。

3. JConsole の「エージェントに接続」タブで、ユーザー名、パスワード、ホスト名、およびポート (デフォルトは 8686) を入力します。

   ユーザー名は管理ユーザーの名前、パスワードはドメインの管理パスワードを参照します。

4. 「接続」をクリックします。

   JConsole ウィンドウの各種タブに、MBean、VM 情報などが表示されます。

安全に JConsole を Application Server に接続する

この手順では、JMX コネクタでセキュリティーを有効にして JConsole を Communications Server に接続する方法について説明します。クラスタまたはエンタープライズプロファイルの Communications Server のセキュリティーは、デフォルトで有効になっています。この手順は、開発者プロファイルの JMX コネクタでセキュリティーを有効にした場合に使用してください。

1. クライアントマシン (JConsole がインストールされている) に Communications Server をインストールします。

   この作業が必要になるのは、信頼するドメイン管理サーバーのサーバー証明書の場所を JConsole に対して通知するためです。この証明書を取得するには、リモートの asadmin コマンドを 1 回以上呼び出しますが、そのためには Communications Server のローカルインストールが必要です。

2. appserver.sun.com で Communications Server を起動します。

   これはクラスタまたはエンタープライズドメインであるため、システム JMX コネクタサーバーはセキュリティー保護されています。開発者プロファイルの JMX コネクタのセキュリティーを有効にするには、管理コンソールのオンラインヘルプを参照してください。

3. ローカル Communications Server インストールから install-dir\bin\asadmin list --user admin --secure=true --host appserver.sun.com --port 4848 を実行します。4848 はサーバーの管理ポートです。

   この例では asadmin list コマンドを選択していますが、任意のリモート asadmin コマンドを実行できます。appserver.sun.com の DAS から送信される証明書を受け入れることを要求されます。

4. y を押して、appserver.sun.com の DAS から送信される証明書を受け入れます。

   サーバーの証明書は、クライアントマシンのホームディレクトリにある .asadmintruststore ファイルに格納されます。

   ---

   注 –

   サーバーマシンとクライアントマシンが同じである場合、この手順は必要ありません。つまり、JConsole も appserver.sun.com で稼働している場合です。

   ---

5. 次の JConsole コマンドを使用して、トラストストアの場所を JConsole に通知します。

   JDK-dir\bin\jconsole.exe -J-Djavax.net.ssl.trustStore="C:\Documents and Settings\user\.asadmintruststore"

6. JDK_HOME/bin/jconsole を実行して JConsole を起動します。

7. JConsole の「エージェントに接続」タブで、ユーザー名、パスワード、ホスト名、およびポート (デフォルトは 8686) を入力します。

   ユーザー名は管理ユーザーの名前、パスワードはドメインの管理パスワードを参照します。

8. 「接続」をクリックします。

   JConsole ウィンドウの各種タブに、MBean、VM 情報などが表示されます。