表 14–8 描述記錄的相關特性。
設定記錄層級。
為一個或多個記錄種類設定輸出通道 (檔案和/或主控台)。
如果您將輸出記錄至檔案,請為此檔案配置自動重建準則。
可以透過設定記錄程式特性來完成這些步驟。您可以用以下兩種方法之一執行此作業:
在指令行上傳送的選項,會置換在代理程式實例配置檔案中所指定的特性。以下的 imqbrokerd 選項會影響記錄:
代理程式度量的記錄時間間隔 (以秒為單位)
記錄層級 (ERROR、WARNING、 INFO 或 NONE)
無訊息模式 (不記錄至主控台)
將所有訊息記錄至主控台
以下各節描述如何變更預設配置,以執行以下作業:
變更輸出通道 (記錄訊息的目標)
變更自動重建準則
依預設,錯誤和警告訊息可顯示在終端機上,也可記錄至記錄檔中。(在 Solaris 上,錯誤訊息也可寫入至系統的 syslog 常駐程式。)
您可以用以下方法變更記錄訊息的輸出通道:
若要使所有記錄種類 (對於指定的層級) 輸出顯示在畫面上,請使用 imqbrokerd 指令的 -tty 選項。
若要避免記錄輸出顯示在畫面上,請使用 imqbrokerd 指令的 -silent 選項。
使用 imq.log.file.output 特性,指定應寫入至記錄檔的記錄資訊種類。例如:
imq.log.file.output=ERROR
使用 imq.log.console.output 特性,指定應寫入至主控台的記錄資訊種類。例如:
imq.log.console.output=INFO
在 Solaris 上,使用 imq.log.syslog.output 特性,指定應寫入至 Solaris syslog 的記錄資訊種類。例如:
imq.log.syslog.output=NONE
變更記錄程式輸出通道前,您必須確定所設定的記錄層級,支援要對映到輸出通道的資訊。例如,如果您將記錄層級設定為 ERROR,並且將 imq.log.console.output 特性設定為 WARNING,則不會記錄任何訊息,因為您未啟用 WARNING 訊息的記錄。
有兩個記錄檔自動重建準則:時間和容量。預設為使用時間準則,每七天自動重建一次檔案。
若要變更時間間隔,您需要變更特性 imq.log.file.rolloversecs。例如,以下特性定義將時間間隔變更為十天:
imq.log.file.rolloversecs=864000
若要將自動重建準則變更為取決於檔案容量,您需要設定 imq.log.file.rolloverbytes 特性。例如,以下定義會讓代理程式在檔案達到 500,000 個位元組的限制時,就自動重建檔案。
imq.log.file.rolloverbytes=500000
如果同時設定與時間相關的自動重建特性以及與容量相關的自動重建特性,則先達到的限制將觸發自動重建作業。如上所述,代理程式最多可保留九個自動重建檔案。
代理程式執行時,您可以設定或變更記錄檔自動重建特性。若要設定這些特性,請使用 imqcmd update bkr 指令。
本節描述使用代理程式記錄檔報告度量資訊的程序。如需有關配置記錄程式的一般資訊,請參閱配置及使用代理程式記錄功能。
配置代理程式的度量產生功能:
確定記錄程式已收集度量資訊:
imq.log.level=INFO |
這是預設值。啟動代理程式時,您可以在 config.properties 檔案中設定此值,或使用 -loglevel level 指令行選項設定此值。
確定已設定記錄程式,將度量資訊寫入記錄檔:
imq.log.file.output=INFO |
這是預設值。您可以在 config.properties 檔案中進行設定。
啟動代理程式。
[21/Jul/2004:11:21:18 PDT] Connections: 0 JVM Heap: 8323072 bytes (7226576 free) Threads: 0 (14-1010) In: 0 msgs (0bytes) 0 pkts (0 bytes) Out: 0 msgs (0bytes) 0 pkts (0 bytes) Rate In: 0 msgs/sec (0 bytes/sec) 0 pkts/sec (0 bytes/sec) Rate Out: 0 msgs/sec (0 bytes/sec) 0 pkts/sec (0 bytes/sec) |
如需有關度量資料的參考資訊,請參閱第 18 章, 度量參照。
您可以啟用代理程式停用的訊息之記錄功能來監視實體目標。無論您有沒有使用此停用的訊息佇列,都可以記錄這些停用的訊息。
啟用此停用的訊息之記錄功能後,代理程式會記錄下列類型的事件:
如果停用的訊息佇列在使用中,還會記錄下列類型的事件:
代理程式將訊息移動到停用的訊息佇列。
代理程式將停用的訊息佇列中的訊息移除並且捨棄。
[29/Mar/2006:15:35:39 PST] [B1147]: Message 8-129.145.180.87(e7:6b:dd:5d:98:aa)- 35251-1143675279400 from destination Q:q0 has been placed on the DMQ because [B0053]: Message on destination Q:q0 Expired: expiration time 1143675279402, arrival time 1143675279401, JMSTimestamp 1143675279400 |
依預設,不記錄停用的訊息。若要記錄,請設定代理程式屬性 imq.destination.logDeadMsgs。