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

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

• 使用 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 層級的指令、帶點名稱及對應的輸出。