對於發生在 IBM®
Rational®
DOORS® 資料庫伺服器、用戶端和交互作業伺服器及
Rational
DOORS Web Access 伺服器和訊息分配管理系統中的問題,您可以使用日誌檔進行疑難排解。
視您的配置而定,會提供下列記載工具來診斷非預期的行為:
- 用於用戶端的診斷日誌
- 資料庫伺服器交易日誌
- 用戶端交易日誌
- Rational
DOORS Web
Access 伺服器、交互作業伺服器和訊息分配管理系統
- 應用程式訊息日誌和資料收集公用程式
用於 Rational
DOORS 用戶端的診斷日誌
用戶端有一個內建記載機制,會記錄您階段作業期間因內部錯誤而發生的任何不尋常事件。如果要檢視診斷日誌,請按一下。必要的話,您可以複製輸出視窗中的資訊,並儲存成本端文字檔。
如果要記錄更詳細的日誌,您也可以在用戶端和資料庫伺服器上啟用額外的交易型記載。如需相關資訊,請參閱下列各節。
Rational
DOORS 資料庫伺服器記載
資料庫伺服器提供記載,可用不同的詳細程度記錄活動。依預設不會啟用這項記載,因為它可能增加交易的處理器用量,並減慢完成所要求功能的速度,或降低整體成效。輸出日誌中的詳細資料,取決於您設定的記載層次值。值範圍從層次 1(最簡要)到層次 6(最詳細)。在您啟用伺服器記載之前,請先向「支援中心」查詢,以判斷需要使用哪一個層次來解決問題。
表 1. 記載層次記載層次 |
日誌資訊詳細資料 |
1 |
連線、斷線,以及問題封包 |
2 |
連線、斷線,以及封包類型 |
3 |
精簡格式的連線、斷線、封包類型和封包引數 |
4 |
詳細格式的連線、斷線、封包類型和封包引數 |
5 |
僅資料快取作業 |
6 |
詳細格式的連線、斷線、資料快取作業、封包類型和封包引數 |
為了協助識別未指定的錯誤,您可能需要啟動層次 6 的記載,以擷取所有活動。啟用資料庫記載並重新產生行為之後,請將產生的日誌檔傳送給「支援中心」,並依照
在 Rational DOORS 資料庫伺服器中啟用交易日誌說明主題的說明,來停用記載。
註: 為了避免效能降低,
請只在有限的診斷週期啟用資料庫記載。
Rational
DOORS 用戶端記載
您可以啟用記載,來疑難排解資料庫伺服器的連線問題。如果模組或物件資料可能是機密內容的資訊,日誌就不會包含它們;只會包含檔案交易的詳細資料。請從有問題的電腦,開啟 Rational
DOORS 用戶端,然後執行 DXL 指令,以啟用用戶端記載並產生本端日誌檔。在您重新產生行為之後,請將產生的日誌檔傳送給「支援中心」,並依照用戶端記載說明主題在 Rational DOORS 用戶端中啟用交易日誌的說明,來停用記載。
Rational
DOORS 交互作業伺服器以及 Rational
DOORS Web Access 伺服器和訊息分配管理系統的記載
依預設,Rational
DOORS Web Access 元件提供「參考」層次的日誌記錄。在「參考」層次,日誌記錄包含說明高階應用程式進度的參考訊息。如果希望更加詳盡,
請讓元件在「除錯」層次執行。
Rational
DOORS 交互作業伺服器以及
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 檔。
如需設定日誌檔的相關資訊,請參閱下列主題:
- Rational
DOORS 中的記載:
- Rational
DOORS Web Access 中的記載: