Sun Java System Application Server Enterprise Edition 8.1 2005Q2 管理指南

用于查看监视数据的管理控制台任务

在管理控制台中查看监视数据的步骤

有关每个组件或服务的属性的更多信息，请参阅关于受监视的组件和服务的统计信息。

访问“监视”页面。要完成此操作，请执行以下步骤：
1. 在树组件中，展开“独立实例”节点。
2. 从列表中选择一个独立服务器实例，例如 server (Admin Server)。
3. 选择“监视”页面。
4. 在“监视”页面上选择“监视”选项卡。

在“查看”列表中，选择已部署到服务器实例并已为其启用了监视功能的组件或服务。

选定组件或服务的监视数据显示在“查看”字段下。有关可监视属性的说明，请参阅关于受监视的组件和服务的统计信息。

如果已启用 JVM、服务器、线程池、HTTP 服务和事务服务的监视功能，则可以在此页面中查看这些组件和服务的监视数据。关于可监视对象的树结构中显示了用于说明这些组件和服务的组织方式的图。

如果在此列表中没有看到要监视的组件或服务，请选择“配置监视”链接来启用和禁用选定组件和服务的监视功能。

选择“关闭”以禁用对组件或服务的监视。选择“低”或“高”以启用对组件或服务的监视。

有关启用和禁用监视功能的更多信息，请参阅使用管理控制台配置监视级别的步骤或使用 asadmin 工具配置监视功能的步骤。

选择“监视器”页面的“应用程序”选项卡来查看已部署到服务器实例上且已启用了监视功能的应用程序组件的监视数据。从“应用程序”列表中选择应用程序。从“组件”列表中选择特定组件。

如果未显示应用程序或组件的监视数据，请选择“配置监视”链接来启用或禁用组件或服务的监视功能。要监视应用程序，请打开执行这些应用程序的容器。例如，对于 Web 应用程序的 Web 容器和/或 EJB 应用程序的 EJB 容器，选择“低”或“高”。

如果未显示应用程序的监视数据，则该应用程序很可能不存在或未运行。仅当应用程序存在、已启用对该程序的监视功能且应用程序正在运行时，应用程序监视数据才可用。一旦执行应用程序，则将在监视注册表登记该应用程序并显示其监视数据。

使用管理控制台监视远程应用程序和实例。远程实例必须正在运行并已设置配置才能执行此操作。

选定组件的监视数据显示在选定组件下面。有关可监视属性的说明，请参阅关于受监视的组件和服务的统计信息。关于可监视对象的树结构中显示了用于说明应用程序的这些组件和服务的组织方式的图。

选择“资源”页面可以查看资源的监视数据，这些资源已被部署到服务器实例中并且已启用对这些资源的监视功能。从“查看”列表中选择资源。

如果未显示您要查看其监视数据的资源，请选择“配置监视”链接来启用或禁用资源的监视功能。

如果未显示资源的监视数据，则该资源很可能不存在或未运行。仅当资源存在、已在 HIGH 级别启用该资源的监视功能并且该资源正在运行的情况下，资源监视数据才可用。例如，如果您创建了一个 JDBC 连接器服务，但使用该连接器服务的应用程序尚未从服务请求连接器，则尚未创建该服务。因而，不存在任何服务，也没有任何可用的监视数据。一旦执行 JDBC 应用程序且该应用程序从服务请求连接器，则将在监视注册表中注册该应用程序并显示其监视数据。

选定组件或服务的监视数据显示在“查看”字段下。有关可监视属性的说明，请参阅关于受监视的组件和服务的统计信息。关于可监视对象的树结构中显示了用于说明资源的这些组件和服务的组织方式的图。

选择“事务”页面以冻结事务子系统，进而回滚事务并确定冻结时正在进行的事务。

要启用事务服务的监视功能，请选择“配置监视”链接并确保将“事务服务”设置为“低”。

要冻结事务服务以回滚事务，请选择“冻结”。要回滚事务，请选中事务旁边的复选框并单击“回滚”。

等效的 asadmin 命令

get --monitor

例如，要查看 JVM 的监视数据，请使用以下 asadmin 命令：

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

使用 asadmin 工具查看监视数据

要使用 asadmin 工具查看监视数据，请使用 asadmin list 和 asadmin get 命令，后跟可监视对象的带点名称，如下所示。

要查看可监视对象的名称，请使用 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 命令一起使用的带点名称的详细信息，请参阅了解和指定带点的名称。

要显示已启用监视功能的应用程序组件或子系统的监视统计信息，请使用 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 和 get 命令中，指定可监视对象的带点名称。所有子对象都是使用点字符 (.) 作为分隔符来寻址的，因此它们被称为带点名称。如果子节点是单元素类型，则只需要使用监视对象类型对对象进行寻址；否则，需要使用 type.name 名称格式对对象进行寻址。

例如，http-service 就是其中一种有效的可监视对象类型，并且是单元素类型。要对表示实例 server 的 http-service 的单元素类型子节点进行寻址，则带点名称为：

server.http-service

再比如，application 是一种有效的可监视对象类型，并且是非单元素类型。要对表示应用程序 PetStore 的非单元素类型子节点进行寻址，则带点名称为：

server.applications.petstore

带点的名称还可以指定可监视对象中的特定属性。例如，http-service 具有一个名为 bytesreceived-lastsampletime 的可监视属性。以下名称可对 bytesreceived 属性进行寻址：

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

管理员不需要知道 asadmin list 和 get 命令的有效带点名称。使用 list 命令可以显示可用的可监视对象，而使用带有通配符参数的 get 命令可以检查任意可监视对象的所有可用属性。

使用具有带点名称的 list 和 get 命令的基本假设为：

如果使用任何具有带点名称且后面不跟通配符 (*) 的 list 命令，则得到的结果为当前节点的直接子节点。例如，list --user adminuser --monitor server 列出了所有属于 server 节点的直接子节点。
如果使用任何具有带点名称且后面跟有 .* 形式的通配符的 list 命令，则得到的结果为当前节点的子节点分层树。例如，list --user adminuser --monitor server.applications.* 可列出 applications 的所有子节点及其后续子节点等。
如果使用任何具有带点名称并且前面或后面带有 *dottedname、dotted * name 或 dotted name * 形式的通配符的 list 命令，则得到的结果为与所提供的匹配模式创建的正则表达式相匹配的所有节点及其子节点。
如果使用后跟 .* 或 * 的 get 命令，则得到的结果为属于要匹配的当前节点的属性集及其值。

有关更多信息，请参见list 和 get 命令在所有级别上的预期输出。

list 和 get 命令的示例

本节包括以下主题：

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

没有与通配符表达式一致的匹配项。CLI137 命令失败。

该 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

通过反映相应的统计信息接口 [badname] 没有找到此类属性，CLI137 命令失败。

使用 PetStore 示例

下例说明了如何将 asadmin 工具用于监视目的。

用户要检查将样例 PetStore 应用程序部署到 Application Server 之后在该应用程序中调用某个方法的次数。部署该应用程序的实例名称为 server。结合使用 list 和 get 命令即可访问所需的方法统计信息。

启动 Application Server 和 asadmin 工具。

设置一些有用的环境变量，以避免使用每个命令时都输入这些变量：

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

列出实例 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。

列出 PetStore 应用程序中的可监视子组件（可以用 -m 代替 --monitor）：

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

列出 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

列出 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

列出 PetStore 应用程序的 EJB 模块 signon-ejb_jar 的实体 Bean UserEJB 所用方法 getUserName 中的可监视子组件：

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

在 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods.getUserName 没有内容可以列出。要获得以某个字符串开头的有效名称，请使用通配符 "*" 字符。例如，要列出以 "server" 开头的所有名称，请使用 "list server*"。

该方法没有可监视的子组件。获取方法 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

如果还需要获取执行时间等特定统计信息，请使用如下命令：

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 命令在所有级别上的预期输出

下表显示了树的各个级别的命令、带点的名称及相应的输出。

表 16–33 顶层

命令

带点的名称

输出

list -m

server

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

list -m

server.*

此节点下的子节点的分层结构。

get -m

server.*

仅显示一条消息，说明此节点上没有属性。

下表显示了应用程序级别的命令、带点名称以及相应的输出。

表 16–34 应用程序级别

命令

带点的名称

输出

list -m

server.applications

或

*applications

appl1app2web-module1_warejb-module2_jar...

list -m

server.applications.*

或

*applications.*

此节点下的子节点的分层结构。

get -m

server.applications.*

或

*applications.*

仅显示一条消息，说明此节点上没有属性。

下表显示了应用程序级别的独立模块和企业应用程序的命令、带点名称以及相应的输出。

表 16–35 应用程序- -企业应用程序和独立模块

命令

带点的名称

输出

list -m

server.applications.app1

或

*app1

注：仅当已部署了企业应用程序时，此级别才可用。如果部署了独立模块，则此级别不可用。

ejb-module1_jarweb-module2_warejb-module3_jarweb-module3_war...

list -m

server.applications.app1.*

或

*app1.*

此节点下的子节点的分层结构。

get -m

server.applications.app1.*

或

*app1.*

仅显示一条消息，说明此节点上没有属性。

list -m

server.applications.app1.ejb-module1_jar

或

*ejb-module1_jar

或

server.applications.ejb-module1_jar

bean1bean2bean3...

list -m

server.applications.app1.ejb-module1_jar

或

*ejb-module1_jar

或

server.applications.ejb-module1_jar

此节点下的子节点的分层结构。

get -m

server.applications.app1.ejb-module1_jar.*

或

*ejb-module1_jar.*

或

server.applications.ejb-module1_jar.*

仅显示一条消息，说明此节点上没有属性。

list -m

server.applications.app1.ejb-module1_jar.bean1