監視服務

代理程式包含可監視和診斷應用程式和代理程式效能的元件。這些元件包括：

• 產生資料的元件，即度量產生器與記錄事件的代理程式程式碼

• 記錄程式元件，可將輸出資訊寫入到多個輸出通道

• 度量訊息產生者，可將包含度量資訊的 JMS 訊息傳送到主題目標，以供 JMS 監視用戶端使用

圖 4–3 說明一般方案。用以配置監視服務的代理程式特性，列於檢視特性中。

圖 4–3 監視支援

度量產生器

度量產生器可提供代理程式作業的相關資訊，例如傳入和傳出代理程式的訊息流量、代理程式記憶體中的訊息數量和使用的記憶體、開啟連線的數量，以及使用的執行緒數量。布林值代理程式特性 imq.metrics.enabled 可控制是否記錄此類資訊；imq.metrics.interval 則指定記錄的頻率。

記錄程式

記錄程式會擷取代理程式程式碼與度量產生器所產生的資訊，並將此資訊寫入標準輸出 (主控台)、記錄檔；若在 Solaris 平台上，在發生錯誤時則會寫入 syslog 常駐程式程序。 imq.log.file.dirpath 與 imq.log.file.filename 代理程式特性會指定要使用的記錄檔；imq.log.console.stream 會指定主控台輸出應導向 stdout 還是 stderr。

imq.log.level 特性可控制記錄程式所收集的度量資訊種類：ERROR、WARNING 或 INFO。每個層級都會包含更高的層級，因此，若您指定 WARNING 作為記錄層級，則也會記錄錯誤訊息。imq.log.console.output 與 imq.log.file.output 特性分別控制哪些指定的種類會寫入主控台與記錄檔。但在此情況下，種類不包含比自身更高的層級；例如，如果要將錯誤與警告寫入記錄檔，且將參考訊息寫入主控台時，必須明確將 imq.log.file.output 設為 ERROR|WARNING，將 imq.log.console.output 設為 INFO。在 Solaris 平台上有另一個特性 imq.log.syslog.output，可指定要寫入 syslog 常駐程式的度量資訊種類。另外還有 imq.destination.logDeadMsgs 特性，可指定在停用的訊息被捨棄或移至停用的訊息佇列時，是否要加以記錄。

對於記錄檔，您可以指定何時關閉該檔案並將輸出自動重建至新的記錄檔。一旦記錄檔達到指定的大小 (imq.log.file.rolloverbytes) 或存在時間 (imq.log.file.rolloversecs)，就會將其儲存並建立新的記錄檔。

請參閱檢視特性，以瞭解與記錄有關的其他代理程式特性，並參閱配置及使用代理程式記錄功能，以進一步瞭解如何配置記錄程式，以及如何利用記錄程式取得效能資訊。

度量訊息產生者 (企業版)

度量訊息產生者會在固定時間間隔接收度量產生器傳送的資訊，並將資訊寫入度量訊息，接著根據訊息中包含的度量資訊類型，將訊息傳送到其中一個度量主題目標 (請參閱表 4–2)。訂閱這些度量主題目標的 Message Queue 用戶端，可以使用這些訊息並處理訊息所包含的度量資料。這允許開發者建立自訂監視工具以支援訊息傳送應用程式。如需每個度量訊息類型中所報告之度量數目的詳細資訊，請參閱「Message Queue Developer's Guide for Java Clients」。

代理程式特性 imq.metrics.topic.enabled 與 imq.metrics.topic.interval，可分別控制訊息是否要傳送到度量主題目標及傳送的頻率。imq.metrics.topic.timetolive 與 imq.metrics.topic.persist 特性可指定此類訊息的使用期限及其是否具有永久性。

除了度量訊息內文包含的資訊外，每個訊息的標頭還包含提供下列額外資訊的特性：

• 訊息類型

• 傳送訊息之代理程式的位址 (主機名稱與連接埠號)

• 度量範例需要的時間

這些特性對處理不同類型或不同代理程式的度量訊息之用戶端應用程式十分有用。