第 16 章 监视组件和服务

本章包含有关使用 Application Server 管理控制台监视组件的信息。本章包括以下几个部分：

• 关于监视

• 用于启用和禁用监视功能的管理控制台任务

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

• 使用 JConsole

关于监视

• Application Server 中的监视功能

• 监视概述

• 关于可监视对象的树结构

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

Application Server 中的监视功能

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

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

监视概述

要监视 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

• 有关侦听器和 JMX 连接器的管理控制台任务，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 工具配置监视功能的步骤

使用管理控制台配置监视级别的步骤

1. 访问“监视服务”页面。要完成此操作，请执行以下步骤：

   1. 在树组件中，展开“配置”节点。

   2. 在树中，展开要配置为用于监视的服务器实例的节点，例如 server-config。

   3. 在树中，选择“监视”。

2. 在“监视服务”页面中，从要更改其监视级别的组件或服务对应的组合框中选择适当的值。

   默认情况下，所有组件和服务的监视功能均处于禁用状态。要启用监视功能，请在组合框中选择“低”或“高”。要禁用监视功能，请在组合框中选择“关闭”。可以启用或禁用以下组件和服务的监视功能：

   • JVM-将此选项的监视级别设置为“低”以监视 Java 虚拟机。

   • HTTP 服务-将此选项的监视级别设置为“低”以监视所有 HTTP 侦听器和虚拟服务器。

   • 事务服务-将此选项的监视级别设置为“低”以监视任一事务子系统。

   • JMS/连接器服务-将此选项的监视级别设置为“低”以监视任一 Java 消息服务 (Java Message Service, JMS)。

   • ORB-将此选项的监视级别设置为“低”以监视由 Application Server 内核及其连接管理器使用的系统 ORB。

   • Web 容器-将此选项的监视级别设置为“低”以监视所有已部署的 Servlet。

   • EJB 容器-将此选项的监视级别设置为“低”以监视所有已部署的 EJB 组件、EJB 池和 EJB 高速缓存。将此方法设置为“高”还可以监视 EJB 商业方法。

   • JDBC 连接池-将此选项的监视级别设置为“低”以监视所有 JDBC 连接池。

   • 线程池-将此选项的监视级别设置为“低”以监视所有线程池。

3. 单击“保存”。

   此版本中没有“其他监视服务属性”，因此请忽略“其他属性”表。

等效的 asadmin 命令

set

例如，要启用对 HTTP 服务的监视功能，请使用以下 asadmin 命令：

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

使用 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.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 工具查看监视数据

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

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

1. 访问“监视”页面。要完成此操作，请执行以下步骤：

   1. 在树组件中，展开“独立实例”节点。

   2. 从列表中选择一个独立服务器实例，例如 server (Admin Server)。

   3. 选择“监视”页面。

   4. 在“监视”页面上选择“监视”选项卡。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

等效的 asadmin 命令

get --monitor

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

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

使用 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 和 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 命令的示例

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

返回：

没有与通配符表达式一致的匹配项。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 一起使用，必须禁用 JMX 连接器的安全性。默认情况下，当前版本（SE/EE 版本）的 Application Server 将启用安全性。

禁用 JMX 连接器的安全性

1. 使用管理控制台禁用 JMX 连接器的安全性。要通过管理控制台执行此操作，请执行以下步骤：

   1. 展开节点代理。

   2. 选择节点代理。

   3. 取消选择 "JMX" 选项卡中的 "SSL3" 和 "TLS"。

   4. 选择“保存”。

2. 使用 asadmin 禁用 JMX 连接器的安全性。要从终端窗口或命令提示符执行此操作，请执行以下步骤：

   1. 输入以下命令：

      asadmin set server.admin-service.jmx-connector.system.security-enabled=false

   2. 重新启动域应用程序服务器 (DAS)。

      在 Platform Edition 版本中，默认情况下将禁用 JMX 连接器，因此不需要更改 Platform Edition 的配置。

3. 启动 JConsole，并在“高级”选项卡中输入 JMX URL、用户名和密码以便登录。JMX URL 的格式为：

   service:jmx:rmi:///jndi/rmi://<your machine name >:<port>/management/rmi-jmx-connector

   注：如果要搜索 message ADM1501，您可以从管理 server.log 文件中获得确切的 JMX URL。