test

Sun Java System Message Queue 3.7 UR1 管理指南

以互動方式顯示度量

Message Queue 代理程式可以報告下列類型的度量：

imqcmd 指令可以取得整個代理程式、個別連線服務和個別實體目標的度量資訊。若要取得度量資料，通常可使用 imqcmd 的子指令 metrics。度量資料會依您指定的時間間隔或次數寫入主控台畫面。

您也可以使用 query 子指令，檢視也包含配置資訊的類似資料。如需更多資訊，請參閱imqcmd query。

imqcmd metrics

imqcmd metrics 的語法和選項分別顯示於表 10–3 和表 10–4 中。

表 10–3 imqcmd metrics 子指令語法

子指令語法 

提供的度量資料 

 
metrics bkr
   [-b hostName:portNumber]
   [-m metricType]
   [-int interval]
   [-msp numSamples]

顯示預設代理程式或指定主機和連接埠上的代理程式的代理程式度量。 

 
metrics svc -n serviceName
   [-b hostName:portNumber]
   [-m metricType]
   [-int interval]
   [-msp numSamples]

顯示預設代理程式或指定主機和連接埠上的代理程式上的指定服務之標準資訊。 

 
metrics dst -t destType
   -n destName
   [-b hostName:portNumber]
   [-m metricType]
   [-int interval]
   [-msp numSamples]

顯示指定類型和名稱的實體目標之度量資訊。

表 10–4 imqcmd metrics 子指令選項

子指令選項 

說明 

 
-b hostName: portNumber

指定報告度量資訊之代理程式的主機名稱和連接埠。預設值為 localhost:7676。

 
-int interval

指定顯示度量的時間間隔 (以秒為單位)。預設為 5 秒鐘。 

 
-m metricType

指定要顯示的度量類型： 

ttl 顯示傳入和傳出代理程式、服務或目標的訊息與資料封包等度量 (預設度量類型)。

rts 顯示傳入和傳出代理程式、連線服務或目標的訊息和資料封包等流量速率度量 (每秒)。

cxn 顯示連線、虛擬記憶體堆疊和執行緒 (僅限代理程式和連線服務)。

con 顯示用戶相關的度量 (僅限目標)。

dsk 顯示磁碟使用率度量 (僅限目標)。

 
-msp numSamples

指定顯示在輸出中的範例數目。預設的數目為沒有限制 (無限)。 

 
-n destName

指定要針對其度量資料進行報告的實體目標 (如果存在) 名稱。沒有預設值。 

 
-n serviceName

指定要針對其度量資料進行報告的連線服務 (如果存在)。沒有預設值。 

 
-t destType

指定要針對其度量資料進行報告的實體目標 (如果存在) 類型 (佇列或主題)。沒有預設值。 

使用顯示度量資料的 metrics 子指令

本小節描述使用 metrics 子指令報告度量資訊的程序。

Procedure使用 metrics 子指令

  1. 啟動需要度量資訊的代理程式。

    請參閱啟動代理程式。

  2. 發出適當的 imqcmd metrics 子指令和選項，如表 10–3 和表 10–4 中所示。

度量輸出：imqcmd 度量

本小節包含 imqcmd metrics 子指令的輸出範例。這些範例顯示代理程式範圍、連線服務和實體目標度量。

代理程式通用度量

若要取得訊息和封裝每隔 10 秒傳入和傳出代理程式的速率，請使用 metrics bkr 子指令：

imqcmd metrics bkr -m rts -int 10 -u admin

此指令會產生與以下相類似的輸出 (請參閱表 18–2 中的資料說明)：


--------------------------------------------------------
 Msgs/sec   Msg Bytes/sec   Pkts/sec    Pkt Bytes/sec   
 In   Out     In      Out     In   Out     In      Out  
--------------------------------------------------------
 0     0      27      56      0     0      38      66   
 10    0     7365     56      10    10    7457    1132  
 0     0      27      56      0     0      38      73   
 0     10     27     7402     10    20    1400    8459  
 0     0      27      56      0     0      38      73

連線服務度量

若要取得 jms 連線服務所處理的訊息和資料封包等累積總數，請使用 metrics svc 子指令：

imqcmd metrics svc -n jms -m ttl -u admin

此指令會產生與以下相類似的輸出 (請參閱表 18–3 中的資料說明)：


-------------------------------------------------
  Msgs      Msg Bytes      Pkts      Pkt Bytes     
In   Out    In     Out   In   Out    In     Out  
-------------------------------------------------
164  100  120704  73600  282  383  135967  102127
657  100  483552  73600  775  876  498815  149948

實體目標度量

若要取得有關實體目標的度量資訊，請使用 metrics dst 子指令：

imqcmd metrics dst -t q -n XQueue -m ttl -u admin

此指令會產生與以下相類似的輸出 (請參閱表 18–4 中的資料說明)：


-----------------------------------------------------------------------------
  Msgs      Msg Bytes         Msg Count         Total Msg Bytes (k)     Largest
In   Out    In     Out    Current  Peak  Avg  Current  Peak     Avg    Msg (k)
-----------------------------------------------------------------------------
200  200  147200  147200     0     200    0      0      143      71        0  
300  200  220800  147200    100    200   10     71      143      64        0  
300  300  220800  220800     0     200    0      0      143      59        0

若要取得有關實體目標的用戶資訊，請使用以下 metrics dst 子指令：

imqcmd metrics dst -t q -n SimpleQueue -m con -u admin

此指令會產生與以下相類似的輸出 (請參閱表 18–4 中的資料說明)：


------------------------------------------------------------------
  Active Consumers         Backup Consumers         Msg Count
Current  Peak  Avg      Current  Peak    Avg    Current  Peak  Avg
------------------------------------------------------------------
   1       1      0        0       0      0       944    1000  525

imqcmd query

表 10–5 中顯示 imqcmd query 的語法和選項，以及該指令所提供之度量資料的說明。

表 10–5 imqcmd query 子指令語法

子指令語法 

提供的度量資料 

 

query bkr
   [-b hostName: portNumber]

有關目前儲存於代理程式記憶體與永久性存放區中的訊息數目和訊息容量等資訊 (請參閱顯示代理程式資訊)。

或 

  

query svc -n serviceName
  [-b  hostName:portNumber]

有關目前所指定連線服務的已配置執行緒數目和連線數目等資訊 (請參閱顯示連線服務資訊)。

或 

  

query dst -t destType
  -n destName
  [-b hostName:portNumber]

有關目前所指定目標的產生器、使用中用戶和備份用戶，以及儲存在記憶體和永久性存放區中的訊息和訊息容量等數目資訊 (請參閱顯示實體目標資訊)。

備註 –

由於 imqcmd query 提供的度量資料有限，因此未在第 18 章, 度量參照的表格中列出此工具。