本文介绍下,开源日志记录组件log4net在asp.net编程中的操作方法,log4net记录日志的功能非常强大。它可以将日志分不同的等级,以不同的格式,输出到不同的媒介。感兴趣的朋友参考下。
本节内容:
Visual Studio2010(Asp.Net Mvc3.0)中使用log4net快速创建系统日志,扩展输出自定义字段。
前言
用户可以从http://logging.apache.org/log4net/下载log4net的源代码。解压软件包后,在解压的src目录下将log4net.sln载入Visual Studio .NET,编译后可以得到log4net.dll。用户要在自己的程序里加入日志功能,只需将log4net.dll引入工程即可。
在项目中配置
第一步:首先在项目中引用log4net.dll文件。
第二步:在Web.config文件中进行添加configSections的节点
复制代码 代码示例:
<configSections>
<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/>
<!--配置一个结点 名称为log4net-->
</configSections>
第三步:添加log4net配置节点
复制代码 代码示例:
<log4net debug="true">
</log4net>
然后在log4net节点下添加写入本地文本文件中的配置
复制代码 代码示例:
<appender name="LogFileAppender" type="log4net.Appender.FileAppender" >
<!--定义的是日志记录到文件的附着器 name表示该附着器的名称-->
<!--在log4net中还有一个附着器RollingFileAppender 它表示会循环生成很多文件,举例来说,就是设置一共可以生成20个文件,每个文件的大小为2K,那么如果第一个、-->
<!--文件的大小超过2K,就会自动创建一个按顺序命名的文件-->
<param name="File" value="c:LogDBLog.txt" /> <!--日志记录的存在路径-->
<param name="AppendToFile" value="true" /><!--为true就表示日志会附加到文件,为false,则会重新创建一个新文件-->
<layout type="log4net.Layout.PatternLayout">
<!--输出内容控制-->
<param name="ConversionPattern" value="%d [%t] %-5p %c [%x] - %m%n" />
</layout>
</appender>
写入指定邮箱的配置:
复制代码 代码示例:
<appender name="SmtpAppender" type="log4net.Appender.SmtpAppender">
<!--设置发送电子邮件的附着器-->
<authentication value="Basic" />
<to value="518@qq.com" />
<from value="a@163.com" />
<username value="帐号" />
<password value="密码" />
<subject value="程序异常日志记录邮件发送" />
<smtpHost value="smtp.163.com" />
<bufferSize value="512" />
<lossy value="true" />
<evaluator type="log4net.Core.LevelEvaluator">
<threshold value="debug"/>
</evaluator>
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%newline%date [%thread] %-5level %logger [%property{NDC}] - %message%newline%newline%newline" />
</layout>
</appender>
通过的是163邮箱服务器发送
将日志写入数据库的相关配置,还要建立一张对应的数据库表
复制代码 代码示例:
<appender name="ADONetAppender" type="log4net.Appender.ADONetAppender">
<!--存储到数据库的操作-->
<bufferSize value="10"/>
<connectionType value="System.Data.SqlClient.SqlConnection, System.Data, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
<connectionString value="server=.;database=Log4Net;user id=sa;password=saa"/>
<commandText value="INSERT INTO _Log ([Date],[Thread],[Level],[Logger],[Message],[Exception]) VALUES (@log_date, @log_thread, @log_level, @log_logger, @log_message, @log_exception)"/>
<parameter>
<parameterName value="@log_date"/>
<dbType value="DateTime"/>
<layout type="log4net.Layout.RawTimeStampLayout"/><!--可以认为是记录日志的时间-->
</parameter>
<parameter>
<parameterName value="@log_thread"/>
<dbType value="String"/>
<size value="255"/>
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%thread"/><!--记录日志时的线程号-->
</layout>
</parameter>
<parameter>
<parameterName value="@log_level"/>
<dbType value="String"/>
<size value="50"/>
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%level"/><!--日志级别-->
</layout>
</parameter>
<parameter>
<parameterName value="@log_logger"/>
<dbType value="String"/>
<size value="255"/>
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%logger"/><!--哪个记录器存储的该日志-->
</layout>
</parameter>
<parameter>
<parameterName value="@log_message"/>
<dbType value="String"/>
<size value="4000"/>
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%message"/><!--日志信息-->
</layout>
</parameter>
<parameter>
<parameterName value="@log_exception"/>
<dbType value="String"/>
<size value="255"/>
<layout type="log4net.Layout.ExceptionLayout"/><!--异常信息-->
</parameter>
</appender>
另外一种写入文件的方式配置:
复制代码 代码示例:
<appender name="RollingFile" type="log4net.Appender.RollingFileAppender">
<!--这个就是我在上面提到的RollingFileAppender-->
<file value="example.log" /><!--文件名称-->
<appendToFile value="false" /><!--会创建新文件,一般设置为true,这里设置为false,是为了看到创建的文件-->
<maximumFileSize value="1KB" /><!--文件大小-->
<maxSizeRollBackups value="20" /><!--创建最大文件数-->
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%level %thread %logger - %message%newline" />
</layout>
</appender>
在log4net节点中还有两个节点:
复制代码 代码示例:
<logger name="Loggering">
<level value="Warn"/>
<appender-ref ref="ADONetAppender"/>
</logger>
<root>
<level value="info" />
<!--<appender-ref ref="ADONetAppender" />-->
<appender-ref ref="SmtpAppender"/>
<!--<appender-ref ref="LogFileAppender"/>
<appender-ref ref="ColoredConsoleAppender"/>
<appender-ref ref="EventLogAppender"/>
<append-ref ref="NetSendAppender"/>
<appender-ref ref="RollingFile"/>-->
</root>
在框架的体系里,所有的日志对象都是根日志(root logger)的后代。 因此如果一个日志对象没有在配置文件里显式定义,则框架使用根日志中定义的属性。
在<root>标签里,可以定义level级别值和Appender的列表。如果没有定义LEVEL的值,则缺省为DEBUG。可以通过<appender-ref>标签定义日志对象使用的Appender对象。<appender-ref>声明了在其他地方定义的Appender对象的一个引用。在一个logger对象中的设置会覆盖根日志的设置。
而对Appender属性来说,子日志对象则会继承父日志对象的Appender列表。这种缺省的行为方式也可以通过显式地设定<logger>标签的additivity属性为false而改变。
数据库日志的写入和邮箱的写入,在Global.asax文件初始化配置:
复制代码 代码示例:
protected void Application_Start()
{
//读取日志 如果使用log4net,应用程序一开始的时候,都要进行初始化配置
log4net.Config.XmlConfigurator.Configure();
AreaRegistration.RegisterAllAreas();
RegisterGlobalFilters(GlobalFilters.Filters);
RegisterRoutes(RouteTable.Routes);
}
调用示例:
复制代码 代码示例:
private static
readonly log4net.ILog log = log4net.LogManager.GetLogger("Loggering");
public ActionResult About()
{
log.Info("log日志信息");
log.Debug("debug信息");
log.Error("error信息");
log.Warn("warn信息");
Exception ex = new Exception("测试的异常信息");
log.Fatal("fatal信息", ex);
return View();
}
Log4net中 DEBUG、INFO、WARN、ERROR 区分得很好。正常的 DEBUG、INFO 的日志, 就让它记录在 日志文件里面吧。
对于 WARN、ERROR 级别的日志, 记录到日志文件的同时, 顺便发送电子邮件到我的信箱里面。 这样一来, 我也不必每天去看日志文件, 二来,出了什么问题, 能及时通过电子邮件得到通知。
数据库结构:
复制代码 代码示例:
create database Log4Net
go
use Log4Net
create table _log
(
id int identity(1,1) primary key not null,
date datetime null,
thread int null,
level varchar(10) null,
logger varchar(20) null,
Message varchar(100) null,
Exception varchar(100) null
)