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

• 「asadmin ツールを使用して監視データを表示する」

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

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

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

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

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

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

asadmin ツールを使用して監視データを表示する

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.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

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

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

次の結果が返されます。

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

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

例 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 ツールを監視目的でどのように使えばよいかを示したものです。

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

手順

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

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

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

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 レベルに対するコマンド、ドット表記名、および対応する出力を示します。