第 16 章 監視元件和服務

本章包含有關使用 Application Server 管理主控台 來監視元件的資訊。本章包括下列小節：

• 關於監視

• 有關啟用和停用監視功能的 管理主控台 作業

• 有關檢視監視資料的 管理主控台 作業

• 使用 JConsole

關於監視

• 監視 Application Server

• 監視概述

• 關於可監視物件的樹狀結構

• 關於受監視的元件和服務的統計資訊

監視 Application Server

使用監視功能可以觀察在 Application Server 的伺服器實例中所部署的各種元件和服務的執行階段狀態。利用有關執行階段元件和程式狀態的資訊，可以確定效能瓶頸以便進行調校、和容量規劃、預測故障、在發生故障時分析根本原因，以及確保一切執行正常。

啟用監視功能會因增加系統耗用而使效能降低。

監視概述

若要監視 Application Server，請執行以下步驟：

1. 使用 管理主控台 或 asadmin 工具啟用對特定服務和元件的監視功能。

   如需有關此步驟的更多資訊，請參閱有關啟用和停用監視功能的 管理主控台 作業。

2. 使用 管理主控台 或 asadmin 工具檢視指定服務或元件的監視資料。

   如需有關此步驟的更多資訊，請參閱有關檢視監視資料的 管理主控台 作業。

關於可監視物件的樹狀結構

Application Server 使用樹狀結構追蹤可監視物件。由於監視物件的樹是動態的，因此在實例中增加、更新或移除元件時該樹會相應地發生變更。樹狀結構中的根物件是伺服器實例名稱 (例如 server)。(在 Platform Edition 中，僅允許使用一個伺服器實例。)

以下指令顯示了樹的頂層：

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 服務示意圖 (Platform Edition 版)

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

範例 16–3 HTTP 服務示意圖 (Enterprise Edition 版)

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 服務的統計。這些統計資訊僅適用於 Platform Edition。如需有關 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 中可用的附加監視功能的更多資訊，請參閱以下位置中標題為「Monitoring and Management for the Java Platform」的文件：http://java.sun.com/j2se/1.5.0/docs/guide/management/。

以下位置中論述了 J2SE 5.0 監視工具：http://java.sun.com/j2se/1.5.0/docs/tooldocs/#manage。

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 位妝M DNS 名稱。依預設，伺服器的 DNS 快取處於停用狀態。單一快取項目表示單一 IP 位址或 DNS 名稱查詢。下表中列出了可用於 PWC DNS 的統計。

下表列出了 PWC 執行緒池的統計。

連線佇列是請求被處理前保存這些請求的佇列。連線佇列的統計資訊顯示佇列中的階段作業數以及連線被接受前的平均延遲。下表列出了 PWC 連線佇列的統計。

下表列出了 PWC HTTP服務的統計。

有關啟用和停用監視功能的 管理主控台 作業

• 使用 管理主控台 配置監視層級

• 使用 asadmin 工具配置監視功能

使用 管理主控台 配置監視層級

1. 存取 [監視服務] 頁面。若要完成此操作，請執行以下步驟：

   1. 在樹形元件中，展開 [配置] 節點。

   2. 在樹狀結構中，展開要配置為用於監視功能之伺服器實例的節點，例如 server-config。

   3. 在樹中，選取 [監視]。

2. 在 [監視服務] 頁面中，從要變更其監視層級的元件或服務相對的組合方塊中選擇適當的值。

   依預設，所有元件和服務的監視功能均處於關閉狀態。若要啟用監視功能，請在組合方塊中選取 [低] 或 [高]。若要關閉監視功能，請在組合方塊中選取 [關閉]。可以開啟或關閉以下元件和服務的監視功能：

   • JVM - 將此選項的監視層級設定為 [低]，可監視 Java 虛擬機器。

   • HTTP 服務 - 將此選項的監視層級設定為 [低]，可監視所有 HTTP 偵聽程式和虛擬伺服器。

   • 作業事件服務 - 將此選項的監視層級設定為 [低]，可監視任意作業事件子系統。

   • JMS/連接器服務 - 將此選項的監視層級設定為 [低]，可監視任意 Java 訊息服務 (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. 從清單中選取獨立伺服器實例，例如伺服器 (Admin Server)。

   3. 選取 [監視] 頁面。

   4. 在 [監視] 頁面上選取 [監視] 標籤。

2. 在 [檢視] 清單中，選取已部署到伺服器實例並已為其啟用了監視功能的元件或服務。

   所選元件或服務的監視資料顯示在 [檢視] 欄位下。如需有關可監視特性的說明，請參閱關於受監視的元件和服務的統計資訊。

   如果已針對 JVM、伺服器、執行緒池、HTTP 服務和作業事件服務啟用監視功能，則可以在此頁面中檢視這些元件和服務的監視資料。關於可監視物件的樹狀結構以圖解說明這些元件和服務的組織架構。

3. 如果沒有在此清單中看到您要監視的元件或服務，請選取 [配置監視] 連結，以針對所選元件和服務啟用和停用監視功能。

   選取 [關閉] 以停用對元件或服務的監視功能。選取 [低] 或 [高]，以針對元件或服務啟用監視功能。

   如需有關啟用和停用監視功能的更多資訊，請參閱使用 管理主控台 配置監視層級或使用 asadmin 工具配置監視功能。

4. 選取 [監視] 頁面的 [應用程式] 標籤，以檢視部署至伺服器實例並已啟用監視功能的應用程式元件的監視資料。從 [應用程式] 清單中選取應用程式。從 [元件] 清單中選取特定元件。

   如果未顯示應用程式或元件的監視資料，請選取 [配置監視] 連結，以針對元件或服務啟用或停用監視功能。若要監視應用程式，請開啟執行這些應用程式的容器。例如，針對 Web 應用程式的 Web 容器和/或 EJB 應用程式的 EJB 容器選取 [低] 或 [高]。

   如果未顯示應用程式的監視資料，則該應用程式很可能不存在或未執行。僅當應用程式存在、其監視功能已啟用且正在運行時，應用程式監視資料才可用。執行了應用程式後，將在監視註冊中註冊該應用程式並顯示其監視資料。

   使用 管理主控台 監視遠端應用程式和實例。遠端實例必須正在執行並已設定配置才能執行此操作。

   所選取元件的監視資料顯示在所選取元件下面。如需有關可監視特性的說明，請參閱關於受監視的元件和服務的統計資訊。您可以在關於可監視物件的樹狀結構中檢視說明這些元件和服務如何針對應用程式進行組織的圖解。

5. 選取 [資源] 頁面可檢視部署至伺服器實例並啟用監視功能的資源的監視資料。從 [檢視] 清單中選取資源。

   如果未顯示您要檢視其監視資料的資源，請選取 [配置監視] 連結，以針對資源啟用或停用監視功能。

   如果未顯示資源的監視資料，則該資源很可能不存在或未執行。僅當資源存在、已針對此資源啟用 [高] 層級的監視功能，並且正在執行此資源時，才能取得此資源的監視資料。例如，如果您已建立 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 指令的範例

此指令可擷取以下受監視的資訊：

• 一個元件或子系統內的全部受監視屬性

• 一個元件或子系統內特定的受監視屬性

  當特定元件或子系統所請求的屬性不存在時，將會傳回錯誤。同樣，當元件或子系統所請求的特定屬性不在作用中時，也會傳回錯誤。

  請參閱list 和 get 指令在所有層級上的預期輸出，以取得有關使用 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 工具用於監視目的。

使用者要檢查將範例 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. 列出實體 Bean UserEJB (位於 PetStore 應用程式的 EJB 模組 signon-ejb_jar 中) 之 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 層級的指令、帶點名稱及對應的輸出。

使用 JConsole

若要使 JConsole 可以與 Application Server 配合使用，必須停用 JMX 連接器的安全性。依預設，Application Server 的目前版本 (SE/EE 版本) 已啟用安全性。

停用 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://<您的機器名稱>:<連接埠>/management/rmi-jmx-connector

   備註：如果您搜尋 message ADM1501，便可從管理 server.log 檔案中取得確切的 JMX URL。