第 16 章 监视组件和服务

使用监视功能可以观察 Application Server 的服务器实例中所部署的各种组件和服务的运行状态。利用有关运行时组件和进程状态的信息，可以确定性能瓶颈以便进行优化、有助于进行容量规划、预测故障、在发生故障时分析根本原因，以及确保一切运行正常。

启用监视功能会因增加系统开销而使性能降低。

本章包括以下几个部分：

• 监视概述

• 受监视的组件和服务的统计信息

• 启用和禁用监视功能

• 查看监视数据

• 使用 JConsole

监视概述

要监视 Application Server，请执行以下步骤：

1. 使用管理控制台或 asadmin 工具来启用对特定服务和组件的监视功能。

   有关此步骤的更多信息，请参阅启用和禁用监视功能。

2. 使用管理控制台或 asadmin 工具来查看指定服务或组件的监视数据。

   有关此步骤的更多信息，请参阅查看监视数据。

关于可监视对象的树结构

Application Server 使用树结构来跟踪可监视对象。由于监视对象的树是动态的，因此在实例中添加、更新或删除组件时该树会相应地发生变化。树的根对象为服务器实例名称，例如 server。（在平台版中，仅允许使用一个服务器实例。）

以下命令显示了树的顶层：

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

以下各节介绍了这些子树：

• 应用程序树

• HTTP 服务树

• 资源树

• 连接器服务树

• JMS 服务树

• ORB 树

• 线程池树

应用程序树

以下示意图显示了企业应用程序的各种组件的顶层节点和子节点。具有可用的监视统计信息的节点标有星号 (*)。有关更多信息，请参阅EJB 容器统计信息。

示例 16–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

HTTP 服务树

以下示意图显示了 HTTP 服务的节点。具有可用的监视信息的节点标有星号 (*)。请参见HTTP 服务统计信息。

示例 16–2 HTTP 服务示意图（平台版）

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

示例 16–3 HTTP 服务示意图（企业版）

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

资源树

资源节点保存 JDBC 连接池、连接器连接池等池的可监视属性。以下示意图显示了各种资源组件的顶层节点和子节点。具有可用的监视统计信息的节点标有星号 (*)。请参见JDBC 连接池统计信息。

示例 16–4 资源示意图

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

连接器服务树

连接器服务节点保存连接器连接池等池的可监视属性。以下示意图显示了各种连接器服务组件的顶层节点和子节点。具有可用的监视统计信息的节点标有星号 (*)。请参见JMS 连接器服务统计信息。

示例 16–5 连接器服务示意图

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 服务组件的顶层节点和子节点。具有可用的监视统计信息的节点标有星号 (*)。

示例 16–6 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 中连接管理器的统计信息。

示例 16–7 ORB 示意图

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

线程池树

线程池节点保存连接管理器的可监视属性。以下示意图显示了 ORB 组件的顶层节点和子节点。具有可用的监视统计信息的节点标有星号 (*)。请参见线程池统计信息。

示例 16–8 线程池示意图

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

受监视的组件和服务的统计信息

本节介绍了可用的监视统计信息：

• EJB 容器统计信息

• Web 容器统计信息

• HTTP 服务统计信息

• JDBC 连接池统计信息

• JMS 连接器服务统计信息

• ORB 中连接管理器的统计信息

• 线程池统计信息

• 事务服务统计信息

• Java 虚拟机 (JVM) 统计信息

• J2SE 5.0 中的 JVM 统计信息

• 生产 Web 容器 (PWC) 统计信息

EJB 容器统计信息

下表中介绍了 EJB 统计信息。

下表中列出了有关 EJB 方法调用的可用的统计信息。

下表中列出了有关 EJB 会话存储的统计信息。

下表中列出了有关 EJB 池的可用的统计信息。

下表中列出了有关 EJB 高速缓存的可用的统计信息。

下表中列出了有关计时器的可用的统计信息。

Web 容器统计信息

Web 容器包含在应用程序树所示的对象树中。系统为每个单独的 Web 应用程序都显示了 Web 容器统计信息。Web 容器统计信息中显示了有关 Servlet Web 容器的可用的统计信息，Web 容器统计信息中显示了有关 Web 模块的可用的统计信息。

Web 容器统计信息中显示了有关 Web 模块的可用的统计信息。

HTTP 服务统计信息

HTTP 服务统计信息中显示了有关 HTTP 服务的可用的统计信息。这些统计信息仅适用于平台版。有关 Enterprise Edition 上的HTTP 服务的统计信息，请参见生产 Web 容器 (PWC) 统计信息。

JDBC 连接池统计信息

用于在运行时监视 JDBC 资源，以测量性能并捕获资源使用情况。由于创建 JDBC 连接的成本很高并且常常会导致应用程序出现性能瓶颈问题，因此对 JDBC 连接池释放和创建新连接的方法以及正在等待从特定池中检索连接的线程数的监视是至关重要的。

下表中显示了有关 JDBC 连接池的可用的统计信息。

JMS 连接器服务统计信息

JMS 连接器服务统计信息中显示了有关连接器连接池的可用的统计信息。JMS 连接器服务统计信息中显示了连接器工作管理统计信息。

JMS 连接器服务统计信息中列出了有关连接器工作管理的可用的统计信息。

ORB 中连接管理器的统计信息

ORB 中连接管理器的统计信息中列出了有关 ORB 中的连接管理器的可用的统计信息。

线程池统计信息

下表中显示了有关线程池的可用的统计信息。

事务服务统计信息

事务服务允许客户机冻结事务子系统，以回滚事务并确定冻结时正在进行的事务。下表中显示了有关事务服务的可用的统计信息。

Java 虚拟机 (JVM) 统计信息

JVM 具有始终处于启用状态的可监视属性。下表中显示了有关 JVM 的可用的统计信息。

J2SE 5.0 中的 JVM 统计信息

如果 Application Server 被配置为在 J2SE 5.0 或更高版本上运行，则可以从 JVM 中获得其他监视信息。将监视级别设置为“低”以启用这些附加信息的显示。将监视级别设置为“高”还可以查看与系统中每个活动线程相关的信息。有关 J2SE 5.0 中可用的其他监视功能的详细信息，请参见http://java.sun.com/j2se/1.5.0/docs/guide/management/中标题为 "Monitoring and Management for the Java Platform" 的文档。

http://java.sun.com/j2se/1.5.0/docs/tooldocs/#manage 中讨论了 J2SE 5.0 监视工具。

J2SE 5.0 中的 JVM 统计信息中显示了有关 J2SE 5.0 中的 JVM 类装入的可用的统计信息。

J2SE 5.0 中的 JVM 统计信息中显示了有关 J2SE 5.0 中的 JVM 编译的可用的统计信息。

J2SE 5.0 中的 JVM 统计信息中显示了有关 J2SE 5.0 中的 JVM 垃圾回收的可用的统计信息。

J2SE 5.0 中的 JVM 统计信息中显示了有关 J2SE 5.0 中的 JVM 内存的可用的统计信息。

J2SE 5.0 中的 JVM 统计信息中显示了有关 J2SE 5.0 中的 JVM 操作系统的可用的统计信息。

J2SE 5.0 中的 JVM 统计信息中显示了有关 J2SE 5.0 中的 JVM 运行的可用的统计信息。

J2SE 5.0 中的 JVM 统计信息中显示了有关 J2SE 5.0 中的 JVM ThreadInfo 的可用的统计信息。

J2SE 5.0 中的 JVM 统计信息中显示了有关 J2SE 5.0 中的 JVM 线程的可用的统计信息。

生产 Web 容器 (PWC) 统计信息

给出了有关 Application Server 企业版 (Enterprise Edition, EE) 中的以下 PWC 组件和服务的可用的统计信息：

• 生产 Web 容器 (PWC) 统计信息，PWC 虚拟服务器

• 生产 Web 容器 (PWC) 统计信息，PWC 请求

• 生产 Web 容器 (PWC) 统计信息，PWC 文件高速缓存

• 生产 Web 容器 (PWC) 统计信息，PWC 保持活动

• 生产 Web 容器 (PWC) 统计信息，PWC DNS

• 生产 Web 容器 (PWC) 统计信息，PWC 线程池

• 生产 Web 容器 (PWC) 统计信息，PWC 连接队列

• 生产 Web 容器 (PWC) 统计信息，PWC HTTP 服务

生产 Web 容器 (PWC) 统计信息中列出了有关 PWC 虚拟服务器的统计信息。

下表中列出了有关 PWC 请求的可用的统计信息。

高速缓存信息部分提供了有关文件高速缓存当前的使用方式的信息。下表中列出了有关 PWC 文件高速缓存的统计信息。

本节提供了有关服务器的 HTTP 级保持活动的系统的信息。下表中列出了有关 PWC 保持活动的可用的统计信息。

DNS 高速缓存高速缓存 IP 地址和 DNS 名称。默认情况下，服务器的 DNS 高速缓存处于禁用状态。一个高速缓存条目代表一个 IP 地址或 DNS 名称查找。下表中列出了有关 PWC DNS 的可用的统计信息。

下表中列出了有关 PWC 线程池的统计信息。

连接队列是指请求被处理前容纳这些请求的队列。连接队列的统计信息显示队列中的会话数以及连接被接受前的平均延迟时间。下表中列出了有关 PWC 连接队列的统计信息。

下表中列出了有关 PWC HTTP 服务的统计信息。

启用和禁用监视功能

在管理控制台中，可以通过选择“配置”节点 >“服务器实例”节点 >“监视”页面来配置监视级别，并为要更改监视级别的服务选择值。默认情况下，所有组件和服务的监视功能均处于禁用状态。

有关如何配置监视级别的详细步骤，请查阅管理控制台联机帮助。

在命令行中，使用 asadmin set 对各种 Application Server 组件启用监视功能。例如，运行以下命令对 HTTP 服务启用监视功能：

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

使用 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 = HIGH
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

使用 set 命令禁用监视功能。

例如，运行以下命令对 HTTP 服务禁用监视功能：

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

同样，要对其他组件禁用监视功能，请使用 set 命令并将监视级别指定为 OFF。

查看监视数据

在管理控制台中，可以通过以下方式查看监视数据：导航到独立服务器实例的“监视”页面，然后选择已部署到启用了监视功能的服务器实例上的组件或服务。选定的组件或服务的监视数据显示在“查看”字段下，并附有对可监视属性的说明。

使用管理控制台监视远程应用程序和实例。远程实例必须正在运行并已设置配置才能执行此操作。有关查看监视数据的详细步骤，请查阅管理控制台联机帮助。

要使用命令行实用程序查看监视数据，请使用 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

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

了解和指定带点名称

在 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 命令示例

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

get 命令示例

get 命令将检索以下受监视的信息：

• 组件或子系统中监视的所有属性

• 组件或子系统中监视的特定属性

  如果特定组件或子系统中不存在所请求的属性，将返回一个错误。类似地，如果组件或子系统中所请求的特定属性处于非活动状态，也会返回一个错误。

  有关使用 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 命令即可访问所需的方法统计信息。

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 应用程序中的可监视子组件（可以用 -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

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

   返回：

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

Application Server 的管理（管理和监视）基于 JMX。这意味着被管理组件被表示为 MBean。使用 Java 2 Standard Edition (J2SE) 5.0 可以监视 JVM 并查看 JVM MBean，从而了解其运行情况。为了公开此程序设备，Application Server 提供了一种称为系统 JMX 连接器服务器的标准 JMX 连接器服务器配置。启动 Application Server 时，将启动此 JMX 连接器服务器的一个实例，从而向受信客户机公开此程序配置。

Java 监视和管理控制台 (JConsole) 是一种常用的 JMX 连接器，可用于管理 JMX 后端。JConsole (http://java.sun.com/j2se/1.5.0/docs/tooldocs/share/jconsole.html) 作为从 J2SE 5.0 开始的标准 JDK 分发的一部分提供。有关 JConsole 的更多信息，请参见http://java.sun.com/developer/technicalArticles/J2SE/jconsole.html

为 Application Server 配置 JConsole 时，Application Server 将成为 JMX 连接器的服务器端，JConsole 将成为 JMX 连接器的首选客户机端。

保护 JConsole 与 Application Server 之间的连接

在如何基于连接的传输层安全性连接到 Application Server 或任何 JMX 连接器服务器端方面，存在细微的差别。如果服务器端是安全的（保证传输层安全性），则只需在客户机端执行较少的配置。

• 默认情况下，平台版 Application Server 的系统 JMX 连接器服务器端是不安全的。

• 默认情况下，企业版 Application Server 的系统 JMX 连接器服务器端是安全的。

• 通信所使用的协议为 RMI/JRMP。如果为 JMX 连接器启用安全性，则使用的协议为基于 SSL 的 RMI/JRMP。

  ---

  注 –

  基于 SSL 的 RMI 不提供其他检查以确保客户机正在与预定服务器进行通信。因此，使用 JConsole 时，始终有可能将用户名和密码发送到恶意主机。能否确保安全性不会降低完全取决于管理员。

  ---

当您在计算机（例如 appserver.sun.com）上安装平台版域时，将会在 DAS（Domain Administration Server，域管理服务器，即管理服务器或简称域）的 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 设置包含两部分：服务器端和客户机端。Application Server 域安装在名为 appserver.sun.com 的计算机中，这是一个功能强大的 Solaris 服务器。这是服务器端。

客户机端也安装有 Application Server。假设客户机端是安装有 Java SE 5.0 和 Application Server 的 Windows 计算机。

仅当对远程计算机上的 Application Server 域启用了安全性（企业版的默认设置）时，才需要在客户机端安装 Application Server。如果仅希望管理上述 Solaris 计算机中的 Application Server 平台版域，则不需要在此客户机上安装 Application Server。

如果服务器端和客户机端位于同一台计算机上，则可以使用 localhost 指定主机名。

将 JConsole 连接到 Application Server

本节介绍如何在未对 JMX 连接器启用安全性的情况下将 JConsole 连接到 Application Server。默认情况下，没有在 Application Server 平台版上启用安全性。

1. 在 appserver.sun.com 上启动域。

2. 通过运行 JDK_HOME/bin/jconsole 来启动 JConsole。

3. 在 JConsole 的“连接到代理”选项卡中，输入用户名、密码、主机名和端口（默认为 8686）。

   用户名是指域的管理用户名，密码是指域的管理密码。

4. 单击“连接”。

   在 JConsole 窗口的各个选项卡中，将显示所有的 MBean、虚拟机信息等。

将 JConsole 安全连接到 Application Server

本节介绍如何在对 JMX 连接器启用安全性的情况下将 JConsole 连接到 Application Server。默认情况下，在 Application Server 企业版上启用了安全性。如果已对平台版的 JMX 连接器启用了安全性，请执行此过程。

1. 在客户机（安装有 JConsole）上安装 Application Server。

   需要执行此操作的唯一原因是让 JConsole 知道您所信任的域管理服务器的服务器证书位于何处。要获取此证书，请至少调用一次远程 asadmin 命令；要实现此调用，需要在本地安装 Application Server。

2. 在 appserver.sun.com 上启动 Application Server 企业版。

   由于这是企业版域，因此系统 JMX 连接器服务器是安全的。

3. 在本地 Application Server 安装中，运行 install-dir/bin/asadmin list --user admin --secure=true --host appserver.sun.com --port 4849（其中 4849 是服务器的管理端口）。

   虽然示例选择了 asadmin list 命令，但是您可以运行任何远程 asadmin 命令。现在，系统将提示您接受 appserver.sun.com 的 DAS 所发送的证书。

4. 按 y 以接受 appserver.sun.com 上的域管理服务器所发送的证书。

   在客户机上，服务器证书存储在主目录下名为 .asadmintruststore 的文件中。

   ---

   注 –

   如果服务器与客户机相同，则不需要执行此步骤。换句话说，如果也在 appserver.sun.com 上运行 JConsole。

   ---

5. 通过使用以下 JConsole 命令使 JConsole 知道 DAS 的信任存储位置：

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

   现在，此证书自动得到 JConsole 的信任。

6. 通过运行 JDK_HOME/bin/jconsole 来启动 JConsole。

7. 在 JConsole 的“连接到代理”选项卡中，输入用户名、密码、主机名和端口（默认为 8686）。

   用户名是指域的管理用户名，密码是指域的管理密码。

8. 单击“连接”。

   在 JConsole 窗口的各个选项卡中，将显示所有的 MBean、虚拟机信息等。