第 18 章 監視元件和服務

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

• 關於監視

• 啟用與停用監視

• 檢視監視資料

• 使用 JConsole

關於監視

• 監視 Application Server

• 監視概述

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

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

監視 Application Server

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

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

也可以選擇在伺服器達到特定的效能臨界值時採取行動。如需更多資訊，請參閱第 19 章, 配置管理規則。

監視概述

若要監視 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 容器統計資訊。

範例 18–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 服務統計資訊。

範例 18–2 HTTP 服務圖解 (開發者設定檔版本)

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

範例 18–3 HTTP 服務圖解 (叢集和企業設定檔版本)

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

資源樹

資源節點包含 JDBC 連線池和連接器連線池等池的可監視屬性。以下示意圖顯示了各種資源元件的頂層節點和子節點。具有可用的監視統計資訊的節點標有星號 (*)。請參閱JDBC 連線池統計資訊。

範例 18–4 資源示意圖

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

連接器服務樹

連接器服務節點包含連接器連線池等池的可監視屬性。以下示意圖顯示了各種連接器服務元件的頂層節點和子節點。具有可用的監視統計資訊的節點標有星號 (*)。請參閱JMS/連接器服務統計資訊。

範例 18–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 服務元件的頂層節點和子節點。具有可用的監視統計資訊的節點標有星號 (*)。

範例 18–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 中連線管理程式的統計資訊。

範例 18–7 ORB 示意圖

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

執行緒池樹

執行緒池節點包含連線管理程式的可監視屬性。以下示意圖顯示了 ORB 元件的頂層節點和子節點。具有可用的監視統計資訊的節點標有星號 (*)。請參閱執行緒池統計資訊。

範例 18–8 執行緒池示意圖

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

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

本小節描述可用的監視統計資訊：

• EJB 容器統計資訊

• Web 容器統計資訊

• HTTP 服務統計資訊

• JDBC 連線池統計資訊

• JMS/連接器服務統計資訊

• ORB 中連線管理程式的統計資訊

• 執行緒池統計資訊

• 作業事件服務統計資訊

• Java 虛擬機器 (JVM) 統計資訊

• Java SE 中的 JVM 統計資訊

• 生產 Web 容器 (PWC) 統計資訊

EJB 容器統計資訊

以下表格說明了 EJB 容器統計資訊：

• 表 18–1

• 表 18–2

• 表 18–3

• 表 18–4

• 表 18–5

• 表 18–6

下表說明 EJB 統計資訊。

下表中列出了 EJB 方法呼叫的可用統計資訊。

下表中列出了 EJB 階段作業儲存的統計資訊。

下表中列出了 EJB 池的可用統計資訊。

下表中列出了 EJB 快取的可用統計資訊。

下表中列出了計時器的可用統計資訊。

Web 容器統計資訊

物件樹狀結構中包含了 Web 容器，如應用程式樹所示。系統為每個單獨的 Web 應用程式都顯示了 Web 容器統計資訊。Servlet 之 Web 容器的可用統計資訊列在表 18–7 中，Web 模組的可用統計資訊則顯示在表 18–8 中。

Web 容器統計資訊中列出了 Web 模組的可用統計資訊。

HTTP 服務統計資訊

下表顯示了開發者設定檔之 HTTP 服務的可用統計資訊。如需其他設定檔的 HTTP 服務的統計資訊，請參閱生產 Web 容器 (PWC) 統計資訊。

JDBC 連線池統計資訊

用於在執行階段監視 JDBC 資源，以測量效能並擷取資源使用情況。由於建立 JDBC 連線的成本很高並且常常會導致應用程式出現效能瓶頸問題，因此對 JDBC 連線池如何釋放和建立新連線以及正在等待從特定池中擷取連線的執行緒數的監視是至關重要的。

下表中列出了 JDBC 連線池的可用統計資訊。

JMS/連接器服務統計資訊

表 18–11 顯示了連接器連線池的可用統計資訊。表 18–12 顯示了連接器運作管理的統計資訊。

下表列出了連接器運作管理的可用統計資訊。

ORB 中連線管理程式的統計資訊

下表列出了 ORB 中連線管理員的可用統計資訊。

執行緒池統計資訊

下表中列出了執行緒池的可用統計資訊。

作業事件服務統計資訊

作業事件服務允許用戶端凍結作業事件子系統，以回復作業事件，並確定在凍結期間進行處理的作業事件。下表中列出了作業事件服務的可用統計資訊。

Java 虛擬機器 (JVM) 統計資訊

JVM 具有始終處於啟用狀態的可監視屬性。下表中列出了 JVM 的可用統計資訊。

Java SE 中的 JVM 統計資訊

利用 Java SE，可從 JVM 取得額外的監視資訊。將監視層級設定為 [低] 以啟用這些附加資訊的顯示。將監視層級設定為 [高] 還可以檢視與系統中每個活性執行緒相關的資訊。如需有關 Java SE 的附加監視功能的更多資訊，請參閱 http://java.sun.com/javase/6/docs/technotes/guides/management/ 中標題為「Monitoring and Management for the Java Platform」的文件。

以下網頁討論 Java SE 監視工具：http://java.sun.com/javase/6/docs/technotes/tools/#manage。

下表顯示 Java SE 中 JVM 類別載入作業的可用統計資訊。

下表顯示 Java SE 中 JVM 編譯的可用統計資訊。

下表顯示 Java SE 中 JVM 資源回收的可用統計資訊。

下表顯示 Java SE 中 JVM 記憶體的可用統計資訊。

下表顯示 Java SE 中 JVM 作業系統的可用統計資訊。

下表顯示 Java SE 中 JVM 執行階段的可用統計資訊。

下表顯示 Java SE 中 JVM ThreadInfo 的可用統計資訊。

下表顯示 Java SE 中 JVM 執行緒的可用統計資訊。

生產 Web 容器 (PWC) 統計資訊

下表說明下列 PWC 元件和服務的可用統計資訊。

這些統計資訊僅可供叢集和企業設定檔使用。

• 表 18–25

• 表 18–26

• 表 18–27

• 表 18–28

• 表 18–29

• 表 18–30

• 表 18–31

• 表 18–32

下表列出了 PWC 虛擬伺服器的統計資訊。

下表中列出了 PWC 請求的可用統計資訊。

快取資訊小節提供了有關目前檔案快取的使用方式的資訊。下表列出了 PWC 檔案快取的統計資訊。

本小節提供有關伺服器的 HTTP 層級持續作用的系統的資訊。下表中列出了 PWC 持續作用的可用統計資訊。

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

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

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

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

啟用與停用監視

本小節包含下列主題：

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

• 使用 asadmin 配置監視層級

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

在管理主控台中配置監視：

• 對於開發者設定檔，請移至 [配置] -> [監視]

• 對於叢集和企業設定檔，請移至 [配置] -> [配置] -> [監視]

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

如需配置監視的詳細資訊，請參閱管理主控台線上說明。

使用 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 工具檢視監視資料

在管理主控台中檢視監視資料

在開發者設定檔中，若要檢視監視資料，請移至 [Application Server] -> [監視]。

在叢集和企業設定檔中，若要檢視獨立實例的監視資料，請移至 [獨立實例] -> [實例] -> [監視]。若要檢視叢集實例的監視資料，請移至 [叢集] -> [叢集] -> [實例] -> [監視]。

您可以選取和檢視 JVM、伺服器、應用程式、執行緒池、HTTP 服務、作業事件服務、記錄統計資訊，以及呼叫流程統計資訊的監視資料。關於可監視物件的樹狀結構圖表說明這些元件和服務的組織方式。

如需有關檢視或配置監視的詳細資訊，請參閱管理主控台線上說明。

如需有關每個元件或服務之屬性的更多資訊，請參閱關於受監視的元件和服務的統計資訊。

使用 asadmin 工具檢視監視資料

本小節包含下列主題：

• 使用 asadmin monitor 指令檢視監視資料

• 使用 asadmin get 和 list 指令檢視監視資料

• 瞭解和指定含點名稱

• list 和 get 指令的範例

• list --user admin-user --monitor 指令的範例

• get --user admin-user --monitor 指令的範例

• 使用 PetStore 範例

• list 和 get 指令在所有層級上的預期輸出

使用 asadmin monitor 指令檢視監視資料

asadmin 具有兩種檢視監視資料的方法。第一種方法是使用 monitor 指令。此指令會列印經常監視的統計資訊，並可選擇篩選統計資訊，以及擷取輸出至「逗點分隔值 (CSV)」檔案。

1. 若要檢視監視資料，請使用 monitor 指令，並指定監視資料的類型：httplistener、keepalive、filecache、connectionqueue、jdbcpool、jvm、threadpool 、servlet、connection、connectorpool、endpoint、entitybean、messagedriven、statefulsession、statelesssession、httpservice 或 webmodule。

   例如，若要檢視 server 上的 jvm 的資料，請輸入下列指令：

   asadmin>monitor --type jvm --user adminuser server

   JVM Monitoring UpTime(ms) HeapSize(bytes) current min max low high count 327142979 0 531628032 0 45940736 45940736

2. 若要檢視監視資料，並將輸出傳送給 CSV 檔案，請使用 filename 選項。例如︰

   asadmin> monitor --type jvm --filename myoutputfile --user adminuser server

使用 asadmin get 和 list 指令檢視監視資料

monitor 指令在大多數情況下都很有用。不過，它並未提供所有可監視物件的完整清單。若要使用 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

嘗試從 Java EE 應用程式中取得所有屬性：

asadmin> get --user admin-user --monitor server.applications.myJavaEEApp.*

傳回：

No matches resulted from the wildcard expression.
CLI137 Command get failed.

該 Java-EE 應用程式層級上沒有可監視的屬性，因此顯示此回覆。

範例 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=4848

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 間連線的安全

• 將 JConsole 連線至 Application Server 的必要條件

• 將 JConsole 連線至 Application Server

• 以安全的方式將 JConsole 連線至 Application Server

Application Server 的管理 (管理與監視) 是以 JMX 技術為基礎的。這表示受管理的元件會以 Application Server 之 JVM 中執行的 MBeanServer 之 MBean 表示。

Java SE 5 增強 JVM 管理與監視功能的方法，是加入 Platform MBean Server 以及加入 MBean 來配置 VM。Application Server 會利用這些增強功能，並使用 Platform MBean Server 註冊其 MBean。因此 JMX 連接器用戶端可統一檢視 JVM MBean 以及 Application Server MBean。

為了檢視所有 MBean，Application Server 提供一個名為「系統 JMX 連接器伺服器」的標準 JMX 連接器伺服器配置。在 Application Server 啟動過程中，會啟動此 JMX 連接器伺服器的實例。任何相容的 JMX 連接器用戶端都可以使用此連接器伺服器連線到伺服器。

Java SE 也提供一項工具，可連線 MBean 伺服器及檢視註冊到此伺服器的 MBean。JConsole 就是其中一種常用的 JMX 連接器用戶端，並隨附在標準 Java SE 發行軟體中。如需有關 JConsole 的更多詳細資訊，請參閱 http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html

當您配置 JConsole 搭配 Application Server 使用時，Application Server 會成為 JMX 連接器的伺服器端，而 JConsole 會成為 JMX 連接器慣用的用戶端。將 JConsole 連線至 Application Servershows how to make a successful connection .

保護 JConsole 與 Application Server 間連線的安全

對 Application Server 或任何 JMX 連接器伺服器端的連線方式，會因連線的傳輸層安全性而有些許差異。若伺服器端是安全的 (保證傳輸層安全性)，則必須在客戶機端進行一些額外配置。

• 依預設，Application Server 的開發者設定檔是使用不安全的系統 JMX 連接器伺服器進行配置的。

• 依預設，Application Server 的叢集和企業設定檔是使用安全的系統 JMX 連接器伺服器進行配置的。

• 用於通訊的協定是 RMI/JRMP。若啟用了 JMX 連接器的安全性，則使用的協定是 RMI/JRMP over SSL。

  ---

  備註 –

  RMI over SSL 未提供額外的檢查，因此無法確定用戶端是否與預定的伺服器通訊。因此，使用 JConsole 時，可能會發生將使用者名稱與密碼傳送到惡意主機的情況。確認安全性是否受影響完全是管理員的責任。

  ---

當您在例如 appserver.sun.com 的機器上安裝開發者設定檔網域時，會在 Domain Administration Server (DAS) 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 6.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 與 VM 資訊等。

以安全的方式將 JConsole 連線至 Application Server

此程序說明在 JMX 連接器上啟用了安全性的情況下，如何將 JConsole 連線至 Application Server。依預設，會在 Application Server 叢集或企業設定檔上啟用安全性。若已在開發者設定檔的 JMX 連接器上啟用安全性，請使用此程序。

1. 在用戶端機器 (安裝 JConsole 的機器) 上安裝 Application Server。

   只有在需要讓 JConsole 知道您信任之 Domain Administration Server 的伺服器憑證位置時，才需要執行此步驟。若要取得該憑證，請呼叫至少一個 remote asadmin 指令 (為呼叫此指令，您必須在本機安裝 Application Server)。

2. 在 appserver.sun.com 上啟動 Application Server。

   由於這是叢集或企業網域，所以系統 JMX 連接器伺服器是安全的。若要在開發者設定檔 JMX 連接器上啟用安全性，請參閱管理主控台線上說明。

3. 從本機 Application Server 安裝中，執行 install-dir\bin\asadmin list --user admin --secure=true --host appserver.sun.com --port 4848 (其中，4848 是伺服器的管理連接埠)。

   雖然我們在此範例中選擇 asadmin list 指令，您仍可以執行任何遠端 asadmin 指令。系統會提示您接受 appserver.sun.com 之 DAS 所傳送的憑證。

4. 按下 y 接受 appserver.sun.com 之 DAS 所傳送的憑證。

   伺服器憑證會儲存在名為 .asadmintruststore 的檔案中 (此檔案位於用戶端機器的主目錄中)。

   ---

   備註 –

   若您的伺服器機器與用戶端機器是同一部 (也就是說，您也在 appserver.sun.com 上執行 JConsole)，則不需要執行此步驟。

   ---

5. 使用以下 JConsole 指令，讓 JConsole 知道信任清單存放區位置：

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

6. 執行 JDK_HOME/bin/jconsole 以啟動 JConsole

7. 在 JConsole 的 [連線至代理程式] 標籤中，輸入使用者名稱、密碼、主機名稱與連接埠 (預設為 8686)。

   使用者名稱指的是網域管理使用者名稱，密碼指的是網域管理密碼。

8. 按一下 [連線]。

   在 JConsole 視窗中，您將會在不同標籤中看到所有 MBean 與 VM 資訊等。