> # SIP Server：配置：消息调试

> 配置选项

> 使用此页可以为 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，并创建一个新文件来存储后续消息。 注：此设置需要指定“bySize”类型的文件滚动。 MBean 属性： `MessageDebugBean.FileMinSize` 更改将在重新部署模块或重新启动服务器后生效。
> 日志文件名称 | 存储 SIP 消息的日志文件的名称。 MBean 属性： `MessageDebugBean.LogFilename` 更改将在重新部署模块或重新启动服务器后生效。
> 已启用日志记录 | 指定服务器是否将 SIP 消息记录到独立的日志文件中。 MBean 属性： `MessageDebugBean.LoggingEnabled` 更改将在重新部署模块或重新启动服务器后生效。
> 滚动类型 | 定义将旧日志消息移动到单独文件的标准。 MBean 属性： `MessageDebugBean.RotationType`
> 限制保留的文件数 | 指示是否限制此服务器实例为存储旧消息而创建的日志文件的数量。(需要指定“bySize”或“byTime”类型的文件滚动。) 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`
> 日期格式模式 | 用于在服务器日志文件和标准输出中显示日期的日期格式模式。 DateFormatPattern 字符串符合 `java.text.SimpleDateFormat` 类的规范。 MBean 属性： `MessageDebugBean.DateFormatPattern` 更改将在重新部署模块或重新启动服务器后生效。