当我们开发软件时,一般都会加入运行期的跟踪手段,以方便后续故障分析和Bug调试。.net framework本身提供了一个System.Diagnostics.Trace类来实现流程跟踪功能,但很多时候却不能满足我们的需求,这时往往需要一个更加强大的第三方日志系统。
前段时间在项目中使用了log4net来记录日志,感觉还不错,这里简单的介绍一下它的用法。使用log4net需要如下几个步骤:
一、在Nuget中下载log4net
二、在使用日志的类的名字空间前加上XmlConfiguratorAttribute标记
不加这个标记的话则log无法生效,如果类较多则比较麻烦,此时可以把这个配置放在AssemblyInfo.cs中,针对整个程序集生效。
三、在代码中使用log4net记录日志
简单的做法就是直接使用内置的Log类:
static void Main(string[] args)
{
ILog log = log4net.LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
log.Error("error", new
Exception("发生了一个异常"));
log.Fatal("fatal", new
Exception("发生了一个致命错误"));
log.Info("info");
log.Debug("debug");
log.Warn("warn");
Console.WriteLine("日志记录完毕。");
}
四、配置输出方式
log4net的输出方式是通过配置文件(App.config)来控制的,通过配置文件的好处是非常灵活,可以动态改变配置。一个简单的示例如下:
<?xml
version="1.0"
encoding="utf-8" ?>
<configuration>
<configSections>
<section
name="log4net"
type="System.Configuration.IgnoreSectionHandler"/>
</configSections>
<log4net>
<root>
<appender-ref
ref="LogFileAppender" />
</root>
<appender
name="LogFileAppender"
type="log4net.Appender.RollingFileAppender">
<file
value="r:/log4netfile.txt" />
<appendToFile
value="true" />
<rollingStyle
value="Date" />
<LockingModel
type="log4net.Appender.FileAppender+MinimalLock, log4net"/>
<datePattern
value="yyyyMMdd-HH:mm:ss" />
<layout
type="log4net.Layout.PatternLayout">
<param
name="ConversionPattern"
value="%d [%t] %-5p %c [%x] %X{auth} - Line:%L %m%n" />
</layout>
</appender>
</log4net>
</configuration>
配置文件的方式初看上去非常复杂,但使用过后就会体会到它的强大之处。上面的配置定义了一个文本文件的方式输出日志,这个也是最常用的一种方式。log4net提供了非常强大的控制策略,例如,可以控制输出日志输出格式、页眉页脚、覆盖策略、安全控制等。具体的说明可以参看下Log4net中的RollingFileAppender解析这篇文章。
除了以文本方式输出外,还可以使用系统日志、数据库、控制台、邮件等多种方式。并且可以组合使用,这里就不一一介绍了,感兴趣的朋友可以参考下log4net的各种Appender配置示例这篇文章。
小结
log4net非常灵活而强大,是一个不可多得的日志系统。本文这里只是介绍了一下log4net的基本用法,方便初次上手的朋友快速入门。如果需要更加深入的了解它,请参考codeproject上的文章log4net Tutorial。