代理程式會自動配置為將記錄輸出儲存到一組自動重建的記錄檔中。這些記錄檔的所在目錄名稱,與相關聯代理程式之實例名稱相同 (請參閱附錄 AMessage QueueTM 資料的特定平台位置):
…/instances/instanceName/log
如果代理程式的生命週期由應用程式伺服器所控制,則記錄檔的位置是在啟動該代理程式所在網域的網域目錄子目錄中:
…/appServer_domainName_dir/imq/instances/imqbroker/log
記錄檔為簡單的文字檔案。其命名方式如下 (從最早建立到最新建立):
log.txt log_1.txt log_2.txt …log_9.txt
依預設,每週自動重建一次記錄檔;而系統會維護 9 個備份檔案。
若要變更保留記錄檔的目錄,請將特性 imq.log.file.dirpath 設定為所需的路徑。
若要將記錄檔的根名稱從 log 變更為其他名稱,請設定 imq.log.file.filename 特性。
代理程式支援三種記錄層級:ERROR、WARNING 、INFO。表 10–2 解釋各個層級的涵義。
表 10–2 記錄層級
層級 |
說明 |
---|---|
ERROR |
表示可導致系統故障問題的訊息。 |
WARNING |
應加以注意但不會導致系統故障的警示。 |
INFO |
度量和其他資訊性訊息的報告。 |
設定某個記錄層級,則會收集此層級以及所有更高層級的訊息。預設記錄層級是 INFO,因此依預設,ERROR、 WARNING 和 INFO 訊息會全部記錄。