log4net用法
介绍
官方网站:Apache Log4net
log4net(Log For Net)是Apache开源的应用于.Net框架的日志记录工具,详细信息参见Apache网站.它是针对Java的log4j(Log For Java的)姊妹工具.用过log4j的都知道,它功能强大,可配置性灵活,线程安全,对日志的输出管理和级别管理方便。使用log4net需要知道其中两个比较重要的概念:logger 和 appender。前者是日志记录对象,后者是日志记录的目标载体,包括控制台,文件,定量大小的文件,远程广播。log4net的工作原理简单地说是这样的:获得一个用来记录日志的工具对象logger,然后为logger对象指定日志的记录位置。值得一提的是这一切工作都可以在应用程序的配置文件中完成,所需代码量极少。
NuGet
配置
xml配置文件
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<!--Add Log4Net Section-->
<!--注册log4net部件-->
<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/>
</configSections>
<log4net>
<root>
<level value="DEBUG" />
<!--自定义日志输出类型-->
<appender-ref ref="DebugRollingFileAppender" />
<appender-ref ref="InfoRollingFileAppender" />
<appender-ref ref="WarnRollingFileAppender" />
</root>
<!--自定义日志输出格式-->
<appender name="DebugRollingFileAppender" type="log4net.Appender.RollingFileAppender" >
<!--输出路径-->
<file value="Logs/InfoPip/" />
<!--编码格式-->
<param name="Encoding" value="utf-8" />
<!--向文件中追加内容-->
<appendToFile value="true" />
<immediateFlush value="true" />
<!--配置以不同名称生成文件-->
<staticLogFileName value="false" />
<rollingStyle value="Date" />
<!--日志文件名-->
<datePattern value="yyyy-MM-dd".log"" />
<MaximumFileSize value="50MB"/>
<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
<!--日志格式-->
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%n==========
%n【记录时间】%date{yyyy-MM-dd HH:mm:ss}
%n【操作描述】%message"/>
</layout>
<filter type="log4net.Filter.LevelMatchFilter">
<levelToMatch value="DEBUG" />
</filter>
<filter type="log4net.Filter.DenyAllFilter" />
</appender>
<appender name="InfoRollingFileAppender" type="log4net.Appender.RollingFileAppender" >
<file value="Logs/InfoVedio/" />
<param name="Encoding" value="utf-8" />
<appendToFile value="true" />
<immediateFlush value="true" />
<staticLogFileName value="false" />
<rollingStyle value="Date" />
<datePattern value="yyyy-MM-dd".log"" />
<MaximumFileSize value="50MB"/>
<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%n==========
%n【记录时间】%date{yyyy-MM-dd HH:mm:ss}
%n【操作描述】%message"/>
</layout>
<filter type="log4net.Filter.LevelMatchFilter">
<levelToMatch value="INFO" />
</filter>
<filter type="log4net.Filter.DenyAllFilter" />
</appender>
<appender name="WarnRollingFileAppender" type="log4net.Appender.RollingFileAppender" >
<file value="Logs/InfoOther/" />
<param name="Encoding" value="utf-8" />
<appendToFile value="true" />
<immediateFlush value="true" />
<staticLogFileName value="false" />
<rollingStyle value="Date" />
<datePattern value="yyyy-MM-dd".log"" />
<MaximumFileSize value="50MB"/>
<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%n==========
%n【记录时间】%date{yyyy-MM-dd HH:mm:ss}
%n【操作描述】%message"/>
</layout>
<filter type="log4net.Filter.LevelMatchFilter">
<levelToMatch value="WARN" />
</filter>
<filter type="log4net.Filter.DenyAllFilter" />
</appender>
</log4net>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7.2" />
</startup>
</configuration>
程序集信息文件AssemblyInfo.cs配置
此文件如果没有设置,可能无法输出日志文件。文件位于项目的Properties下的AssemblyInfo.cs
***如果配置文件已单独文件log4net.config在程序中,需要放在bin路径下
[assembly: log4net.Config.XmlConfigurator(ConfigFile = "log4net.config",Watch = true)]
***如果配置文件在App.config下,程序集信息可忽略路径的配置
[assembly: log4net.Config.XmlConfigurator()]
LogHelper类
public static class LogHelper
{
static readonly ILog logger = LogManager.GetLogger("Logger");
/// <summary>
/// Info
/// </summary>
/// <param name="message"></param>
public static void Info(string message)
{
logger.Info(message);
}
/// <summary>
/// Debug
/// </summary>
/// <param name="message"></param>
public static void Debug(string message)
{
logger?.Debug(message);
}
/// <summary>
/// Warn
/// </summary>
/// <param name="message"></param>
public static void Warn(string message)
{
logger?.Warn(message);
}
}