日誌記載

如果您遇到錯誤或異常狀況,可以使用日誌檔來探究問題並尋找解決方法。日誌檔名稱是 qm.logccm.logrelm.logjts.logadmin.logvvc.logrs.log

Rational Engineering Lifecycle Manager 中的日誌記載

如果您是在 Tomcat 伺服器上執行應用程式,預設日誌檔位置為 Install Dir/server/logs

如果您是在 WebSphere® Application Server 上執行應用程式,xx.log 檔的預設位置是 WAS_Install_Dir/server/profiles/<profile_name>/logs

日誌檔的位置是由 JAZZ_HOME/xx 目錄中的 log4j.properties 檔所決定。xx.log 檔的預設值是 log4j.appender.logfile.File=logs/xx.log。例如,jts.log 檔的預設值是 log4j.appender.file.File=logs/jts.log

記載和追蹤是在相同位置(即 <RelmInstallDir>/server/conf/relm/log4j.properties 配置檔)中加以配置。這個檔案會在伺服器啟動時載入,或者會透過呼叫特殊的管理作業來隨需(動態)載入。在任何變更後,必須重新載入,所做的變更才會生效。

藉由修改 log4j.properties,您可以:
  • 記載層次:關閉、嚴重、錯誤、警告、參考資訊、除錯、追蹤、全部。預設值是 WARN
  • 日誌大小和折返原則
  • 要記載哪些元件。
如需相關資訊,請參閱 Apache log4j 手冊:http://logging.apache.org/log4j/1.2/manual.html

動態載入 log4j.properties

  1. 開啟 Rational® Engineering Lifecycle Manager 管理主控台。
  2. 以管理者身分,開啟「管理」下拉清單(齒輪圖示),並且選取應用程式管理 > 管理應用程式
  3. 在管理 URL 之後附加 ?internal=true,來啟動內部工具。例如:https://[relm_server]:9444/relm/admin?internal=true
  4. 內部工具之下選取重新載入日誌設定

管理日誌檔的大小

依預設,在 log4j.properties 檔中,會將日誌檔的大小設為 10 MB,將備份檔數目設為 5。這個檔案位於 installdir/jazz/server/conf/jazz 目錄。您可以視需要變更 log4j.properties 檔的輪替內容。

如果執行以大小為基礎的輪替,請更新下列字行的數值:
log4j.appender.file.MaxFileSize=10MB

log4j.appender.file.MaxBackupIndex=5

這幾行將日誌檔大小限制為 10MB,將備份檔的數目限制為 5 個。

您也可以執行時間型輪替、設定日期或執行每日輪替。如果要執行每日輪替,請將 log4j.appender.file=org.apache.log4j.FileAppender 變更為 log4j.appender.file=org.apache.log4j.DailyRollingFileAppender。 這樣變更會在每天午夜輪替日誌檔。

從記載輸出中區隔追蹤輸出

依預設,當啟用追蹤資訊時,會將它傳送到與其他所有資訊相同的日誌中。如果要將追蹤資訊重新導向至另一個位置,請在 log4.properties 中,使用適當的「臨界值」來定義 appender。例如:
log4j.appender.trace=org.apache.log4j.RollingFileAppender
log4j.appender.trace.MaxFileSize=100MB
log4j.appender.trace.Threshold=TRACE
log4j.appender.trace.MaxBackupIndex=5
log4j.appender.trace.File=logs/relm_trace.log
log4j.appender.trace.layout=org.apache.log4j.PatternLayout
log4j.appender.trace.layout.ConversionPattern=%d{ISO8601} [%30t] [%x] %5p %c  - %m%n
這會將 TRACE 層次的所有訊息及更高層次的訊息(亦即,所有訊息)記載到稱為 relm_trace.log 的檔案中。

意見