Sun Java System Application Server Enterprise Edition 8.1 2005Q2 管理ガイド

- Previous: get --user admin-user --monitor コマンドの例
- Next: すべてのレベルにおける list コマンドと get コマンドの予想出力

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

- Previous: get --user admin-user --monitor コマンドの例
- Next: すべてのレベルにおける list コマンドと get コマンドの予想出力

- © 2010, Oracle Corporation and/or its affiliates