25.2. 管理与配置

25.2.1. 编辑logging.xml文件

日志子系统的配置文件logging.xml,在域主目录下的config目录中,此配置文件中定义了一个全局的控制台日志输出对象,一个全局的文件日志输出对象,还有一个匿名的全局日志记录器对象。

本配置文件的文档类型定义(DTD),定义了如何编写合法的logging.xml,文档类型定义(DTD)文件和参考可参见DTD reference

[注意]注意

缺省的日志配置文件logging.xml中定义了一个全局匿名的日志记录器(Logger)对象,此对象的缺省日志级别为INFO,如果其他的日志记录器未指定日志级别,则采用上述的全局匿名日志记录器(Logger)的日志级别对其进行初始化设置。

日志文件输出可配置属性概述:

属性描述缺省值
level日志输出(Handler)对象的日志级别ALL
filter指定使用的过滤器(Filter)类名称
formatter指定使用的格式化(Formatter)类名称com.apusic.logging.SimpleFormatter
encoding指定使用的输出字符集平台缺省字符集
limit指定对每个日志文件可输出的最大近似大小(单位为字节)。如值为零,则文件可接受的输入没有限制0
count指定循环文件集合的大小1
pattern指定日志文件名的产生模式,(见下文)%h/logs/apusic.log

一 个名字模式(pattern)可包含由以下标记组成的字串:

"/" 文件路径分隔符

"%t" 系统临时目录

"%h" 系统属性中"com.apusic.home"或"user.home"的值

"%g" 日志文件组的标识数字,按"0,1,2,..."序列产生

"%%" %字符

如:

%h/logs/apusic%g.log

加如%g 部分未指定并且日志输出文件的数量已大于count 值,新的日志文件将会在文件名后加上"."和文件标识数字。 如一个模式为"%t/java%g.log"并且日志文件数量被设 置为2 的设置在window95 平台将会输出到c:\temp\java0.log 和c:\temp\java1.log 文件。

端口日志输出可配置属性概述:

属性描述缺省值
level日志输出(Handler)对象的日志级别ALL
filter指定使用的过滤器(Filter)类名称
formatter指定使用的格式化(Formatter)类名称com.apusic.logging.XMLFormatter
encoding指定使用的输出字符集平台缺省字符集
host指定需要连接的目标主机名称(无缺省值)
port指定需要使用目标TCP端口无缺省值)

25.2.2. 记录客户端IP

在Apusic输出的log中,如果是由客户端请求引发的异常,会显示客户端请求的IP。要使用这个功能,需要在启动应用服务器时加上Apusic特有的JVM参数-Dapusic.log.clientIP=true,这个参数默认情况下为false。

java -Dapusic.log.clientIP=true ...