Message Queue 提供度量監視功能,此功能可讓代理程式將度量資料寫入 JMS 訊息,然後根據訊息中包含的度量資訊類型,將資料傳送到其中一個度量主題目標。
您可以藉由寫入訂閱度量主題目標、使用目標中的訊息並處理訊息中度量資訊的用戶端應用程式,來存取此度量資訊。
總共有 5 個度量主題目標,表 10–6 中顯示這些目標的名稱,以及應傳送到每個目標的度量訊息類型。
表 10–6 度量主題目標
主題名稱 | |
---|---|
mq.metrics.broker | |
mq.metrics.jvm | |
mq.metrics.destination_list | |
mq.metrics.destination.queue.monitoredDestinationName |
用於指定名稱之佇列的目標度量 |
mq.metrics.destination.topic.monitoredDestinationName |
用於指定名稱之主題的目標度量 |
本小節描述使用訊息型監視功能以收集度量資訊的程序。程序包括用戶端部署和管理作業。
寫入度量監視用戶端。
請參閱「Message Queue Developer's Guide for Java Clients」,瞭解如何以程式設計方式讓用戶端訂閱度量主題目標、使用度量訊息,以及從這些訊息擷取度量資料。
設定 config.properties 檔案中的代理程式特性值,以配置代理程式的度量訊息產生者:
設定任何您要在度量主題目標上的存取控制。
請參閱以下安全性與存取注意事項中的說明。
啟動度量監視用戶端。
用戶訂閱度量主題時,即會自動建立度量主題目標。建立度量主題之後,代理程式度量訊息產生者就會開始傳送度量訊息到度量主題。
有兩個限制度量主題目標存取的原因:
度量資料可能包含有關代理程式及其資源的機密資訊。
度量主題目標的訂閱數過量,可能會增加代理程式的經常性耗用時間,因此會對效能產生不良影響。
由於這些考量,所以建議您限制度量主題目標的存取。
監視用戶端必須遵守與其他用戶端相同的認證和授權控制。只有 Message Queue 使用者儲存庫中的使用者可以連線到代理程式。
您可以使用存取控制特性檔案來限制對於特定度量主題目標的存取,以提供額外保護,如使用者授權:存取控制特性檔案中所述。
例如,以下 accesscontrol.properties 檔案中的項目會拒絕任何使用者存取 mq.metrics.broker 度量主題,但 user1 和 user 2 除外。
topic.mq.metrics.broker.consume.deny.user=* topic.mq.metrics.broker.consume.allow.user=user1,user2 |
以下項目僅允許使用者 user3 監視主題 t1。
topic.mq.metrics.destination.topic.t1.consume.deny.user=* topic.mq.metrics.destination.topic.t1.consume.allow.user=user3 |
您也可以根據度量資料的機密程度,使用加密連線將度量監視用戶端連線到代理程式。如需有關使用加密連線的資訊,請參閱訊息加密。
使用訊息型監視 API 取得度量資料輸出,是您編寫度量監視用戶端需具備的功能之一。您僅受限於代理程式中度量產生器提供的資料。如需此資料的完整清單,請參閱第 18 章, 度量參照。