Log4cxx配置文件介绍

Log4cxx配置文件介绍

2009-07-31 20:34

Log4cxx配置由三个重要的组件构成：日志信息的优先级，日志信息的输出目的地，日志信息的输出格式。     1.日志信息的优先级 Logger的语法：               log4j.rootLogger = [ level ] , appenderName, appenderName, …          其中，level 是日志记录的优先级，分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定义的级别。Log4j建议只使用四个级别，优先级从高到低分别是ERROR、WARN、INFO、DEBUG。通过在这里定义的级别，可以控制到应用程序中相应级别的日志信息的开关。比如这里定义了INFO级别，则应用程序中所有DEBUG级别的日志信息将不被打印出来。 appenderName名字任意，用来标示日志信息输出到哪里，可以同时指定多个。 日志信息的输出目的地              Appender的语法：               log4j.appender.appenderName = fully.qualified.name.of.appender.class         log4j.appender.appenderName.option1 = value1            …                log4j.appender.appenderName.option = valueN            其中，Log4j提供的appender有以下几种：                            org.apache.log4j.ConsoleAppender 控制台            org.apache.log4j.FileAppender 文件             org.apache.log4j.DailyRollingFileAppender 每天产生一个日志文件          org.apache.log4j.RollingFileAppender 文件大小到达指定尺寸的时候产生一个新的文件        org.apache.log4j.WriterAppender 将日志信息以流格式发送到任意指定的地方         2.日志信息的输出格式              Layout的语法：               log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class        log4j.appender.appenderName.layout.option1 = value1           …                log4j.appender.appenderName.layout.option = valueN           3.Log4j提供的Layout有以下几种：             org.apache.log4j.HTMLLayout 以HTML表格形式布局           org.apache.log4j.PatternLayout 可以灵活地指定布局模式           org.apache.log4j.SimpleLayout 包含日志信息的级别和信息字符串          org.apache.log4j.TTCCLayout 包含日志产生的时间、线程、类别等等信息          Log4j采用类似C语言中的printf函数的打印格式格式化日志信息，打印参数如下：                        %m 输出代码中指定的消息              %p 输出优先级，即DEBUG，INFO，WARN，ERROR，FATAL           %r 输出自应用启动到输出该log信息耗费的毫秒数            %c 输出所属的类目，通常就是所在类的全名            %t 输出产生该日志事件的线程名             %n 输出一个回车换行符，Windows平台为“/r/n”，Unix平台为“/n”          %d 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，输出2008年11月14日 15:16:17,890 %l 输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数。 log4cxx调试日志选择性输出的配置方法 （转载请注明来源于金庆的专栏） 一般是每个类都有自己的日志, 可建立一个静态成员logger如下: class A { private:     static log4cxx::LoggerPtr logger; }; 需要在cpp文件中静态初始化: log4cxx::LoggerPtr A::logger = log4cxx::Logger::getLogger("A"); 日志类别名"A"就是类名, 也可以是模块名.类名, 如"DB.A". log4cxx的惯例是使用这样一个静态成员. 但也可以是静态成员logger(), 这样不必静态初始化. class A { private:     static log4cxx::LoggerPtr logger()     {         return log4cxx::Logger::getLogger("A");     } }; 但从效率考虑, 每次调用日志都要getLogger()不如静态初始化. 类代码中调用日志只需:     LOG4CXX_DEBUG(logger, "test log..."); 日志配置log4j.properties如下: log4j.rootLogger=WARN, R log4j.appender.R=org.apache.log4j.RollingFileAppender log4j.appender.R.File=log.txt log4j.appender.R.layout=org.apache.log4j.PatternLayout log4j.appender.R.layout.ConversionPattern=%d %5p %c %x: %m%n # log4j.logger.DB.A=DEBUG 默认所有日志等级为WARN, 不会输出DEBUG日志, 只需显式设定某一类日志的级别, 就可以选择性地输出该类日志. 如调试A类时, 取消配置文件中的注释就行了.