本章說明 Message QueueTM 訊息代理程式可提供用於監視、調校和診斷用途的度量資訊。此類資訊透過以下各種方式提供:
在記錄檔中 (請參閱將度量資料傳送到記錄檔)
透過指令公用程式的 metrics bkr 指令 (請參閱代理程式管理)
在傳送到度量主題目標的度量訊息中 (請參閱撰寫應用程式來監視代理程式)
本章中的表格列出可用度量資訊的種類,以及提供度量資訊的形式。對於透過指令公用程式之 metrics bkr 指令提供的度量,表格會列出可請求的度量類型;對於在度量訊息中提供的度量,表格會列出要將度量傳送到其中的度量主題目標。本章包含下列各節:
表 18–1 顯示代理程式為代理程式程序 JVM (Java 虛擬機器) 堆疊報告的度量資訊。
表 18–1 JVM 度量| 度量數目 | 說明 | 記錄檔? | metrics bkr 度量類型 | 度量主題 | 
|---|---|---|---|---|
| JVM 堆疊:記憶體總容量 | 目前的記憶體總容量 (以位元組為單位) | 是 | cxn | mq.metrics.jvm | 
| JVM 堆疊:可用記憶體 | 目前的可用記憶體容量 (以位元組為單位) | 是 | cxn | mq.metrics.jvm | 
| JVM 堆疊:最大記憶體 | 可允許的最大堆疊容量 (以位元組為單位) | 是 | 無 | mq.metrics.jvm | 
表 18–2 顯示代理程式報告的代理程式通用度量資訊。
表 18–2 代理程式通用度量| 度量數目 | 說明 | 記錄檔? | metrics bkr 度量類型 | 度量主題 | 
|---|---|---|---|---|
| 連線 | ||||
| 連線數目 | 所有連線服務的目前連線數目總數 | 是 | cxn | mq.metrics.broker | 
| 執行緒數目 | 所有連線服務的目前執行緒數目總數 | 是 | cxn | 無 | 
| 最小執行緒數目 | 所有連線服務的最小執行緒數目總數 | 是 | cxn | 無 | 
| 最大執行緒數目 | 所有連線服務的最大執行緒數目總數 | 是 | cxn | 無 | 
| 儲存的訊息 | ||||
| 訊息數目 | 目前儲存在記憶體和永久性存放區中的有效負載訊息數目 | 不需要 | mq.metrics.broker | |
| 訊息容量總數 | 目前儲存在記憶體和永久性存放區中的有效負載訊息容量總數 (以位元組為單位) | 不需要 | 無 | mq.metrics.broker | 
| 訊息流量 | ||||
| 傳入的訊息數目 | 自代理程式啟動後,累積的已接收有效負載訊息數目 | 是 | ttl | mq.metrics.broker | 
| 傳出的訊息數目 | 自代理程式啟動後,累積的已傳送有效負載訊息數目 | 是 | ttl | mq.metrics.broker | 
| 訊息傳入的速率 | 目前傳入代理程式的有效負載訊息流量速率 | 是 | rts | 無 | 
| 訊息傳出的速率 | 目前傳出代理程式的有效負載訊息流量速率 | 是 | rts | 無 | 
| 傳入的訊息容量 | 自代理程式啟動後,累積的已接收有效負載訊息容量 (以位元組為單位) | 是 | ttl | mq.metrics.broker | 
| 傳出的訊息容量 | 自代理程式啟動後,累積的已傳送有效負載訊息容量 (以位元組為單位) | 是 | ttl | mq.metrics.broker | 
| 訊息容量傳入的速率 | 目前傳入代理程式之有效負載訊息容量的流量速率 | 是 | rts | 無 | 
| 訊息容量傳出的速率 | 目前傳出代理程式之有效負載訊息容量的流量速率 | 是 | rts | 無 | 
| 傳入的資料封包數目 | 自代理程式啟動後,累積的已接收有效負載和控制資料封包數目 | 是 | ttl | mq.metrics.broker | 
| 傳出的資料封包數目 | 自代理程式啟動後,累積的已傳送有效負載和控制資料封包數目 | 是 | ttl | mq.metrics.broker | 
| 資料封包傳入的速率 | 目前傳入代理程式之有效負載和控制資料封包流量的速率 | 是 | rts | 無 | 
| 資料封包傳出的速率 | 目前傳出代理程式之有效負載和控制資料封包流量的速率 | 是 | rts | 無 | 
| 傳入的資料封包容量 | 自代理程式啟動後,累積的已接收有效負載和控制資料封包容量 (以位元組為單位) | 是 | ttl | mq.metrics.broker | 
| 傳出的資料封包容量 | 自代理程式啟動後,累積的已傳送有效負載和控制資料封包容量 (以位元組為單位) | 是 | ttl | mq.metrics.broker | 
| 資料封包容量傳入的速率 | 目前傳入代理程式之有效負載和控制資料封包容量的流量速率 | 是 | rts | 無 | 
| 資料封包容量傳出的速率 | 目前傳出代理程式之有效負載和控制資料封包容量的流量速率 | 是 | rts | 無 | 
| 目標 | ||||
| 目標數目 | 目前的實體目標數目 | 不需要 | 無 | mq.metrics.broker | 
表 18–3 顯示代理程式報告的個別連線服務之度量資訊。
表 18–3 連線服務度量| 度量數目 | 說明 | 記錄檔? | metrics svc 度量類型 | 度量主題 | 
|---|---|---|---|---|
| 連線 | ||||
| 連線數目 | 目前的連線數目 | 不需要 | 無 | |
| 執行緒數目 | 目前的執行緒數目 | 不需要 | cxn | 無 | 
| 最小執行緒數目 | 指定給服務的最小執行緒數目 | 不需要 | cxn | 無 | 
| 最大執行緒數目 | 指定給服務的最大執行緒數目 | 不需要 | cxn | 無 | 
| 訊息流量 | ||||
| 傳入的訊息數目 | 自代理程式啟動後,透過連線服務接收的累積有效負載訊息數目 | 不需要 | ttl | 無 | 
| 傳出的訊息數目 | 自代理程式啟動後,透過連線服務傳送的累積有效負載訊息數目 | 不需要 | ttl | 無 | 
| 訊息傳入的速率 | 目前透過連線服務傳入代理程式的有效負載訊息流量速率 | 不需要 | rts | 無 | 
| 訊息傳出的速率 | 目前透過連線服務傳出代理程式的有效負載訊息流量速率 | 不需要 | rts | 無 | 
| 傳入的訊息容量 | 自代理程式啟動後,透過連線服務接收的累積有效負載訊息容量 (以位元組為單位) | 不需要 | ttl | 無 | 
| 傳出的訊息容量 | 自代理程式啟動後,透過連線服務傳送的累積有效負載訊息容量 (以位元組為單位) | 不需要 | ttl | 無 | 
| 訊息容量傳入的速率 | 目前透過連線服務傳入代理程式之有效負載訊息容量的流量速率 | 不需要 | rts | 無 | 
| 訊息容量傳出的速率 | 目前透過連線服務傳出代理程式之有效負載訊息容量的流量速率 | 不需要 | rts | 無 | 
| 傳入的資料封包數目 | 自代理程式啟動後,透過連線服務接收的累積有效負載和控制資料封包數目 | 不需要 | ttl | 無 | 
| 傳出的資料封包數目 | 自代理程式啟動後,透過連線服務傳送的累積有效負載和控制資料封包數目 | 不需要 | ttl | 無 | 
| 資料封包傳入的速率 | 目前透過連線服務傳入代理程式之有效負載和控制資料封包的流量速率 | 不需要 | rts | 無 | 
| 資料封包傳出的速率 | 目前透過連線服務傳出代理程式之有效負載和控制資料封包的流量速率 | 不需要 | rts | 無 | 
| 傳入的資料封包容量 | 自代理程式啟動後,透過連線服務接收之有效負載和控制資料封包的累積容量 (以位元組為單位) | 不需要 | ttl | 無 | 
| 傳出的資料封包容量 | 自代理程式啟動後,透過連線服務傳送之有效負載和控制資料封包的累積容量 (以位元組為單位) | 不需要 | ttl | 無 | 
| 資料封包容量傳入的速率 | 目前透過連線服務傳入代理程式之有效負載和控制資料封包容量的流量速率 | 不需要 | rts | 無 | 
| 資料封包容量傳出的速率 | 目前透過連線服務傳出代理程式之有效負載和控制資料封包容量的流量速率 | 不需要 | rts | 無 | 
表 18–4 顯示代理程式報告的個別目標之度量資訊。
表 18–4 目標度量| 度量數目 | 說明 | 記錄檔? | metrics dst 度量類型 | 度量主題 | 
|---|---|---|---|---|
| 訊息用戶 | ||||
| 用戶數目 | 目前所關聯的訊息用戶數目 對於佇列目標,此屬性包含使用中用戶和備份用戶。對於主題目標,它包含非長期訂閱者和 (使用中及非使用中的) 長期訂閱者,等於「使用中用戶的數目」。 | 不需要 | con | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 用戶的尖峰數目 | 自代理程式啟動後,所關聯訊息用戶的尖峰數目 對於佇列目標,此屬性包含使用中用戶和備份用戶。對於主題目標,它包含非長期訂閱者和 (使用中及非使用中的) 長期訂閱者,等於「使用中用戶的尖峰數目」。 | 不需要 | con | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 用戶的平均數目 | 自代理程式啟動後,所關聯訊息用戶的平均數目 對於佇列目標,此屬性包含使用中用戶和備份用戶。對於主題目標,它包含非長期訂閱者和 (使用中及非使用中的) 長期訂閱者,等於「使用中用戶的平均數目」。 | 不需要 | con | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 使用中用戶的數目 | 目前所關聯的使用中訊息用戶數目 對於主題目標,此屬性包含非長期訂閱者和 (使用中及非使用中的) 長期訂閱者,等於「用戶數目」。 | 不需要 | con | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 使用中用戶的尖峰數目 | 自代理程式啟動後,所關聯使用中訊息用戶的尖峰數目 對於主題目標,此屬性包含非長期訂閱者和 (使用中及非使用中的) 長期訂閱者,等於「用戶的尖峰數目」。 | 不需要 | con | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 使用中用戶的平均數目 | 自代理程式啟動後,所關聯使用中訊息用戶的平均數目 對於主題目標,此屬性包含非長期訂閱者和 (使用中及非使用中的) 長期訂閱者,等於「用戶的平均數目」。 | 不需要 | con | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 目前所關聯的備份訊息用戶數目 | 不需要 | con | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | |
| 備份用戶的尖峰數目 | 自代理程式啟動後,所關聯備份訊息用戶的尖峰數目 | 不需要 | con | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 備份用戶的平均數目 | 自代理程式啟動後,所關聯備份訊息用戶的平均數目 | 不需要 | con | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 儲存的訊息 | ||||
| 訊息數目 | 目前儲存在記憶體和永久性存放區中的訊息數目 | 不需要 | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | |
| 訊息尖峰數目 | 自代理程式啟動後,儲存在記憶體和永久性存放區中之訊息的尖峰數目 | 不需要 | conttlrts | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 訊息平均數目 | 自代理程式啟動後,儲存在記憶體和永久性存放區中之訊息的平均數目 | 不需要 | conttlrts | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 訊息容量總數 | 目前儲存在記憶體和永久性存放區中之訊息的容量總數 (以位元組為單位) | 不需要 | ttlrts | mq.metrics.destination.queue.queueName mq.metrics.destination.topic.topicName | 
| 訊息的尖峰容量總數 | 自代理程式啟動後,儲存在記憶體和永久性存放區中之訊息的尖峰容量總數 (以位元組為單位) | 不需要 | ttlrts | mq.metrics.destination.queue.queueName mq.metrics.destination.topic.topicName | 
| 訊息的平均容量 | 自代理程式啟動後,儲存在記憶體和永久性存放區中之訊息的平均容量總數 (以位元組為單位) | 不需要 | ttlrts | mq.metrics.destination.queue.queueName mq.metrics.destination.topic.topicName | 
| 訊息流量 | ||||
| 傳入的訊息數目 | 自代理程式啟動後,累積的已接收訊息數目 | 不需要 | ttl | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 傳出的訊息數目 | 自代理程式啟動後,累積的已傳送訊息數目 | 不需要 | ttl | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 傳入的訊息容量 | 自代理程式啟動後,累積的已接收訊息容量 (以位元組為單位) | 不需要 | ttl | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 傳出的訊息容量 | 自代理程式啟動後,累積的已傳送訊息容量 (以位元組為單位) | 不需要 | ttl | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 訊息的尖峰容量 | 自代理程式啟動後,所接收的最大單一訊息的容量 (以位元組為單位) | 不需要 | ttlrts | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 訊息傳入的速率 | 目前已接收訊息流量的速率 | 不需要 | rts | 無 | 
| 訊息傳出的速率 | 目前已傳送訊息流量的速率 | 不需要 | rts | 無 | 
| 訊息容量傳入的速率 | 目前已接收訊息容量的流量速率 | 不需要 | rts | 無 | 
| 訊息容量傳出的速率 | 目前已傳送訊息容量的流量速率 | 不需要 | rts | 無 | 
| 磁碟使用 | ||||
| 為目標保留的磁碟空間 (以位元組為單位) | 不需要 | dsk | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | |
| 已使用的磁碟 | 目前目標所使用的磁碟空間 (以位元組為單位) | 不需要 | dsk | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName | 
| 磁碟使用率 | 為目標保留之磁碟空間的磁碟使用率 | 不需要 | dsk | mq.metrics.destination.queue. queueNamemq.metrics.destination.topic. topicName |