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

更改将在重新部署模块或重新启动服务器后生效。