Rational DOORSRational DOORS Web Access 日誌檔

您可以利用日誌檔,對 IBM® Rational® DOORS® 資料庫伺服器、用戶端和 Interoperation 伺服器以及 Rational DOORS Web Access 伺服器和訊息分配管理系統中所發生的問題,進行疑難排解。
視您的配置而定,會提供下列記載工具來診斷非預期的行為:
  • 用於用戶端的診斷日誌
  • 資料庫伺服器交易記載
  • 用戶端交易記載
  • Rational DOORS Web Access 伺服器、Interoperation 伺服器和訊息分配管理系統的記載
  • 應用程式訊息記載和資料收集公用程式

用於 Rational DOORS 用戶端的診斷日誌

用戶端有一個內建記載機制,會記錄您階段作業期間因內部錯誤而發生的任何不尋常事件。如果要檢視診斷日誌,請按一下說明 > 顯示診斷日誌。必要的話,您可以複製輸出視窗中的資訊,並儲存成本端文字檔。

如果要記錄更詳細的日誌,您也可以在用戶端和資料庫伺服器上啟用額外的交易型記載。如需相關資訊,請參閱下列各節。

Rational DOORS 資料庫伺服器記載

資料庫伺服器提供記載功能,可用不同的詳細程度記錄活動。依預設不會啟用這項記載,因為它可能增加交易的處理器用量,並減慢完成所要求功能的速度,或降低整體效能。輸出日誌中的詳細資料,取決於您設定的記載層次值。值範圍從層次 1(最簡要)到層次 6(最詳細)。在您啟用伺服器記載之前,請先向「IBM 軟體支援中心」查詢,以判斷需要使用哪一個層次來解決問題。

表 1. 記載層次
記載層次 日誌資訊詳細資料
1 連線、斷線,以及問題封包
2 連線、斷線,以及封包類型
3 精簡格式的連線、斷線、封包類型和封包引數
4 詳細格式的連線、斷線、封包類型和封包引數
5 僅資料快取作業
6 詳細格式的連線、斷線、資料快取作業、封包類型和封包引數
為了協助識別不明的錯誤,您可能需要啟動層次 6 的記載,以擷取所有活動。啟用資料庫記載並重新產生行為之後,請將產生的日誌檔傳送給「IBM 軟體支援中心」,並依照伺服器記載說明主題的說明來停用記載功能。在 Rational DOORS 資料庫伺服器中啟用交易記載
註: 請只在有限的診斷期間啟用資料庫記載。如果要關閉記載功能,但不關閉伺服器,請使用 -serverlogging dbadmin 指令,將記載層次值設為 0;例如 dbadmin -d 36677@IBMEDSERV -serverlogging 0

Rational DOORS 用戶端記載

您可以啟用記載功能,來疑難排解資料庫伺服器的連線問題。請從有問題的電腦,開啟 Rational DOORS 用戶端,然後執行 DXL 指令,以啟用用戶端記載並產生本端日誌檔。當您重新產生行為時,請將產生的日誌檔傳送給「IBM 軟體支援中心」,並依照用戶端記載說明主題的說明來停用記載功能。在 Rational DOORS Rational DOORS 用戶端中啟用交易記載
註: 如果模組或物件資料可能是機密內容的資訊,日誌就不會包含它們;只會包含檔案交易的詳細資料。若啟用 DXL 安全,您必須是一位有權編輯和執行 DXL 的使用者。../../com.ibm.doors.configuring.doc/topics/t_setupdxlsecurity.html#t_setupdxlsecurity

Rational DOORS Interoperation 伺服器以及 Rational DOORS Web Access 伺服器和訊息分配管理系統的記載

依預設,Rational DOORS Web Access 元件提供「參考」層次的日誌記錄。在「參考」層次,日誌記錄包含說明高階應用程式進度的參考訊息。如果要診斷安裝問題,您可以讓元件以除錯模式執行。在「除錯」層次,日誌記錄含有更詳細的參考資訊事件,有助於進行應用程式除錯。

Rational DOORS Interoperation 伺服器及 Rational DOORS Web Access 伺服器和訊息分配管理系統在下列目錄中提供「參考」層次的日誌記錄:
  • DWA_INSTALL_DIR\broker\data\activemq.log
  • DWA_INSTALL_DIR\server\festival\logs

    如果您需要更詳細的資訊來診斷問題,請啟用「除錯」層次的記載。如果要設定加強型記載,請參閱 Rational DOORS Web Access 相關鏈結。logs 目錄中有多個日誌檔。

    如果要診斷問題,請從下列檔案開始:
    • festival.log 包含 Rational DOORS Web Access 伺服器所撰寫的每一則日誌訊息。
    • request.log 用來驗證實際接收的要求。這在處理跨多個應用程式的程序時很有用。
    • response.log 用來確認回應已傳回給發出呼叫的應用程式。這有助於確認所接收的要求已完成並已傳回結果。
    錯誤訊息會根據其如何引發而寫入到不同的日誌。大部分的錯誤會寫入到 exception.log,但是也可以使用其他的錯誤日誌檔。錯誤日誌檔有下列三個:
    • exception.log
    • error_view.log
    • error_misc.log

應用程式訊息記載和資料收集器公用程式

9.4 版推出了應用程式訊息記載,這是以 Apache log4cxx 記載服務為基礎。您可以限制日誌檔大小、設定自動清理舊檔案、選擇輸出日誌檔的格式,以及變更記載層次和日誌配置,而不需重新啟動伺服器。每隔 60 秒就會監視配置檔,以偵測變更。

有五種記載層次,從最低到最高分別是:除錯、參考、警告、錯誤和嚴重。每一個層次記載該層次及所有較高層次的相關資訊。例如,「警告」層次包含「警告」、「錯誤」和「嚴重」模式的資訊。

舊版 Rational DOORS 在起始疑難排解階段期間,需要手動反覆收集環境和資源資訊以及診斷日誌。9.4 版推出了應用程式傳訊,您可以執行指令行資料收集工具,以收集根據應用程式傳訊配置指示所產生的日誌。資料收集工具也會建立三個文字檔:
  • readme.txt 可在問題發生時提供使用情形的詳細說明。
  • problemDetails.txt 是一個範本檔,可讓您手動輸入問題的詳細資料。
  • collectedInformation.txt 是記錄自動收集的作業系統資訊、Rational DOORS 產品資訊、支援的動態鏈結程式庫檔案 (.DLL),以及 config.ini 檔。
如需設定日誌檔的相關資訊,請參閱下列主題:

意見