Log4net 配置文件组成

2022-12-19,

Example:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<log4net>

<root>
<level value="ALL" />
<appender-ref ref="LogFileAppender" />
</root>

<logger name="testApp.Logging">
<level value="ALL"/>
</logger>

<appender name="LogFileAppender" type="log4net.Appender.FileAppender" >
<param name="File" value="log-file.txt" />
<param name="AppendToFile" value="true" />
<layout type="log4net.Layout.PatternLayout">
<param name="Header" value="[Header] "/>
<param name="Footer" value="[Footer] "/>
<param name="ConversionPattern" value="%d [%t] %-5p %c [%x] - %m%n" />
</layout>
<filter type="log4net.Filter.LevelRangeFilter">
<param name="LevelMin" value="DEBUG" />
<param name="LevelMax" value="WARN" />
</filter>
</appender>

</log4net>
</configuration>

1、Appenders——定义日志的输出方式,即日志要写到那种介质上去。

(1)常用的输出方式:type="log4net.Appender.FileAppender"

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

AnsiColorTerminalAppender 将日志高亮输出到ANSI终端。

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

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

ConsoleAppender 将日志输出到应用程序控制台。

EventLogAppender 将日志写到Windows Event Log。

FileAppender 将日志输出到文件。

ForwardingAppender 发送日志事件到子Appenders。

LocalSyslogAppender 将日志写到local syslog service (仅用于UNIX环境下)。

MemoryAppender 将日志存到内存缓冲区。

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

OutputDebugStringAppender 将日志输出到Debuger,如果程序没有Debuger,就输出到系统Debuger。如果系统Debuger也不可用,将忽略消息。

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

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

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

SmtpAppender 将日志写到邮件中。

SmtpPickupDirAppender 将消息以文件的方式放入一个目录中,像IIS SMTP agent这样的SMTP代理就可以阅读或发送它们。

TelnetAppender 客户端通过Telnet来接受日志事件。

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

UdpAppender 将日志以无连接UDP数据报的形式送到远程宿主或用UdpClient的形式广播。

(2)当然也可以自己写一个,需要从log4net.Appender.AppenderSkeleton类继承。

2、Filters——过滤掉Appender输出的内容(type="log4net.Filter.LevelRangeFilter")

DenyAllFilter 阻止所有的日志事件被记录

LevelMatchFilter 只有指定等级的日志事件才被记录

LevelRangeFilter 日志等级在指定范围内的事件才被记录

LoggerMatchFilter 与Logger名称匹配,才记录

PropertyFilter 消息匹配指定的属性值时才被记录

StringMathFilter 消息匹配指定的字符串才被记录

3、Layouts——控制Appender的输出格式

(1)一个Appender只能有一个Layout。

(2)常用格式:

PatterLayout 使用最多的一个Layout

SimpleLayout 简单输出格式,只输出日志级别与消息内容。

RawTimeStampLayout 用来格式化时间,在向数据库输出时会用到。样式如“yyyy-MM-dd HH:mm:ss“

ExceptionLayout 需要给Logger的方法传入Exception对象作为参数才起作用,否则就什么也不输出。输出的时候会包含Message和Trace。

(3)Layout可以自己实现,需要从log4net.Layout.LayoutSkeleton类继承

4、Logger——是直接和应用程序交互的组件。Logger只是产生日志,然后由它引用的Appender记录到指定的媒介,并由Layout控制输出格式。

(1)所有的Logger都从Root继承,Root本身也是一个Logger。

(2)日志的等级,它们由高到底分别为:OFF > FATAL > ERROR > WARN > INFO > DEBUG  > ALL

(3)log4net.ILog log = log4net.LogManager.GetLogger("logger-name");

5、Example

<!--测试-->
<!--一般信息:用来记录业务逻辑log-->
<logger name="TestLogging">
<level value="INFO"/>
<!--定义多个Appender,相当于同时记录到多个Appender-->
<appender-ref ref="TestAppender"/>
</logger>
<appender name="TestAppender" type="log4net.Appender.RollingFileAppender" >
<!--log文件路径-->
<param name="File" value="Log/Info/" />
<!--是否追加到文件-->
<param name="AppendToFile" value="true" />
<!--记录日志写入文件时,不锁定文本文件,防止多线程时不能写Log,官方说线程非安全-->
<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
<!--使用Unicode编码-->
<Encoding value="UTF-8" />
<!--最多产生的日志文件数,超过则只保留最新的n个。设定值value="-1"为不限文件数-->
<param name="MaxSizeRollBackups" value="10" />
<!--是否只写到一个文件中-->
<param name="StaticLogFileName" value="false" />
<!--按照何种方式产生多个日志文件(日期[Date],文件大小[Size],混合[Composite])-->
<param name="RollingStyle" value="Composite" />
<!--按日期产生文件夹和文件名[在日期方式与混合方式下使用]-->
<!--此处按日期产生文件夹,文件名固定。注意&quot; 的位置-->
<param name="DatePattern" value="yyyy-MM-dd/Tes/&quot;log.txt&quot;" />
<!--每个文件的大小。只在混合方式与文件大小方式下使用。超出大小后在所有文件名后自动增加正整数重新命名,数字最大的最早写入。可用的单位:KB|MB|GB。不要使用小数,否则会一直写入当前日志-->
<param name="maximumFileSize" value="1MB" />
<!--计数类型为1,2,3…-->
<param name="CountDirection" value="1"/>
<!--记录的格式。一般用log4net.Layout.PatternLayout布局-->
<layout type="log4net.Layout.PatternLayout">
<!--%d 日期 [%t] thread %-5p level %c logger %m message %n newline-->
<!--WARN 2018-08-22 10:06:12,142 [8] - Warn-->
<param name="ConversionPattern" value="%-5p %d [%t] - %m%n" />
</layout>
<!--过滤设置,LevelRangeFilter为使用的过滤器。-->
<filter type="log4net.Filter.LevelRangeFilter">
<param name="LevelMin" value="INFO" />
<param name="LevelMax" value="INFO" />
</filter>
</appender>

Log4net 配置文件组成的相关教程结束。

《Log4net 配置文件组成.doc》

下载本文的Word格式文档,以方便收藏与打印。