log4cplus - log4cplus配置文件 - 《C 第三方库》

初识
用例

初识

# 文件名：log4cplus.config
log4cplus.rootLogger=WARN, MyFileAppender
    #根日志
    #第一个参数：日志级别
    #第二个参数：appender，这里选用的是文件Appender
# 这里定义了两个日志，它们都继承rootLogger属性，并挂载在rootLogger下
log4cplus.logger.MemoryCheck=INFO, MyConsoleAppender
    #MemoryCheck从rootlogger继承，又定义了自己的日志集别和appender
    #故最终它的日志级别为 INFO，日志同时输出到控制台和文件中
log4cplus.logger.DatabaseOperations=ERROR
# ----- 每个Appender可以设置日志的输出位置、路径、Layout等内容
#Appender类型：输出到命令行
log4cplus.appender.MyConsoleAppender=log4cplus::ConsoleAppender
#输出格式
log4cplus.appender.MyConsoleAppender.layout=log4cplus::PatternLayout
log4cplus.appender.MyConsoleAppender.layout.ConversionPattern=[%-5p][%d] %m%n
#Appender类型：输出到文件
log4cplus.appender.MyFileAppender=log4cplus::RollingFileAppender
#文件路径
log4cplus.appender.MyFileAppender.File=logging.txt
#指定文件大小阈值
log4cplus.appender.MyFileAppender.MaxFileSize=16MB
#指定日志文件回滚周期
log4cplus.appender.MyFileAppender.MaxBackupIndex=1
#输出格式
log4cplus.appender.MyFileAppender.layout=log4cplus::PatternLayout
log4cplus.appender.MyFileAppender.layout.ConversionPattern=[%-5p][%D{%Y/%m/%d %H:%M:%S:%q}][%-l][%t] %m%n

【读取配置文件的内容】
log4cplus提供一个类PropertyConfigurator来实现从文件读取配置，参数就是文件名。其他参数采用默认，初始化时使用

log4cplus::initialize();     
log4cplus::PropertyConfigurator::doConfigure(LOG4CPLUS_TEXT("log4cplus.config"));

用例

DailyRollingFileAppender

#    -配置logger对象
    #根的配置：log4cplus.rootLogger= [LogLevel],appenderName,appenderName,...
  #非根的配置：log4cplus.logger.logger_name= [LogLevel|INHERITED],appenderName,...
log4cplus.rootLogger=ERROR, R
# -配置输出位置
log4cplus.appender.R=log4cplus::DailyRollingFileAppender
    #根据频度来决定是否转储的文件转储方式
log4cplus.appender.R.File=./log/error.log
    #文件的路径
log4cplus.appender.R.Schedule=HOURLY
    #存储频度。当超过该频度，后续 log 信息会另存到新文件中
  #MONTHLY（每月）、WEEKLY（每周）、DAILY（每日）、TWICE_DAILY（每两天）、HOURLY（每时）、MINUTELY（每分）
log4cplus.appender.R.Append=true
    #缓冲刷新标识： 表示每向文件写一条记录就刷新一次缓存，否则直到 FileAppender 被关闭或文件缓存已满才更新文件
  #一般要设置true，这样类似程序崩溃的情况发生后，程序终止时刻之前的所有记录都会被正常保存
#配置打印的格式
log4cplus.appender.R.layout=log4cplus::PatternLayout
log4cplus.appender.R.layout.ConversionPattern=[%D{%Y-%m-%d %H:%M:%S,%Q}] [%t] %-5p - %m%n[%p] 注释（7）
log4cplus.logger.test=TRACE, RR
log4cplus.appender.RR=log4cplus::DailyRollingFileAppender
log4cplus.appender.RR.File=./log/test.log
log4cplus.appender.RR.Schedule=HOURLY
log4cplus.appender.RR.MaxBackupIndex=192    #8 * 24 注释（6）
    #设置最大记录文件数，当记录文件数超过MaxBackupIndex+1（此处为193）时，会删除最早生成的文件
  #保证整个文件数目等于MaxBackupIndex+1。后面的注释#8*24意在说明此处设置实质上是记录八天以内的日志
log4cplus.appender.RR.Append=true
log4cplus.appender.RR.layout=log4cplus::PatternLayout
log4cplus.appender.RR.layout.ConversionPattern=%p %D{%Y-%m-%d %H:%M:%S.%q}:%t %F:%L "%m"%n

TimeBasedRollingFileAppender

log4cplus.rootLogger=ALL, LegendPrint_Run_LOG
# 指定append类型，因为我们这需要按天来生成，同时文件名也要可以按时间来命名
#        所以选择TimeBasedRollingFileAppender
log4cplus.appender.LegendPrint_Run_LOG = log4cplus::TimeBasedRollingFileAppender
# 指定文件路径名，可以是绝对路径也可以是相对路径，可以使用时间匹配符来动态定义文件名
#        log4Cplus会根据你使用到的时间自动创建文件。比如，你的文件名是由年月构成，那每个月都会生成新的文件。
log4cplus.appender.LegendPrint_Run_LOG.FilenamePattern= log\ %d{yyyy-MM-dd}.log
# 设置为true表示向日志文件中追加信息而不是截断。python
log4cplus.appender.LegendPrint_Run_LOG.Append = true
# 设置最大的文件数，超过这个数值删除时间最久的文件。
log4cplus.appender.LegendPrint_Run_LOG.MaxHistory = 999
# 当设置为true表示每一次有append event事件，输出流就会被刷新到文件中。
log4cplus.appender.LegendPrint_Run_LOG.ImmediateFlush = true
# 默认值为true关闭的时候回滚到一个新的文件中，有bug，我们设置为false，不使用这个功能。
log4cplus.appender.LegendPrint_Run_LOG.RollOnClose = false
# 如果为true，那么如果指定的日志路径名中如果有文件夹不存在，则会创建文件夹。
log4cplus.appender.LegendPrint_Run_LOG.CreateDirs = true
# 指定消息输出的格式
log4cplus.appender.LegendPrint_Run_LOG.layout = log4cplus::PatternLayout
log4cplus.appender.LegendPrint_Run_LOG.layout.ConversionPattern =  %D{%Y-%m-%d %H:%M:%S,%q}: %-5p %m%n
# 指定消息输出的级别，这边使用的是Range，指定范围，在这个范围内都可以使用
log4cplus.appender.LegendPrint_Run_LOG.filters.1 = log4cplus::spi::LogLevelRangeFilter
log4cplus.appender.LegendPrint_Run_LOG.filters.1.LogLevelMin = TRACE
log4cplus.appender.LegendPrint_Run_LOG.filters.1.LogLevelMax = FATAL
# 这里我们还可以使用LogLevelMatchFilter来指定消息输出级别
# log4cplus.appender.LegendPrint_Error_LOG.filters.1=log4cplus::spi::LogLevelMatchFilter
# log4cplus.appender.LegendPrint_Error_LOG.filters.1.LogLevelToMatch=ERROR
# true表示如果匹配了filter指定的范围则输出，如果是false则反之。
log4cplus.appender.LegendPrint_Run_LOG.filters.1.AcceptOnMatch = true
# 表示清空过滤器的设置，这边设置的顺序和执行的顺序是相反的，即log4Cplus会先清空//然后再设置filter的级别。
log4cplus.appender.LegendPrint_Run_LOG.filters.2 = log4cplus::spi::DenyAllFilter

同步

# 定义了一个日志global。指定等级INFO，名为SA的Appender
log4cplus.logger.global = INFO, SA
# 指定Appender的类型：按频率回滚文件
log4cplus.appender.SA=log4cplus::DailyRollingFileAppender
# 指定频率：日更
log4cplus.appender.SA.Schedule=HOURLY
# 日期格式
log4cplus.appender.SA.DatePattern=%Y-%m-%d:%H
log4cplus.appender.SA.File= log_util.log
# 最大的日志文件数量为MaxBackupIndex+1
log4cplus.appender.SA.MaxBackupIndex=100
# 缓冲区大小
log4cplus.appender.SA.BufferSize=131072
# 往后追加
log4cplus.appender.SA.Append=true
# 输出格式
log4cplus.appender.SA.layout=log4cplus::PatternLayout
log4cplus.appender.SA.layout.ConversionPattern=%D{%Y-%m-%d %H:%M:%S,%Q} [%l] %-5p %m%n

异步

log4cplus.logger.global = INFO, AA
# 指定Appender的类型
log4cplus.appender.AA=log4cplus::AsyncAppender
# 队列的限制
log4cplus.appender.AA.QueueLimit=10000
log4cplus.appender.AA.Appender=log4cplus::DailyRollingFileAppender
log4cplus.appender.AA.Appender.Schedule=HOURLY
log4cplus.appender.AA.Appender.Threshold = INFO
log4cplus.appender.AA.Appender.DatePattern=%Y-%m-%d-%H
log4cplus.appender.AA.Appender.File=./logger_test.log
log4cplus.appender.AA.Appender.ImmediateFlush=false
log4cplus.appender.AA.Appender.MaxFileSize=1000MB  
log4cplus.appender.AA.Appender.MaxBackupIndex=100
log4cplus.appender.AA.Appender.Append=true
log4cplus.appender.AA.Appender.layout=log4cplus::PatternLayout  
log4cplus.appender.AA.Appender.layout.ConversionPattern=%D{%Y-%m-%d %H:%M:%S,%Q} [%t] %-5p %m%n

示例一

#配置文件（其它日志级别配置相同）：
log4cplus.logger.console=TRACE,logConsole
log4cplus.logger.root=TRACE,ERROR_MSGS, DEBUG_MSGS, INFO_MSGS
    #不向默认对象（rootLogger）输出,因此信息只能输出到文件
log4cplus.additivity.file=false
###############################CONSOLE##########################################
log4cplus.appender.logConsole=log4cplus::ConsoleAppender
log4cplus.appender.logConsole.Encoding=utf-8
log4cplus.appender.logConsole.layout=log4cplus::PatternLayout
log4cplus.appender.logConsole.layout.ConversionPattern=[%D{%Y-%m-%d %H:%M:%S}] %-5p %m %n
################################DEBUG####################################
#设置日志追加到文件尾
log4cplus.appender.DEBUG_MSGS=log4cplus::TimeBasedRollingFileAppender
log4cplus.appender.DEBUG_MSGS.FilenamePattern=debug.%d{yyyyMMdd}.log
log4cplus.appender.ERROR_MSGS.Schedule=DAILY
log4cplus.appender.ERROR_MSGS.MaxHistory=365
log4cplus.appender.DEBUG_MSGS.Append=true
log4cplus.appender.DEBUG_MSGS.RollOnClose=false
log4cplus.appender.DEBUG_MSGS.CreateDirs=true
#设置日志文件大小
log4cplus.appender.DEBUG_MSGS.MaxFileSize=10MB
#设置生成日志最大个数
log4cplus.appender.DEBUG_MSGS.MaxBackupIndex=5
#设置编码
log4cplus.appender.DEBUG_MSGS.Encoding=utf-8
# 打印格式
log4cplus.appender.DEBUG_MSGS.layout=log4cplus::PatternLayout
log4cplus.appender.DEBUG_MSGS.layout.ConversionPattern=[%D{%Y-%m-%d %H:%M:%S}] %-5p %m %n
#匹配相同日志级别，只有wx_uservedio日志才输入到该文件中
log4cplus.appender.DEBUG_MSGS.filters.1=log4cplus::spi::LogLevelMatchFilter
log4cplus.appender.DEBUG_MSGS.filters.1.LogLevelToMatch=DEBUG
log4cplus.appender.DEBUG_MSGS.filters.1.AcceptOnMatch=true
log4cplus.appender.DEBUG_MSGS.filters.2=log4cplus::spi::DenyAllFilter
################################ERROR####################################
#设置日志追加到文件尾
log4cplus.appender.ERROR_MSGS=log4cplus::TimeBasedRollingFileAppender
log4cplus.appender.ERROR_MSGS.FilenamePattern=error.%d{yyyyMMdd}.log
log4cplus.appender.ERROR_MSGS.Schedule=DAILY
log4cplus.appender.ERROR_MSGS.MaxHistory=365
log4cplus.appender.ERROR_MSGS.Append=true
log4cplus.appender.ERROR_MSGS.RollOnClose=false
log4cplus.appender.ERROR_MSGS.CreateDirs=true
#设置日志文件大小
log4cplus.appender.ERROR_MSGS.MaxFileSize=10MB
#设置生成日志最大个数
log4cplus.appender.ERROR_MSGS.MaxBackupIndex=5
log4cplus.appender.ERROR_MSGS.Encoding=utf-8
log4cplus.appender.ERROR_MSGS.layout=log4cplus::PatternLayout
#设置日志打印格式
log4cplus.appender.ERROR_MSGS.layout.ConversionPattern=[%D{%Y-%m-%d %H:%M:%S}] %-5p %m%n
#匹配相同日志级别，只有wx_uservedio日志才输入到该文件中
log4cplus.appender.ERROR_MSGS.filters.1=log4cplus::spi::LogLevelMatchFilter
log4cplus.appender.ERROR_MSGS.filters.1.LogLevelToMatch=ERROR
log4cplus.appender.ERROR_MSGS.filters.1.AcceptOnMatch=true
log4cplus.appender.ERROR_MSGS.filters.2=log4cplus::spi::DenyAllFilter
################################INFO####################################
#设置日志追加到文件尾
log4cplus.appender.INFO_MSGS=log4cplus::TimeBasedRollingFileAppender
log4cplus.appender.INFO_MSGS.FilenamePattern=info.%d{yyyyMMdd}.log
log4cplus.appender.INFO_MSGS.Schedule=DAILY
log4cplus.appender.INFO_MSGS.MaxHistory=365
log4cplus.appender.INFO_MSGS.Append=true
log4cplus.appender.INFO_MSGS.RollOnClose=false
log4cplus.appender.INFO_MSGS.CreateDirs=true
#设置日志文件大小
log4cplus.appender.INFO_MSGS.MaxFileSize=10MB
#设置生成日志最大个数
log4cplus.appender.INFO_MSGS.MaxBackupIndex=5
log4cplus.appender.INFO_MSGS.Encoding=utf-8
log4cplus.appender.INFO_MSGS.layout=log4cplus::PatternLayout
#设置日志打印格式
log4cplus.appender.INFO_MSGS.layout.ConversionPattern=[%D{%Y-%m-%d %H:%M:%S}] %-5p %m %n   
#匹配相同日志级别，只有INFO日志才输入到该文件中
log4cplus.appender.INFO_MSGS.filters.1=log4cplus::spi::LogLevelMatchFilter
log4cplus.appender.INFO_MSGS.filters.1.LogLevelToMatch=INFO
log4cplus.appender.INFO_MSGS.filters.1.AcceptOnMatch=true
log4cplus.appender.INFO_MSGS.filters.2=log4cplus::spi::DenyAllFilter

示例二

log4cplus.rootLogger=DEBUG,ALL_MSGS,ERROR_MSGS
log4cplus.appender.ALL_MSGS=log4cplus::DailyRollingFileAppender
log4cplus.appender.ALL_MSGS.Schedule=DAILY
#log4cplus.appender.ALL_MSGS.DatePattern=yyyy-MM-dd
log4cplus.appender.ALL_MSGS.MaxFileSize=100MB
log4cplus.appender.ALL_MSGS.MaxBackupIndex=10
log4cplus.appender.ALL_MSGS.CreateDirs=true
log4cplus.appender.ALL_MSGS.File=log.log
log4cplus.appender.ALL_MSGS.layout=log4cplus::PatternLayout
log4cplus.appender.ALL_MSGS.layout.ConversionPattern=%d{%Y-%m-%d %H:%M:%S,%Q} %-4l [%t] %-5p %c{2} - %m%n
#Range
log4cplus.appender.ALL_MSGS.filters.1=log4cplus::spi::LogLevelRangeFilter
log4cplus.appender.ALL_MSGS.filters.1.LogLevelMin=TRACE
log4cplus.appender.ALL_MSGS.filters.1.LogLevelMax=FATAL
log4cplus.appender.ALL_MSGS.filters.1.AcceptOnMatch=true
log4cplus.appender.ALL_MSGS.filters.2=log4cplus::spi::DenyAllFilter
log4cplus.appender.ERROR_MSGS=log4cplus::DailyRollingFileAppender
log4cplus.appender.ERROR_MSGS.Schedule=DAILY
#log4cplus.appender.ERROR_MSGS.DatePattern=yyyy-MM-dd
log4cplus.appender.ERROR_MSGS.MaxFileSize=100MB
log4cplus.appender.ERROR_MSGS.MaxBackupIndex=10
log4cplus.appender.ERROR_MSGS.CreateDirs=true
log4cplus.appender.ERROR_MSGS.File=error.log
log4cplus.appender.ERROR_MSGS.layout=log4cplus::PatternLayout
log4cplus.appender.ERROR_MSGS.layout.ConversionPattern=%d{%Y-%m-%d %H:%M:%S,%Q} %-4l [%t] %-5p %c{2} - %m%n
#Match 
log4cplus.appender.ERROR_MSGS.filters.1=log4cplus::spi::LogLevelMatchFilter
log4cplus.appender.ERROR_MSGS.filters.1.LogLevelToMatch=ERROR
log4cplus.appender.ERROR_MSGS.filters.1.AcceptOnMatch=true
log4cplus.appender.ERROR_MSGS.filters.2=log4cplus::spi::DenyAllFilter

日更、按等级分流

#配置文件（其它日志级别配置相同）：
log4cplus.rootLogger=TRACE, DEBUG_MSGS, ERROR_MSGS, WARN_MSGS
#DEBUG
#设置日志追加到文件尾
log4cplus.appender.DEBUG_MSGS=log4cplus::RollingFileAppender
#设置每天记录一个日志文件
log4cplus.appender.DEBUG_MSGS.Schedule=DAILY
log4cplus.appender.DEBUG_MSGS.DatePattern=yyyy-MM-dd
#设置日志文件大小
log4cplus.appender.DEBUG_MSGS.MaxFileSize=100MB
#设置生成日志最大个数
log4cplus.appender.DEBUG_MSGS.MaxBackupIndex=10
#设置输出日志路径
log4cplus.appender.DEBUG_MSGS.File=/home/zhangshibo/log_test/log/debug.log
log4cplus.appender.DEBUG_MSGS.layout=log4cplus::PatternLayout
#设置日志打印格式
log4cplus.appender.DEBUG_MSGS.layout.ConversionPattern=[%D{%Y-%m-%d %H:%M:%S}]%p%m%n
#匹配相同日志级别，只有debug日志才输入到该文件中
log4cplus.appender.DEBUG_MSGS.filters.1=log4cplus::spi::LogLevelMatchFilter
log4cplus.appender.DEBUG_MSGS.filters.1.LogLevelToMatch=DEBUG
log4cplus.appender.DEBUG_MSGS.filters.1.AcceptOnMatch=true
log4cplus.appender.DEBUG_MSGS.filters.2=log4cplus::spi::DenyAllFilter
#ERROR
#设置日志追加到文件尾
log4cplus.appender.ERROR_MSGS=log4cplus::RollingFileAppender
#设置每天记录一个日志文件
log4cplus.appender.DEBUG_MSGS.Schedule=DAILY
log4cplus.appender.DEBUG_MSGS.DatePattern=yyyy-MM-dd
#设置日志文件大小
log4cplus.appender.ERROR_MSGS.MaxFileSize=100MB
#设置生成日志最大个数
log4cplus.appender.ERROR_MSGS.MaxBackupIndex=10
#设置输出日志路径
log4cplus.appender.ERROR_MSGS.File=/home/zhangshibo/log_test/log/error.log
#设置日志打印格式
log4cplus.appender.ERROR_MSGS.layout=log4cplus::PatternLayout
log4cplus.appender.ERROR_MSGS.layout.ConversionPattern=[%D{%Y-%m-%d %H:%M:%S}]%p%m%n
#匹配相同日志级别，只有debug日志才输入到该文件中
log4cplus.appender.ERROR_MSGS.filters.1=log4cplus::spi::LogLevelMatchFilter
log4cplus.appender.ERROR_MSGS.filters.1.LogLevelToMatch=ERROR
log4cplus.appender.ERROR_MSGS.filters.1.AcceptOnMatch=true
log4cplus.appender.ERROR_MSGS.filters.2=log4cplus::spi::DenyAllFilter
#WARN
#设置日志追加到文件尾
log4cplus.appender.WARN_MSGS=log4cplus::RollingFileAppender
#设置每天记录一个日志文件
log4cplus.appender.DEBUG_MSGS.Schedule=DAILY
log4cplus.appender.DEBUG_MSGS.DatePattern=yyyy-MM-dd
#设置日志文件大小
log4cplus.appender.WARN_MSGS.MaxFileSize=100MB
#设置生成日志最大个数
log4cplus.appender.WARN_MSGS.MaxBackupIndex=10
#设置输出日志路径
log4cplus.appender.WARN_MSGS.File=/home/zhangshibo/log_test/log/warn.log
#设置日志打印格式
log4cplus.appender.WARN_MSGS.layout=log4cplus::PatternLayout
log4cplus.appender.WARN_MSGS.layout.ConversionPattern=[%D{%Y-%m-%d %H:%M:%S}]%p%m%n
#匹配相同日志级别，只有debug日志才输入到该文件中
log4cplus.appender.WARN_MSGS.filters.1=log4cplus::spi::LogLevelMatchFilter
log4cplus.appender.WARN_MSGS.filters.1.LogLevelToMatch=WARN
log4cplus.appender.WARN_MSGS.filters.1.AcceptOnMatch=true
log4cplus.appender.WARN_MSGS.filters.2=log4cplus::spi::DenyAllFilter