Sun Java System Application Server 9.1 管理指南

檢視監視資料

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

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

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

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

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

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

使用 asadmin 工具檢視監視資料

本小節包含下列主題：

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

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

若要檢視監視資料，請使用 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

若要檢視監視資料，並將輸出傳送給 CSV 檔案，請使用 filename 選項。例如︰
asadmin> monitor --type jvm --filename myoutputfile --user adminuser server

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

monitor 指令在大多數情況下都很有用。不過，它並未提供所有可監視物件的完整清單。若要使用 asadmin 工具檢視所有可監視資料，請使用 asadmin list 和 asadmin get 指令，後面跟著可監視物件的帶點名稱，方法如下。

若要檢視可監視物件的名稱，請使用 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 指令配合使用之帶點名稱的更多資訊，請參閱瞭解和指定含點名稱。

若要顯示已啟用監視功能的應用程式元件或子系統的監視統計資訊，請使用 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 指令的範例

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 指令，即可存取所需的方法統計資訊。

啟動 Application Server 和 asadmin 工具。

設定一些有用的環境變數，以避免為每個指令均輸入這些變數：

asadmin> export AS_ADMIN_USER=admin AS_ADMIN_PASSWORD=admin123
asadmin>export AS_ADMIN_HOST=localhost AS_ADMIN_PORT=4848

列出實例 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。

列出 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

列出 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

列出 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

列出實體 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*".

該方法沒有可監視的子元件。取得 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

如果還需要取得執行時間等特定統計資訊，請使用如下指令：

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 指令在所有層級上的預期輸出

下表顯示了樹的各個層級的指令、含點名稱及相應的輸出。

表 18–33 頂層

指令

含點名稱

輸出

list -m

server

server.applicationsserver.thread-poolsserver.
resourcesserver.http-serviceserver.transaction-
serviceserver.orb.connection-managersserver.orb.
connection-managers.orb\.Connections\.Inbound\.
AcceptedConnectionsserver.jvm

list -m

server.*

此節點下的子節點的階層結構。

get -m

server.*

無輸出，但顯示一條訊息，說明此節點上沒有屬性。

下表列出了應用程式層級的指令、帶點名稱及對應的輸出。

表 18–34 應用程式層級

指令

含點名稱

輸出

list -m

server.applications

或

*applications

appl1app2web-module1_warejb-module2_jar...

list -m

server.applications.*

或

*applications.*

此節點下的子節點的階層結構。

get -m

server.applications.*

或

*applications.*

無輸出，但顯示一條訊息，說明此節點上沒有屬性。

下表列出了應用程式層級上的獨立模組和企業應用程式的指令、帶點名稱及對應的輸出。

表 18–35 應用程式 - 企業應用程式和獨立模組

指令

含點名稱

輸出

list -m

server.applications.app1

或

*app1

備註︰僅在已部署企業應用程式之後，此層級才可用。如果部署了獨立模組，則此層級不可用。

ejb-module1_jarweb-module2_warejb-module3 _jarweb-module3_war...

list -m

server.applications.app1.*

或

*app1.*

此節點下的子節點的階層結構。

get -m

server.applications.app1.*

或

*app1.*

無輸出，但顯示一條訊息，說明此節點上沒有屬性。

list -m

server.applications.app1.ejb-module1_jar

或

*ejb-module1_jar

或

server.applications.ejb-module1_jar

bean1bean2bean3...

list -m

server.applications.app1.ejb-module1_jar

或

*ejb-module1_jar

或

server.applications.ejb-module1_jar

此節點下的子節點的階層結構。

get -m

server.applications.app1.ejb-module1_jar.*

或

*ejb-module1_jar.*

或

server.applications.ejb-module1_jar.*

無輸出，但顯示一條訊息，說明此節點上沒有屬性。

list -m

server.applications.app1.ejb-module1 _jar.bean1