Message Queue 代理程式可以報告下列類型的度量:
Java 虛擬機器 (JVM) 度量。有關 JVM 堆疊容量的資訊。
代理程式通用度量。有關儲存於代理程式中的訊息、輸入和輸出代理程式的訊息流量,以及記憶體用途的資訊。追蹤訊息的數量和位元組數。
連線服務度量。有關連線和連線執行緒資源的資訊,以及有關特定連線服務訊息流量的資訊。
目標度量。有關傳入和傳出特定實體目標之訊息流量的資訊,以及有關實體目標用戶、記憶體和磁碟空間使用率的資訊。
imqcmd 指令可以取得整個代理程式、個別連線服務和個別實體目標的度量資訊。若要取得度量資料,通常可使用 imqcmd 的子指令 metrics。度量資料會依您指定的時間間隔或次數寫入主控台畫面。
您也可以使用 query 子指令,檢視也包含配置資訊的類似資料。如需更多資訊,請參閱imqcmd query。
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 子指令選項
本小節描述使用 metrics 子指令報告度量資訊的程序。
本小節包含 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 |
表 10–5 中顯示 imqcmd query 的語法和選項,以及該指令所提供之度量資料的說明。
表 10–5 imqcmd query 子指令語法
子指令語法 |
提供的度量資料 |
|
---|---|---|
|
有關目前儲存於代理程式記憶體與永久性存放區中的訊息數目和訊息容量等資訊 (請參閱顯示代理程式資訊)。 |
|
或 | ||
|
有關目前所指定連線服務的已配置執行緒數目和連線數目等資訊 (請參閱顯示連線服務資訊)。 |
|
或 | ||
|
有關目前所指定目標的產生器、使用中用戶和備份用戶,以及儲存在記憶體和永久性存放區中的訊息和訊息容量等數目資訊 (請參閱顯示實體目標資訊)。 |
由於 imqcmd query 提供的度量資料有限,因此未在第 18 章, 度量參照的表格中列出此工具。