首页 > 代码库 > Log4net - 规则简介(续)
Log4net - 规则简介(续)
之前对于配置并没有结束, 中间插了一个demo进去, 能够更直观的看到日志是怎么使用的. 这一篇, 我加了一些自己的东西进去, 可以更直观的来理解这些配置内容.
这里就继续介绍配置文件中的内容.
1. <log4net> 标签
<log4net debug="true"></log4net>
支持的属性:
debug | 可选,取值是true或false,默认是false。设置为true,开启log4net的内部调试。 |
update | 可选,取值是Merge(合并)或Overwrite(覆盖),默认值是Merge。设置为Overwrite,在提交配置的时候会重置已经配置过的库。 |
threshold | 可选,取值是repository(库)中注册的level,默认值是ALL。 |
支持的元素:
appender | 0或多个 |
logger | 0或多个 |
renderer | 0或多个 |
root | 最多一个 |
param | 0或多个 |
2. <root>标签
<root> <level value="ALL" /> <appender-ref ref="ErrorLogFileAppender" /> <appender-ref ref="TraceLogFileAppender" /> </root>
根元素, 其他所有的logger都默认继承他, root没有属性
支持的子元素:
appender-ref | 0个或多个,要引用的appender的名字。 |
level |
最多一个。 只有在这个级别或之上的事件才会被记录。 OFF / FATAL / ERROR / WARN / INFO / DEBUG / ALL |
param | 0个或多个, 设置一些参数。 |
3. <logger>标签
从上一篇的例子中, 其实是找不到logger标签的, 如果只是简单的记录日志, 其实并不需要使用到这个标签
支持的属性:
name | 必须的,logger的名称 |
additivity | 可选,取值是true或false,默认值是true。设置为false时将阻止父logger中的appender。 |
支持的子元素:
appender-ref | 0个或多个,要引用的appender的名字。 |
level | 最多一个。 只有在这个级别或之上的事件才会被记录。 |
param | 0个或多个, 设置一些参数。 |
4. <appender>标签
<appender name="TraceLogFileAppender" type="log4net.Appender.RollingFileAppender"> <file value="Logs\Trace\" /> <appendToFile value="true" /> <MaxSizeRollBackups value="20" /> <RollingStyle value="Date" /> <DatePattern value="yyyy-MM-dd‘.txt‘" /> <StaticLogFileName value="false" /> <!--<MaximumFileSize value="http://www.mamicode.com/10MB"/>--> <layout type="log4net.Layout.PatternLayout,log4net"> <header value="[BEGIN LOGGING AT %date]%newline" type="log4net.Util.PatternString" /> <ConversionPattern value="%d [%t] %-5p %c - %m%n" /> <footer value="[END LOGGING AT %date]%newline%newline" type="log4net.Util.PatternString" /> </layout> <filter type="log4net.Filter.LevelRangeFilter,log4net"> <levelMin value="DEBUG" /> <levelMax value="INFO" /> </filter> </appender>
定义日志的输出方式,只能作为 log4net 的子元素。name属性必须唯一,type属性必须指定。
支持的属性:
name | 必须的,Appender对象的名称 |
type | 必须的,Appender对象的输出类型 |
支持的子元素:
appender-ref | 0个或多个,允许此appender引用其他appender,并不是所以appender类型都支持。 |
filter | 0个或多个,定义此app使用的过滤器。 |
layout | 最多一个。定义appender使用的输出格式。 |
param | 0个或多个, 设置Appender类中对应的属性的值。 |
实际上<appender>所能包含的子元素远不止上面4个。
在我过去的项目中, 常用的也就两种, 一种是写入文件中, 另一种是写入数据库中. 对于发送到邮件中的, 暂时还没有使用过. 那就主要介绍下前面两种方式吧.
4.1 写入文件中
写入文件中, 各人习惯可能有些不一样, 当然也是与项目相关的. 有些人喜欢按照日期来存, 有些人喜欢放入一个文件中, 设置最大存储值来存. 都是可以的. 如果项目日志文件多, 可以分日期, 如果项目日志文件少, 那么分日期, 就不合算了, 可能会导致文件和日志一样多.
1). 日期方式
<appender name="ErrorLogFileAppender" type="log4net.Appender.RollingFileAppender"> <!--文件目录或者文件名--> <file value="Logs\Error\" /> <!--为true时, 日志文件只取file的名字; 为false时, 日志文件取名规则为 file+DatePattern--> <StaticLogFileName value="false" /> <!--文件名格式--> <DatePattern value="yyyy-MM-dd‘.txt‘" /> <!--记录日志的形式, Date/Size 两种, 此处表示按日期记录日志--> <RollingStyle value="Date" /> <!--是否追加到日志中, 默认为true, 无需设置--> <appendToFile value="true" /> <layout type="log4net.Layout.PatternLayout,log4net"> <header value="[BEGIN LOGGING AT %date]%newline" type="log4net.Util.PatternString" /> <ConversionPattern value="%d [%t] %-5p %c - %m%n" /> <footer value="[END LOGGING AT %date]%newline%newline" type="log4net.Util.PatternString" /> </layout> <filter type="log4net.Filter.LevelRangeFilter,log4net"> <levelMin value="ERROR" /> <levelMax value="FATAL" /> </filter> </appender>
日期方式, 要注意的几个地方, 我在上面用背景色标注出来了.
2). 文件大小限制方式
<appender name="ErrorLogFileAppender" type="log4net.Appender.RollingFileAppender"> <file value="Logs\Error.log" /> <RollingStyle value="Size" /> <!--文件夹下记录的日志文件个数, 需要与MaximumFileSize配合使用--> <MaxSizeRollBackups value="2" /> <!--每个日志文件大小, 不能为小数, 如果这里限制100kb, 但是需要记录的内容有150kb, 会全部记录的--> <!--可用单位 : KB / MB / GB --> <MaximumFileSize value="100KB"/> <StaticLogFileName value="true" /> <appendToFile value="true" /> <layout type="log4net.Layout.PatternLayout,log4net"> <header value="[BEGIN LOGGING AT %date]%newline" type="log4net.Util.PatternString" /> <ConversionPattern value="%d [%t] %-5p %c - %m%n" /> <footer value="[END LOGGING AT %date]%newline%newline" type="log4net.Util.PatternString" /> </layout> <filter type="log4net.Filter.LevelRangeFilter,log4net"> <levelMin value="ERROR" /> <levelMax value="FATAL" /> </filter> </appender>
从上面的配置看到, 文件夹下能建的日志文件是可以限制的, 那么如果满了怎么办? log4net 不会再创建新文件了, 而是重写的方式去记录日志. 换句通俗的说法, 就是在这几个文件里面转圈圈.
4.2 写入数据库中
<?xml version="1.0" encoding="utf-8" ?> <log4net> <root> <level value="ALL" /> <appender-ref ref="ADONetAppender" /> </root> <appender name="ADONetAppender" type="log4net.Appender.ADONetAppender"> <!--缓存条数, 一次性写入数据库, 调试时, 此处设置为1--> <bufferSize value="1" /> <param name="ConnectionType" value="MySql.Data.MySqlClient.MySqlConnection, MySql.Data" /> <param name="ConnectionString" value="server=localhost;user id=root;password=root;database=current;port=3306;CharSet=utf8;" /> <commandText value="insert into ErrorLog(dtDate,sThread,sLevel,sLogger,sMessage,sException) values (@log_date, @thread, @log_level, @logger, @message, @exception);" /> <parameter> <parameterName value="@log_date" /> <dbType value="DateTime" /> <layout type="log4net.Layout.RawTimeStampLayout" /> </parameter> <parameter> <parameterName value="@thread" /> <dbType value="String" /> <size value="100" /> <layout type="log4net.Layout.PatternLayout"> <conversionPattern value="%t" /> </layout> </parameter> <parameter> <parameterName value="@log_level" /> <dbType value="String" /> <size value="200" /> <layout type="log4net.Layout.PatternLayout"> <conversionPattern value="%p" /> </layout> </parameter> <parameter> <parameterName value="@logger" /> <dbType value="String" /> <size value="500" /> <layout type="log4net.Layout.PatternLayout"> <conversionPattern value="%logger" /> </layout> </parameter> <parameter> <parameterName value="@message" /> <dbType value="String" /> <size value="3000" /> <layout type="log4net.Layout.PatternLayout"> <conversionPattern value="%m" /> </layout> </parameter> <parameter> <parameterName value="@exception" /> <dbType value="String" /> <size value="4000" /> <layout type="log4net.Layout.ExceptionLayout" /> </parameter> </appender> </log4net>
附上建表sql
CREATE TABLE `errorlog` ( `id` int(11) NOT NULL AUTO_INCREMENT, `dtDate` datetime DEFAULT NULL, `sThread` varchar(100) DEFAULT NULL, `sLevel` varchar(200) DEFAULT NULL, `sLogger` varchar(500) DEFAULT NULL, `sMessage` varchar(3000) DEFAULT NULL, `sException` varchar(4000) DEFAULT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB AUTO_INCREMENT=21 DEFAULT CHARSET=utf8 COMMENT=‘错误日志表‘
OK, 接下来可以直接看结果了:
还是蛮好用的, 配置起来也很简单. 使用起来更简单.
参考:
log4net使用手册
Log4net - 规则简介(续)