200字范文 > ASP.NET MVC 使用 Log4net 记录日志

ASP.NET MVC 使用 Log4net 记录日志

时间：2020-05-06 23:02:30

Log4net 介绍

Log4net 是 Apache 下一个开放源码的项目，它是Log4j 的一个克隆版。我们可以控制日志信息的输出目的地。Log4net中定义了多种日志信息输出模式。它可以根据需要将日志输出到控制台，文本文件，windows 日志事件查看器中，包括数据库，邮件等等位置，以便我们快速跟踪程序bug。

Log4net 提供 7个日志等级，从高到底分别为：OFF > FATAL > ERROR > WARN > INFO > DEBUG > ALL

Log4net 有 3个主要的成员， loggers ，appenders 和 layouts 。

Logger 介绍

Logger是负责日志的记录者，假设我们需要记录一些正常的运行时日志和出现异常时的错误日志，那么我们可以通过在配置文件当中添加两个Logger实现。Logger主要用于记录日志的分类和控制日志的级别。它可以以多种格式输出日志信息，同时它也可以控制日志的输出级别。 log4net使用继承体系，也就是说假如存在两个Logger，名字分别为a.b.c和a.b。那么a.b就是a.b.c的祖先。每个Logger都继承了它祖先的属性 Appender 介绍

提供日志记录的输出源，我们可以将日志输出到控制台，文本文件， windows 日志事件查看器中（在Window日志>应用程序中查看），数据库，邮件等。这些输出源都是通过 Appender 来配置实现。

不建议将日志文件保存到数据库中，因为使用 sql 去排查日志还是比较困难的，最好是将日志文件保存的日志管理服务或Elasticsearch，该服务可以提供良好的全文索引以及其他功能。Layout 介绍

Layout 用于控制 Appender 的输出格式。

Layout 中 PatternLayout 约定的字符串转换解释

%m、%message 输出的日志消息%d、%datetime 输出当前语句运行的时刻，格式%date{yyyy-MM-dd HH:mm:ss,fff}%r、%timestamp 输出程序从运行到执行到当前语句时消耗的毫秒数%p、%level 日志的当前优先级别%c、%logger当前日志对象的名称%L、%line 输出语句所在的行号%F、%file 输出语句所在的文件名，警告：只在调试的时候有效，调用本地信息会影响性能%a、%appdomain 引发日志事件的应用程序域的名称。%C、%class、%type 引发日志请求的类的全名，警告：会影响性能%exception 异常信息%u、%identity 当前活动用户的名字，我测试的时候%identity返回都是空的。警告：会影响性能%l、%location 引发日志事件的名空间、类名、方法、行号。警告：会影响性能，依赖pdb文件%M、%method发生日志请求的方法名，警告：会影响性能%n、%newline 换行符%x、%ndc NDC(nested diagnostic context)%X、%mdc、%P、%properties 等介于 %property%property 输出{log4net:Identity=, log4net:UserName=, log4net:HostName=} %t、%thread 引发日志事件的线程，如果没有线程名就使用线程号。%w、%username 当前用户的WindowsIdentity,类似：HostName/Username。警告：会影响性能%utcdate 发生日志事件的UTC时间。例如：%utcdate{HH:mm:ss,fff}%% 输出一个百分号

更多内容请参考：/log4net/release/sdk/html/T_log4net_Layout_PatternLayout.htm

如何使用

以 MVC 项目为例

1.使用 Nuget 安装 log4net ，

PM> Install-Package log4net

2.创建 log4net.config 配置文件，并且将该文件的属性“复制到输出目录”修改为 “始终复制”

<?xml version="1.0" encoding="utf-8" ?><configuration><configSections><section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net-net-2.0"/></configSections><log4net><root><level value="ALL" /><appender-ref ref="LogFileAppender" /></root><appender name ="LogFileAppender" type="log4net.Appender.RollingFileAppender"><param name="File" value ="App_Data\"/><param name="AppendToFile" value="true" /><param name="MaxSizeRollBackups" value="100" /><param name="MaxFileSize" value="10240" /><param name="StaticLogFileName" value="false" /><param name="DatePattern" value="yyyy.MM.dd'.txt'" /><param name="RollingStyle" value ="Date" /><lockingModel type="log4net.Appender.FileAppender+MinimalLock" /><layout type="log4net.Layout.PatternLayout"><param name="ConversionPattern" value="%date 线程ID:[%thread] 日志级别:[%-5level] : [%message]%newline"/></layout><filter type="log4net.Filter.LevelRangeFilter"><param name="LevelMin" value="DEBUG" /><param name="LevelMax" value="FATAL" /></filter></appender><appender name="EventLogAppender" type="log4net.Appender.EventLogAppender"><layout type="log4net.Layout.PatternLayout"><conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline"></conversionPattern></layout></appender></log4net></configuration>

3.创建 LogHelper 类，提供日志记录的方法

public class LogHelper{private ILog _log4Net = null;private const string DEFAULT_LOGGER_NAME = "Logger";/// <summary>/// Prevents a default instance of the <see cref="LogWriter"/> class from being created./// </summary>/// <param name="log4NetInstance">The log4net instance to be used.</param>private LogHelper(ILog log4NetInstance){_log4Net = log4NetInstance;}/// <summary>/// Gets a logger with the specified configuration name./// </summary>/// <param name="configName">Name of the logger in the configuration.</param>/// <returns>The logger obtained.</returns>/// <exception cref="System.Configuration.ConfigurationException">Thrown when no logger with the specified configuration name was found.</exception>public static LogHelper GetLogger(string configName){var logger = LogManager.GetLogger(configName);if (logger == null){throw new ArgumentException(string.Format("No logger configuration named '{0}' was found in the configuration.", configName), "configName");}return new LogHelper(logger);}/// <summary>/// Gets the default./// </summary>public static LogHelper Default{get{return GetLogger(DEFAULT_LOGGER_NAME);}}/// <summary>/// Writes an information level logging message./// </summary>/// <param name="message">The message to be written.</param>public void WriteInfo(object message){_log4Net.Info(message);}/// <summary>/// Writes a warning level logging message./// </summary>/// <param name="message">The message to be written.</param>public void WriteWarning(object message){_log4Net.Warn(message);}/// <summary>/// Writes a warning level logging message./// </summary>/// <param name="message">The message to be written.</param>/// <param name="exception">The exception.</param>public void WriteWarning(object message, System.Exception exception){_log4Net.Warn(message, exception);}/// <summary>/// Writes the error./// </summary>/// <param name="message">The message to be written.</param>public void WriteError(object message){_log4Net.Error(message);}/// <summary>/// Writes the error level logging message../// </summary>/// <param name="message">The message to be written.</param>/// <param name="exception">The exception.</param>public void WriteError(object message, System.Exception exception){_log4Net.Error(message, exception);}/// <summary>/// Writes the fatal error level logging message../// </summary>/// <param name="message">The message to be written.</param>public void WriteFatal(object message){_log4Net.Fatal(message);}/// <summary>/// Writes the fatal error level logging message../// </summary>/// <param name="message">The message to be written.</param>/// <param name="exception">The exception.</param>public void WriteFatal(object message, System.Exception exception){_log4Net.Fatal(message, exception);}public void DeleteLog(){string logDirPath = bine(Path.GetDirectoryName(System.Reflection.Assembly.GetExecutingAssembly().Location), "Log");if (!Directory.Exists(logDirPath)) return;int days = 30;foreach (string filePath in Directory.GetFiles(logDirPath)){DateTime dt;DateTime.TryParse(Path.GetFileNameWithoutExtension(filePath).Replace(@"Log\", "").Replace(".", "-"), out dt);if (dt.AddDays(days).CompareTo(DateTime.Now) < 0){File.Delete(filePath);}}}}

View Code

4. 在Global.asax 文件 Application_Start 方法中加载你的 log4net.config 文件，并调用 LogHelper类测试记录日志。

log4net.Config.XmlConfigurator.Configure(new FileInfo(Server.MapPath("~/log4net.config")));

LogHelper.Default.WriteInfo("AppStart");LogHelper.Default.WriteWarning("Warning");LogHelper.Default.WriteError("Error");LogHelper.Default.WriteFatal("Fatal");try{int a = 3 / 4;int r = 4 / a;}catch (Exception ex){LogHelper.Default.WriteError(ex.Message, ex);}

5. 日志效果图