log4net系列(三)--详解RollingFileAppender

这篇讲讲实际产品中最常用到的appender -- RollingFileAppender。

前面讲过FileAppender，应该不难想到，如果一个系统的所有日志都记在一个日志文件里，那岂不是要撑爆了？所以我们真正使用的是RollingFileAppender，它基于时间生成一系列的日志文件，避免单个文件过大的问题。下面是一个经典的RollingFileAppender配置：

  <appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender">    <param name="File" value="D:\WebTest\" />    <param name="AppendToFile" value="true" />    <param name="MaxSizeRollBackups" value="10" />    <param name="MaximumFileSize" value="10MB" />    <param name="StaticLogFileName" value="false" />    <param name="DatePattern" value="yyyy-MM-dd'.txt'" />    <param name="RollingStyle" value="Composite" />    <param name="lockingModel" type="log4net.Appender.FileAppender+MinimalLock" />    <layout type="log4net.Layout.PatternLayout">      <param name="ConversionPattern" value="%d [%t] %-5p %c [%M] - Line %L:%m%n" />    </layout>  </appender>

我们从需求的角度反向分析这些配置的细节。

1. 我们的日志要存到哪里？

<param name="File" value="D:\WebTest\" />为我们指定了路径。

2. 日志文件怎么命名？

<param name="DatePattern" value="yyyy-MM-dd'.txt'" />指定文件名的日期格式。如果要加个".txt"的后缀，需要用单引号把它包起来。用&quot;也可以，即下面的写法是等价的：<param name="DatePattern" value="yyyy-MM-dd&quot;.txt&quot;" />

<param name="StaticLogFileName" value="false" />指明文件名是变动的。这个设成true的话不能生成rolling的日志文件。

<param name="RollingStyle" value="Composite" />指明文件的命名方式。"Composite"指文件名同时按size和date来命名，一般就用这个。还有其他3个取值：Once(每次程序启动新生成一个)、Size、Date。当RollingStyle=Composite时，如果File参数设为"D:\WebTest\MyLog_" ，那么文件名将是："MyLog_2015-11-27.txt"。

3. 怎么限定日志文件的大小？

<param name="MaximumFileSize" value="10MB" />限定每个日志文件不超过10M。

4. 日志超过指定大小后会怎样？

<param name="MaxSizeRollBackups" value="10" />表明，到达限制大小后会生成一个新文件，如"2015-11-27.txt.1"，依此类推，当生成"2015-11-27.txt.10"之后，再满了就要回头覆盖第一个文件了。

5. 日志以什么方式写？

<param name="AppendToFile" value="true" />说明日志以增量方式写入。设成false就是覆盖模式了。

6. 日志内容的格式可以定义吗？

<layout type="log4net.Layout.PatternLayout">
   <param name="ConversionPattern" value="%d [%t] %-5p %c [%M] - Line %L:%m%n" />
</layout>

layout标签中的ConversionPattern参数可以定义每条消息的格式，比如上面这个意思是："时间 [线程id] 级别 类名 [方法名] - Line 行号:消息内容+换行符"，

例子：2015-11-27 19:18:25,320 [89] ERROR ASP.default_aspx [Page_Load] - Line 9:Hello World!

layout的参数详解会单独用一章来讲。

7. 写日志会影响系统性能吗？

写日志必然是会消耗一定资源的，而RollingFileAppender也不是线程安全的。为了减小log4net影响系统性能的嫌疑，我们加入lockingModel参数，使用FileAppender.MinimalLock来减少并发时发生死锁的概率：

<param name="lockingModel" type="log4net.Appender.FileAppender+MinimalLock" />

尽管如此，文件的I/O始终是耗性能的，有没有办法缓存一批日志，然后一次性写入文件呢？BufferingForwardingAppender正是为此而生，我们下章再介绍如何使用它。