> # SIP 伺服器：組態：訊息除錯

> 組態選項

> 使用此頁面可啟用並設定 WebLogic Communications Server 的存取記錄日誌。

> 警告：此元素只能在開發環境中使用，因為存取記錄日誌記錄了所有的 SIP 要求和回應。不要在生產系統上啟用此選項。

> 有關設定和使用存取記錄日誌的詳細資訊，請參閱程式設計指南中的「啟用存取記錄日誌」。如果您要在生產環境中執行更多選擇性記錄日誌，請參閱管理指南中的「記錄 SIP 要求和回應」。

> #### 組態選項

> 名稱 | 描述
> --- | ---
> 啟用除錯 | 指定是否啟用訊息除錯。
> 除錯層級 | 記錄每個 SIP 要求和回應的預先定義資訊集合。 支援下列層級： 精簡：只記錄網域設定、記錄日誌 Servlet 名稱、記錄日誌層級以及訊息是否為內送訊息。 基本：記錄精簡項目加上 SIP 訊息狀態、原因字詞、回應或要求的類型、SIP 方法、From 標頭以及 To 標頭。 完整：記錄基本項目加上所有 SIP 訊息標頭加上時間戳記、通訊協定、要求 URI、要求類型、回應類型、內容類型以及原始內容。 MBean 屬性： `MessageDebugBean.Level`
> 模式 | 存取日誌項目的格式化樣式。有關括號括住的整數，請參照下方定義的記號 格式透過指定一或多個整數來定義，由 "{" 和 "}" 括弧括住。每個整數表示稍後格式定義中所定義的記號。 MBean 屬性： `FormatBean.Pattern`
> 記號 | 識別一部分 SIP 訊息以納入日誌記錄的字串記號。請一行放置一個記號。 請參閱程式設計指南中的「自訂日誌記錄」取得可用記號類型的清單。 MBean 屬性： `FormatBean.Tokens`
> 循環檔案大小 | 觸發伺服器將日誌訊息移至不同檔案的檔案大小 (1 - 65535 KB)。 當伺服器檢查檔案大小時，如果日誌檔達到指定的大小下限，伺服器會將目前的日誌檔重新命名為 FileName.logN，然後建立新的檔案儲存後續的訊息。 注意：此設定需要指定「按大小」的檔案循環類型。 MBean 屬性： `MessageDebugBean.FileMinSize` 在您重新建置模組或重新啟動伺服器之後，變更才會生效。
> 日誌檔名稱 | 儲存 SIP 訊息的日誌檔名稱。 MBean 屬性： `MessageDebugBean.LogFilename` 在您重新建置模組或重新啟動伺服器之後，變更才會生效。
> 啟用記錄日誌 | 指定伺服器是否將 SIP 訊息記錄於獨立的日誌檔。 MBean 屬性： `MessageDebugBean.LoggingEnabled` 在您重新建置模組或重新啟動伺服器之後，變更才會生效。
> 循環類型 | 定義將舊的日誌訊息移到不同檔案的條件。 MBean 屬性： `MessageDebugBean.RotationType`
> 限制保留的檔案數 | 表示是否限制此伺服器執行處理為了儲存舊訊息所建立的日誌檔數量 (當檔案循環類型為「按大小」或「按時間」時，需要作設定)。 MBean 屬性： `MessageDebugBean.NumberOfFilesLimited`
> 要保留的檔案 | 伺服器循環日誌時，能夠建立的日誌檔數量上限。這個數字不包括伺服器用來儲存目前訊息的檔案 (需要啟用「限制保留的檔案數」)。 MBean 屬性： `MessageDebugBean.FileCount`
> 啟動時循環日誌檔 | 指定伺服器是否在其啟動週期期間，循環其日誌檔。 MBean 屬性： `MessageDebugBean.RotateLogOnStartup`
> 日誌檔循環目錄 | 要用來儲存循環的日誌檔之目錄。在預設狀況下，循環的檔案與日誌檔會儲存在相同的目錄中。 MBean 屬性： `MessageDebugBean.LogFileRotationDir`
> 循環開始時間 | 決定時間型循環序列的開始時間 (小時和分鐘)。 注意：此設定需要設定小時和分鐘的日誌循環類型 ('hh:mm'；例如 07:30)。 MBean 屬性： `MessageDebugBean.RotationTime`
> 循環間隔 | 伺服器將舊記錄訊息儲存至另一個檔案的間隔 (小時)。 注意：此設定需要設定小時和分鐘的日誌循環類型 ('hh:mm'；例如 07:30)。 MBean 屬性： `MessageDebugBean.FileTimeSpan`
> 日期格式樣式 | 呈現伺服器日誌檔和 stdout 輸出的日期格式樣式。 DateFormatPattern 字串符合 `java.text.SimpleDateFormat` 類別的規格。 MBean 屬性： `MessageDebugBean.DateFormatPattern` 在您重新建置模組或重新啟動伺服器之後，變更才會生效。