Log4Net日志记录简单使用讲解

　一. Log4Net 简介

　　Log4net 是 Apache 下一个开放源码的项目，我们可以控制日志信息的输出目的地（数据库、控制台、文本文档、文件）。Log4net中定义了多种日志信息输出模式。

　　在做项目的时候令我最头疼的是在程序发布到正式环境之后出现了问题，我们不能调试而且问题很难重新，于是我们需要大量的日志数据来精确的跟踪程序的运行状况。

　　Log4net就可以帮我来解决这一个难题，对于日志的输出我们不需要人为的去干涉，它可以根据需要将日志输出到控制台，文本文件，windows 日志事件查看器中，包括数据库，邮件等等位置，以便我们快速跟踪程序bug。

二. Log4Net 简单使用

　　使用Log4net必须引入log4net.dll 文件，因为log4net 是开源的，所以可以直接将源码添加到工程项目中去。然后生成新的dll文件。

1.首先引用Log4Net.dll

2.如果是在Web程序中，我们可以将这句话添加到 Global.asax 文件的Application_Start(object sender, EventArgs e) 方法中，在程序启动的时候就初始化配置信息:

log4net.Config.XmlConfigurator.Configure(); --这句话相当于初始化注册Log4net ,

注：如果不是Web程序则每次调用时候写这句话。

3.配置web.config

下面使用配置一个最简单的文件输出和控制台输出。

　　Log4Net 的配置文件，此段内容添加到App.config 或者　web.config 文件中：

<configSections>
<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net"/>
</configSections>
<log4net>
<appender name="FileAppender" type="log4net.Appender.FileAppender">
<file value="D:\a.log"></file>
<appendToFile value="true"></appendToFile>
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="[%d]:%n%m%n"></conversionPattern>
</layout>
</appender>
<appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender">
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="[%d]:%n%m%n"></conversionPattern>
</layout>
</appender>
<root>
<level value="INFO"></level>
<appender-ref ref="FileAppender"></appender-ref>
<appender-ref ref="ConsoleAppender"></appender-ref>
</root>
<logger name="MyLogger">
<level value="ERROR"></level>
<appender-ref ref="FileAppender"></appender-ref>
<appender-ref ref="ConsoleAppender"></appender-ref>
</logger>
</ log4net>

　　控制台程序测试例子:

ILog log = LogManager.GetLogger("MyLogger");
static void Main(string[] args)
{
log4net.Config.XmlConfigurator.Configure();
Program program = new Program();
program.log.Info(">>>>>>>>>>>>>>");
program.log.Info(">>>>>>>>>>>>>>1");
program.log.Info(">>>>>>>>>>>>>>2");
}

注：上述例子是不会输出任何日志信息的，因为配置级别的限制。 下面我们来看下日志的结构

　三. Log4Net 结构

　　Log4net 主要分为5个核心组件: Logger, Appender, Filter, Layout, Object Render。

　　Logger:

　　主要用于记录日志的分类和控制日志的级别。它可以以多种格式输出日志信息，同时它也可以控制日志的输出级别。上面的简单例子我们看似做了日志输出，但是没有输出任何日志结果，因为我们在日志级别上做了限制。

　　Appender：

　　这里我们简单称之为“附着器”。意思就是说日志的输出必须依赖于它，更确切的说以文本形式输出，还是控制台格式输出都必须要依靠它来控制。Log4net定义了多种附着器：

　　(1) AdoNetAppender 将日志记录到数据库中。可以采用SQL和存储过程两种方式 。

　　(2) AnsiColorTerminalAppender 在ANSI 窗口终端写下高亮度的日志事件。

　　(3) AspNetTraceAppender 能用asp.net中Trace的方式查看记录的日志。

　　(4) BufferingForwardingAppender 在输出到子Appenders之前先缓存日志事件。

　　(5) ConsoleAppender 将日志输出到控制台。

　　(6) EventLogAppender 将日志写到Windows Event Log。

　　(7) FileAppender 将日志写到文件中。

　　(8) MemoryAppender 将日志存到内存缓冲区。

　　(9) NetSendAppender 将日志输出到Windows Messenger service，这些日志信息将在用户终端的对话框中显示。

　　(10) RemoteSyslogAppender 通过UDP网络协议将日志写到Remote syslog service。

　　(11) RemotingAppender 通过.NET Remoting将日志写到远程接收端。

　　(12) RollingFileAppender 将日志以回滚文件的形式写到文件中。

　　(13) SmtpAppender 将日志写到邮件中。

　　(14) TraceAppender 将日志写到.NET trace 系统。

　　(15) UdpAppender 将日志connectionless UDP datagrams的形式送到远程宿主或以UdpClient的形式广播。

　　Filter:

　　Appender 是将日志以缺省值的方式输出，意思就是按照默认值的方式输出。而Filter 意思就是过滤器，使用Filter 可以将日志以不同格式来输出。

　　Layout:

　　这个用于控制日志输出显示格式。

　　Object Render:

　　用于按照用户自定义标准来输出日志。

　　Log4net 结构图 （从其他地方截图过来）

　Log4net 的日志对象管理器LogManager：LogManager是用于来管理所有的Logger对象的，GetLogger() 可以用来查找已经存在的Logger对象，如果对象不存在它会自动创建一个Logger对象，并且管理它。

　　四. Log4Net 日志级别

　　Log4net 分为如下几个级别：

　　FATAL  毁灭级别

　　ERROR 错误级别

　　WARN 警告级别

　　INFO 消息级别

　　DEBUG 调试级别

　　这几种日志级别高低：FATAL> ERROR> WARN > INFO > DEBUG。

　　只有日志输出级别大于或等于配置的级别才能输出日志信息。

　　比如我的日志配置级别为INFO，那么只有log.Info(), log.Warn(), log.Error(), log.Fatal()才能输出日志信息，Debug方式就不能输出。

　　Log4net中还有两种特殊的配置级别: ALL - 允许所有的日志级别输出，OFF - 拒绝所有的日志级别输出。

　　五. Log4Net 配置说明

<configSections>
<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net"/>
</configSections>
<log4net>
<!--记录日志到数据库-->
<appender name="AdoNetAppender" type="log4net.Appender.AdoNetAppender">
<bufferSize value="100" />
<connectionType value="System.Data.SqlClient.SqlConnection, System.Data, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
<connectionString value="data source=GAS-HECHEN;initial catalog=dsc141051_db;integrated security=false;persist security info=True;User ID=sa;Password=000000" />
<commandText value="INSERT INTO Log ([Date],[Thread],[Level],[Logger],[Message],[Exception]) 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="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="@logger" />
<dbType value="String" />
<size value="255" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%logger" />
</layout>
</parameter>
<parameter>
<parameterName value="@message" />
<dbType value="String" />
<size value="4000" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%message" />
</layout>
</parameter>
<parameter>
<parameterName value="@exception" />
<dbType value="String" />
<size value="2000" />
<layout type="log4net.Layout.ExceptionLayout" />
</parameter>
</appender>

<!--输入日志到控制台-->
<appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender">
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="[时间]:%d%n[级别]:%p%n[内容]:%m%n%n"></conversionPattern>
</layout>
</appender>

<appender name="FileAppender" type="log4net.Appender.FileAppender">
<param name="file" value="D:\a.log"></param>
<param name="appendToFile" value="true"></param>
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="[时间]:%d%n[级别]:%p%n[内容]:%m%n%n"></conversionPattern>
</layout>
</appender>

<root>
<level value="INFO"></level>
<appender-ref ref="FileAppender"></appender-ref>
<appender-ref ref="ConsoleAppender"></appender-ref>
</root>
<logger name="MyLogger">
<level value="INFO"></level>
<appender-ref ref="FileAppender"></appender-ref>
<appender-ref ref="ConsoleAppender"></appender-ref>
</logger>
</log4net>

　　这个配置文件定义了三种不同的Appender，分别是ADO.NET 记录到数据，ConsoleAppender 从控制台输出， FileAppender 日志信息文件输出。

　　然而Log4Net 的配置附着器远不止这些，这里上传一个比较全的附着器配置文件供大家参考 点击下载。

　　根据上面的日志配置文件仍然使用如下代码测试:

　　这里需要注意，log4net.Config.XmlConfigurator.Configure();   这个相当于初始化Log4net, 如果是在Web程序中，我们可以将这句话添加到 Global.asax 文件的Application_Start(object sender, EventArgs e) 方法中，在程序启动的时候就初始化配置信息。

　　上面的程序运行结果图，控制台输出结果为：

　　信息记录到指定的磁盘文件中，记录的结果如下图:

　　这里说明两个配置:

　　这里的 root 和 logger 配置节点，root 就相当于默认的日志对象配置，而logger是指定特定的日志配置。他们可以共存。

　　对于这两个节点下面都有 level 和 appender-ref 节点，分别用于指定日志的输出级别和引用哪些附着器。每个日志对象都可以使用多个appender，这里的配置同时使用文件输出和控制台输出。得到的结果就是上面两个结果图。

　　下面的logger对象添加了AdoNetAppender附着器，当使用MyLogger日志对象的时候就会使用这三种不同的方式记录日志。

　上面的程序声明了两个日志对象 log 和 log1，log 是在初始化的时候存在的，它得到的是<logger name="MyLogger"> 这个日志对象，而log1 是 LogManager 中不存在的日志对象，这里它会重新创建一个并且由LogManager 管理，后面再次使用则使用这个已经存在的对象。 这里两个日志对象同时使用结果如下：

　　现在我修改配置文件的日志文件输出级别：

<logger name="MyLogger">
<level value="WARN"></level>
<appender-ref ref="FileAppender"></appender-ref>
<appender-ref ref="ConsoleAppender"></appender-ref>
<appender-ref ref="AdoNetAppender"></appender-ref>
</ logger>

　　运行得到的结果如图：

显然MyLogger对象日志没有输出日志信息。

　　六. Log4Net 参数说明 

　　上面我们看到的配置文件中有类似 %m %n 等这样的符号，这些符号都是有特殊意义的。

%m[%message] : 输出的日志消息
%n : 换行
%d[%datetime] : 输出当前语句运行的时刻
%r : 输出程序从运行到执行到当前语句时消耗的毫秒数
%d ： 当前语句所在的线程ID
%p : 日志的当前优先级别
%c ：当前日志对象的名称
%L : 输出语句所在的行号
%F ：输出语句所在的文件名
%-数字 ：表示该项的最小长度，如果不够，则用空格填充

原文地址：https://www.cnblogs.com/zpyplan/p/9565505.html

时间： 2024-10-10 03:34:38

Log4Net日志记录简单使用讲解的相关文章

Log4Net日志记录两种方式

本文转载:http://www.cnblogs.com/wolf-sun/p/3347373.html#3009010 简介 log4net库是Apache log4j框架在Microsoft .NET平台的实现,是一个帮助程序员将日志信息输出到各种目标(控制台.文件.数据库等)的工具.     log4net是Apache软件基金会Apache Logging Services工程的一部分.Apache日志服务工程致力于为程序调试和审计提供跨语言的日志服务.(f:百度百科) 原理 Log4ne

C#Log4net日志记录组件的使用

一.Log4Net介绍 Log4net是基于.NET开发的一款非常著名的记录日志开源组件.它通过一套XML配置的日志引擎,将日志分不同的等级,分别是:FATAL . ERROR. WARN. INFO . DEBUG.ALL(允许所有的日志请求)和OFF(拒绝所有的日志请求),缺省为DEBUG,前五个可以看到和我们平常在调试应用程序的出错有点类似,在编译器中也会留下如错误.警告之类的提示信息,它们的错误级别不断的降低. 我们接着看Log4net的核心组成部分,Log4net主要由五个部分组成,分

Log4Net日志记录介绍

原文地址 : http://www.cnblogs.com/wolf-sun/p/3347373.html#3009010 简介 log4net库是Apache log4j框架在Microsoft .NET平台的实现,是一个帮助程序员将日志信息输出到各种目标(控制台.文件.数据库等)的工具.     log4net是Apache软件基金会Apache Logging Services工程的一部分.Apache日志服务工程致力于为程序调试和审计提供跨语言的日志服务.(f:百度百科) 原理 Log4

log4net日志记录

这里是接着上一篇来优化的,上篇:ASP.NET MVC中错误日志信息记录 log4Net是用来记录日志的,可以将程序运行过程中的信息输出到一些地方(文件,数据库,EventLog等),日志就是程序的黑匣子,可以通过日志查看系统的运行过程,从而发现系统的问题. 1.引用log4net.dll bin\net\2.0\release,不要引用debug版本 2.在Web.Config添加配置 把下面配置信息加到web.config中 Log4Net配置 <configuration> <co

C#- 实用的Log4Net日志记录例子

工作中也是要用到日志记录的,LOG4NET在这块做的不错,以后可以继续拿来用. 1.引用DLL 2.LOG4NET的配置文件 <?xml version="1.0" encoding="utf-8" ?> <configuration> <configSections> <section name="log4net" type="log4net.Config.Log4NetConfigurati

Log4net日志记录、详细配置(自己使用)

[来自百度百科的一句介绍]log4net库是Apache log4j框架在Microsoft .NET平台的实现,是一个帮助程序员将日志信息输出到各种目标(控制台.文件.数据库等)的工具. 1.首先添加对log4net.dll的引用.可以去[http://logging.apache.org/log4net/download_log4net.cgi]下载或者NuGet 2.在web.config(App.config)中进行配置 1 <configuration> 2 <configSe

Log4net 日志记录配置信息

<log4net> 8 <!--配置日志的级别,低于此级别的就不写到日志里面去 9 OFF.FATAL.ERROR, WARN, INFO, DEBUG, ALL 10 --> 11 <root> 12 <level value="DEBUG" /> 13 <appender-ref ref="LogFileAppender" /> 14 <appender-ref ref="Console

使用log4net无法将日志记录插入mysql数据库解决办法

写在前面 今天没事研究了下,将日志文件写入mysql数据库,因为新公司用的数据库也是mysql,项目中需要将日志信息写入数据库,没办法,就研究了下.在使用过程中遇到一个很蛋疼的问题.最后解决了,郁闷了半天.这里做一下记录,以免再犯. 之前写个这方面的文章,关于配置信息,可参考我的这篇文章:Log4Net日志记录两种方式 解决办法 问题就出在我直接将log4net写入数据库的配置文件log4net.config直接复制过来在项目中使用了,当然是修改了连接字符串,提供程序等与mysql相关的配置.配

日志记录类库log4net的使用总结

log4net是一个开源的日志记录类库,经过配置后可以自动抓取程序中的错误.异常信息,并写入磁盘,也可以在异常发生时执行其他指定的操作,比如:通知某人右键.写入数据库等.这里写个ASP.NET MVC4应用LogNet的Demo: 1.建立ASP.NET MVC4网站,在web.config中写入log4net的配置文件(就是添加两个节点) 1 <configSections> 2 <!-->需要添加第一个的节点<--> 3 <section name="