log4net, 是 apache.org 在 log4j的基础上推出的针对.NET程序的开源的日志组件。
log4net目前的最新版本是 1.2.10,log4net支持的日志保存方式,可谓丰富之极,包括:
- 存入SQL SERVER 数据库
- 存入ACCESS数据库
- 存入ORACLE数据库
- 存入DB2数据库
- 存入SQLLite数据库
- 生成asp.net 的trace模式的日志
- 缓存方式的日志
- 直接输出到控制台屏幕(支持彩色)
- 存入系统日志
- 生成单文件日志
- 生成多文件日志
- 保存在内存中
- 利用net send 发送给指定的网络域或主机
- 远程生成日志
- 利用SMTP发送日志到指定的邮箱
- 利用IIS的SMTP,将日志放入MAIL目录
- 利用UDP协议发送日志
上面的,各种日志保存方式的具体配置细节, 在 这里
log4net的日志记录分为7级,从高到低为: OFF、FATAL、ERROR, WARN, INFO, DEBUG, ALL
要使用log4net,必须给log4net指定好配置文件, 有两种方法:
- 放入 web.config 或 app.config
- 放入一个单独的配置文件,如: log4net.config (推荐)
log4net的配置格式,大致如下:
< log4net debug ="false" >
< appender name ="RollingLogFileAppender" type ="log4net.Appender.RollingFileAppender" >
< file value ="log.txt" />
< appendToFile value ="true" />
< rollingStyle value ="Composite" />
< datePattern value =".yyyyMMdd" />
< maxSizeRollBackups value ="10" />
< maximumFileSize value ="1MB" />
< staticLogFileName value ="true" />
< layout type ="log4net.Layout.PatternLayout" >
< conversionPattern value ="%date %-5level %logger -%m%n" />
</ layout >
</ appender >
< root >
< level value ="WARN" />
< appender-ref ref ="RollingLogFileAppender" />
</ root >
</ log4net >
上面给出的是一个独立的log4net的配置文件,大体解释一下:
<log4net></log4net>是根,<root></root>是必须的,是所有日志格式的根,其中定义了,日志记录的基础级别,和当前启用的日志记录方式, 上面的 appender 将继承root的level
appender中的 type 指明了,采用哪种方式来记录日志,具体取值,大家去 这里 查看
layout是日志输出格式的定义 :
%d, %date :表示当然的时间
%level : 表示日志的级别
%logger, %c:表示日志产生的主题,通常是所在的类名,便于定位问题
%t, %thread: 表示 所在进程
%L: 表示产生日志的代码所在的行数
%m, %message :表示日志的具体内容
%n, %newline: 换行
--------------------------------------------------------------------------
我上面的是一个多文件日志的配置, 每天产生一个日志文件,日志名字是
log.txt.20081228
的形式
下面重点说一下使用的具体步骤:
1. 加入 log4net.dll 的引用
2. 对于 web application 和 winform
在 AssemblyInfo.cs 中,加入
[assembly: log4net.Config.XmlConfigurator(ConfigFile="log4net.config", Watch=true)] //log4net.config 是配置文件的名称,可以自行设置 //Watch 是表示在程序运行期间是否监视该配置文件的变动
3. 对于 website 项目,需要在 global.asax.cs 里,加入
protected void Application_Start(Object sender, EventArgs e) { //配置log4net log4net.Config.XmlConfigurator.Configure( new System.IO.FileInfo("log4net.config")); }
4. 实际调用
{
private static readonly ILog log = LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
// System.Reflection.MethodBase.GetCurrentMethod().DeclaringType
// 是利用反射获取当前类的type,记录在日志中,便于定位日志发生的所在
static void Main( string [] args)
{
log.Error( " 这是一个错误日志 " );
log.Fatal( " 这是一个致命的错误日志 " );
log.Warn( " 这是一条警告日志 " );
log.Info( " 这是一条普通信息 " );
Console.Read();
}
}