撰寫應用程式來監視代理程式

Message Queue 提供度量監視功能，此功能可讓代理程式將度量資料寫入 JMS 訊息，然後根據訊息中包含的度量資訊類型，將資料傳送到其中一個度量主題目標。

您可以藉由寫入訂閱度量主題目標、使用目標中的訊息並處理訊息中度量資訊的用戶端應用程式，來存取此度量資訊。

總共有 5 個度量主題目標，表 10–6 中顯示這些目標的名稱，以及應傳送到每個目標的度量訊息類型。

設定訊息型監視

本小節描述使用訊息型監視功能以收集度量資訊的程序。程序包括用戶端部署和管理作業。

若要設定訊息型監視

1. 寫入度量監視用戶端。

   請參閱「Message Queue Developer's Guide for Java Clients」，瞭解如何以程式設計方式讓用戶端訂閱度量主題目標、使用度量訊息，以及從這些訊息擷取度量資料。

2. 設定 config.properties 檔案中的代理程式特性值，以配置代理程式的度量訊息產生者：

   1. 啟用度量訊息產生。

      設定 imq.metrics.topic.enabled=true

      預設為 true。

   2. 設定產生度量訊息的時間間隔 (以秒為單位)。

      設定 imq.metrics.topic.interval=interval。

      預設為 60 秒。

   3. 指定度量訊息是否為永久性訊息 (即訊息是否在代理程式故障後仍然存留)。

      設定 imq.metrics.topic.persist。

      預設為 false。

   4. 指定度量訊息刪除前，保留在其個別目標中的時間長短。

      設定 imq.metrics.topic.timetolive。

      預設值為 300 秒。

3. 設定任何您要在度量主題目標上的存取控制。

   請參閱以下安全性與存取注意事項中的說明。

4. 啟動度量監視用戶端。

   用戶訂閱度量主題時，即會自動建立度量主題目標。建立度量主題之後，代理程式度量訊息產生者就會開始傳送度量訊息到度量主題。

安全性與存取注意事項

有兩個限制度量主題目標存取的原因：

• 度量資料可能包含有關代理程式及其資源的機密資訊。

• 度量主題目標的訂閱數過量，可能會增加代理程式的經常性耗用時間，因此會對效能產生不良影響。

由於這些考量，所以建議您限制度量主題目標的存取。

監視用戶端必須遵守與其他用戶端相同的認證和授權控制。只有 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 章, 度量參照。