ClearQuest CM API 記載是利用 logging.properties 檔來控制,該檔案與執行您應用程式的 JRE 相關聯。logging.properties 檔位於 JDK 的 jre\lib 目錄中。
預設會停用記載。您應該在 INFO 層次啟用記載。
############################################################ # 廣域內容 ############################################################ # # "handlers" 會指定日誌 Handler 類別的清單 # (以逗點區隔)。這些處理程式會在 VM 啟動期間安裝。 # 請注意,這些類別必須位於系統類別路徑。 # 依預設,我們只會配置 ConsoleHandler,其只會 # 顯示 INFO 以上層次的訊息。handlers = java.util.logging.ConsoleHandler # 如果也要新增 FileHandler,請改用下面這一行。 #handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler # 預設廣域記載層次。 # 這會指定所有日誌程式要記載哪些類型 # 的事件。針對任何給定的機能,這個廣域層次 # 可以被機能專屬的層次置換 # 請注意,ConsoleHandler 也有另一個層次 # 設定,來限制列印至主控台的訊息。 # 下一行會使記載(針對所有日誌程式物件)發生於 INFO 層次 .level=INFO ############################################################ # Handler 專屬內容。 # 說明 Handler 的專屬配置資訊。 ############################################################ # CMLogger - 應該一律啟用於 INFO 層次。 # # 下面這幾行會指派 CMLogger 物件的記載功能發生於 INFO 層次,# 且日誌輸出檔的名稱會是 CMLogger[#].log,並位於已登入之 # 使用者的起始目錄下;日誌輸出檔會在 20 個檔案當中進行輪換,每一個檔案 # 限制在 20000000 個位元組。日誌項目會附加到輪換的現行 # 日誌輸出檔中,且會使用簡單的格式寫入。 # com.ibm.rational.stp.common.internal.util.CMLogger.level = INFO com.ibm.rational.stp.common.internal.util.LogHandler.pattern = %h/CMLogger%g.log com.ibm.rational.stp.common.internal.util.LogHandler.limit = 20000000 com.ibm.rational.stp.common.internal.util.LogHandler.count = 20 com.ibm.rational.stp.common.internal.util.LogHandler.append = true com.ibm.rational.stp.common.internal.util.LogHandler.formatter = java.util.logging.SimpleFormatter # CMTracer - 僅啟用(解除註解)以下項目供暫時使用,因為追蹤 # 需要大量資源。 # # 下面這幾行會指派 CMTracer 物件的追蹤功能發生於 FINER 層次,# 且追蹤輸出檔的名稱會是 CMTracer[#].log,並位於已登入之 # 使用者的起始目錄下;追蹤輸出檔會輪換 20 個檔案,每一個檔案 # 限制在 20000000 個位元組。追蹤項目會附加到輪換的現行 # 追蹤輸出檔中,且會使用簡單的格式寫入。 # #com.ibm.rational.stp.common.internal.util.CMTracer.level = FINER #com.ibm.rational.stp.common.internal.util.TraceHandler.pattern = %h/CMTracer%g.log #com.ibm.rational.stp.common.internal.util.TraceHandler.limit = 20000000 #com.ibm.rational.stp.common.internal.util.TraceHandler.count = 20 #com.ibm.rational.stp.common.internal.util.TraceHandler.append = true #com.ibm.rational.stp.common.internal.util.TraceHandler.formatter = java.util.logging.SimpleFormatter
這些設定會產生名稱為 CMLogger[#].log 的日誌檔,其中 [#] 指出檔案輪換號碼。每一個檔案都在已登入使用者的起始目錄中;當每一個檔案已滿時,輸出即會在檔案之間輪換。
使用上述範例中的 logging.properties 項目表示日誌記錄會附加到適用檔案的尾端,且每一個項目都是以簡單的格式儲存。您必須停止並重新啟動應用程式,才能辨識出對檔案所做的變更。
當日誌輸出檔已滿時,即會建立新的檔案並重新命名之前的檔案,以包含發生檔案輪換時的日期和時間戳記。每一個檔案都保留 20 MB 的資料,而新的項目會附加到現有的項目之後(包括應用程式重新啟動期間)。當日誌檔的數目到達 20 時,會輪換到新的檔案並刪除最舊的檔案。
如需如何配置 Java 記載功能的相關資訊,請參閱與您 JDK 相關聯的 Javadoc 文件中的 java.util.logging.Logger 及 java.util.logging.FileHandler 資訊。
如果您要建立自訂日誌內容檔,則必須使用 -D 引數來指定檔案的位置。例如:
java -Djava.util.logging.config.file=C:\myLogPropsFile.properties your_client_java_program_that_uses_CM-API