DOORSDWA 的日誌檔

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

用於 DOORS 用戶端的診斷日誌

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

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

DOORS 資料庫伺服器記載

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

表 1. 記載層次
記載層次 日誌資訊詳細資料
1 連線、斷線,以及問題封包
2 連線、斷線,以及封包類型
3 精簡格式的連線、斷線、封包類型和封包引數
4 詳細格式的連線、斷線、封包類型和封包引數
5 僅資料快取作業
6 詳細格式的連線、斷線、資料快取作業、封包類型和封包引數
為了協助識別未指定的錯誤,您可能需要啟動層次 6 的記載,以擷取所有活動。啟用資料庫記載並重新產生行為之後,請將產生的日誌檔傳送給「支援中心」,並依照在 DOORS 資料庫伺服器中啟用交易日誌說明主題的說明,來停用記載。
註: 為了避免效能降低, 請只在有限的診斷週期啟用資料庫記載。

DOORS 用戶端記載

您可以啟用記載,來疑難排解資料庫伺服器的連線問題。如果模組或物件資料可能是機密內容的資訊,日誌就不會包含它們;只會包含檔案交易的詳細資料。請從有問題的電腦,開啟 DOORS 用戶端,然後執行 DXL 指令,以啟用用戶端記載並產生本端日誌檔。在您重新產生行為之後,請將產生的日誌檔傳送給「支援中心」,並依照用戶端記載說明主題在 DOORS 用戶端中啟用交易日誌的說明,來停用記載。

DOORS 交互作業伺服器以及 DWA 伺服器和訊息分配管理系統的記載

依預設,DWA 元件提供「參考」層次的日誌記錄。在「參考」層次,日誌記錄包含說明高階應用程式進度的參考訊息。如果希望更加詳盡, 請讓元件在「除錯」層次執行。

DOORS 交互作業伺服器以及 DWA 伺服器和訊息分配管理系統在下列目錄中提供「參考」層次的日誌記錄:
  • DWA_INSTALL_DIR\broker\data\activemq.log
  • DWA_INSTALL_DIR\server\festival\logs
如果要以「除錯」層次的記載來產生詳細資訊, 請參閱 DWA 記載的相關鏈結。logs 目錄中有多個日誌檔。如果要診斷問題,請從下列檔案開始:
  • festival.log 包含 DWA 伺服器所撰寫的每一則日誌訊息。
  • request.log 用來驗證已接收要求。當診斷處理程序涵蓋多個應用程式時, 這個日誌就很有用。
  • response.log 用來確認回應已傳回給發出呼叫的應用程式。這個日誌有助於確認所接收的要求已完成並已傳回結果。
錯誤訊息會根據其如何引發,而寫入到不同的日誌檔。大部分的錯誤會寫入到 exception.log,但是也可以使用其他的錯誤日誌檔。錯誤日誌檔有三個:
  • exception.log
  • error_view.log
  • error_misc.log

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

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

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

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

視訊圖示視訊

Jazz.net 頻道
Software Education 頻道

學習圖示課程

IoT 線上學院
Skills Gateway

提問圖示社群

Jazz.net
Jazz.net 討論區
Jazz.net 檔案庫

支援圖示支援

IBM 支援中心社群
部署 Wiki