Log4net简介
项目开发中,记录项目日志是必须的,如果非要说日志的重要性(日志可看做,飞机的黑匣子,或者汽车的行车记录仪),根据等级进行记录,方便我们排查相关问题,以后项目运维中,也方便很多。基本上我们进入一家公司,开发你从事什么岗位,公司产品或项目的框架都已经搭建好,我们有时候进行改版,根据业务延伸框架,记录日志基本都是我们自己去调用封装的方法。今天我们就对Log4net进行一下学习,Log4net可以做到:1、邮箱发送日志;2、记录到数据库;3、生成记事本文件。本章Log4net学习,以为是后面,我会简单一个微服务框架做准备。今天我们主要对邮箱发送日志,生产记事本文件两种方式研究。后期有时间我们在研究保存到数据库。
Log4net配置
开发环境:VS2013 ,创建一个WebAPI 模拟项目场景去解析Log4Net
创建WebAPI步骤我们就做简述说明,下面框架目录,今天我们主要配置Log4net进行解析,所以只需要关注WebAPI 和WebAPICommon 就行,这里别忘记了三层之间的引用,WebAPI需要引用WebAPICommon 类库
第一步,WebAPI 和WebAPICommon 中用NuGet搜索Log4net添加:Log4net引用
第二部,我们在WebAPI添加一个Log4net.config配置文件,它主要放我们的日志配置信息
第三部,在新建的Log4net.config配置文件中,添加日志配置,这里我们做两部分讲解(文本格式,邮件发送),今天主要讲解文本格式,邮箱配置我们做单独做模块;
下面把ERROR 为例,每行配置的具体解析:::
<log4net> <!--错误日志:::记录错误日志--> <!--按日期分割日志文件 一天一个--> <!-- appender 定义日志输出方式 将日志以回滚文件的形式写到文件中。--> <appender name="ErrorAppender" type="log4net.Appender.RollingFileAppender"> <!--保存路径:下面路径项目启动的时候自动在C盘中创建log、logError文件--> <file value="C:\log\LogError\"/><!-- 如果想在本项目中添加路径,那就直接去掉C:\ 只设置log\LogError 项目启动中默认创建文件 --> <appendToFile value="true"/> <!--按照何种方式产生多个日志文件(日期[Date],文件大小[Size],混合[Composite])--> <rollingStyle value="Date"/> <!--这是按日期产生文件夹--> <datePattern value="yyyy\yyyyMM\yyyyMMdd'.txt'"/> <!--是否只写到一个文件中--> <staticLogFileName value="false"/> <!--保留的log文件数量 超过此数量后 自动删除之前的 好像只有在 按Size分割时有效 设定值value="-1"为不限文件数--> <param name="MaxSizeRollBackups" value="100"/> <!--每个文件的大小。只在混合方式与文件大小方式下使用。超出大小后在所有文件名后自动增加正整数重新命名,数字最大的最早写入。可用的单位:KB|MB|GB。不要使用小数,否则会一直写入当前日志--> <maximumFileSize value="1GB" /> <!-- layout 控制Appender的输出格式,也可以是xml 一个Appender只能是一个layout--> <layout type="log4net.Layout.PatternLayout"> <!--每条日志末尾的文字说明--> <!--输出格式 模板--> <!-- <param name="ConversionPattern" value="记录时间:%date 线程ID:[%thread] 日志级别:%-5level 记录类:%logger 操作者ID:%property{Operator} 操作类型:%property{Action}%n 当前机器名:%property%n当前机器名及登录用户:%username %n 记录位置:%location%n 消息描述:%property{Message}%n 异常:%exception%n 消息:%message%newline%n%n" />--> <!--样例:2008-03-26 13:42:32,111 [10] INFO Log4NetDemo.MainClass [(null)] - info--> <!--<conversionPattern value="%newline %n记录时间:%date %n线程ID:[%thread] %n日志级别: %-5level %n错误描述:%message%newline %n"/>--> <conversionPattern value="%n========== %n【日志级别】%-5level %n【记录时间】%date %n【线程编号】[%thread] %n【执行时间】[%r]毫秒 %n【出错文件】%F %n【出错行号】%L %n【出错的类】%logger 属性[%property{NDC}] %n【错误描述】%message %n【错误详情】%newline"/> </layout> </appender> <!--Error日志::: 错误日志--> <logger name="logerror"> <level value="ERROR" /> <appender-ref ref="ErrorAppender" /> </logger> </log4net>
第四部: 在WebAPICommon类库中添加LogHelper类,该类就是获取配置类的配置,传送错误信息,可以直接复用;
[assembly: log4net.Config.XmlConfigurator(ConfigFileExtension = "log4net", Watch = true)] namespace WebAPICommon {
//日志的公共帮助类 public class LogHelper { #region /// <summary> /// /// </summary> /// <param name="msg"></param> public static void ErrorLog(object msg) { log4net.ILog log = log4net.LogManager.GetLogger("logerror"); Task.Run(() => log.Error(msg)); //异步 // Task.Factory.StartNew(() =>log.Error(msg));// 这种异步也可以
//log.Error(msg); //这种也行跟你需要,性能越好,越强大,我还是使用异步方式
} /// <summary> /// /// </summary> /// <param name="ex"></param> public static void ErrorLog(Exception ex) { log4net.ILog log = log4net.LogManager.GetLogger("logerror"); Task.Run(() => log.Error(ex.Message.ToString() + "/r/n" + ex.Source.ToString() + "/r/n" + ex.TargetSite.ToString() + "/r/n" + ex.StackTrace.ToString())); } /// <summary> /// /// </summary> /// <param name="msg"></param> /// <param name="ex"></param> public static void ErrorLog(object msg, Exception ex) { log4net.ILog log = log4net.LogManager.GetLogger("logerror"); if (ex != null) { Task.Run(() => log.Error(msg, ex)); //异步 } else { Task.Run(() => log.Error(msg)); //异步 } } #endregion } }
查看后台代码你会发现,以Error为例有两个方法,两种方式传参数,我们上面的封装也是根据我们的业务需求,去扩展封装
方法解析重点::
LogManager类,它用来管理所有的Logger.它的GetLogger静态方法可以获取配置文件中的Logger
log4net.ILog log = log4net.LogManager.GetLogger("logerror");
//该方法也可以写公共的创建,然后直接使用
//static readonly log4net.ILog loginfo = log4net.LogManager.GetLogger("loginfo");
// static readonly log4net.ILog logerror = log4net.LogManager.GetLogger("logerror");
我们介绍一下 文章中有一句话
[assembly: log4net.Config.XmlConfigurator(ConfigFileExtension = "log4net", Watch = true)]我们来解读一下
首先我们先说一下 log4net.Config.XmlConifguratorAttribute
XmlConfiguratorAttribute有3个属性: ConfigFile: 配置文件的名字,文件路径相对于应用程序目录(AppDomain.CurrentDomain.BaseDirectory)。ConfigFile属性不能和ConfigFileExtension属性一起使用。 ConfigFileExtension: 配置文件的扩展名,文件路径相对于应用程序的目录。ConfigFileExtension属性不能和ConfigFile属性一起使用。 Watch: 如果将Watch属性设置为true,就会监视配置文件。当配置文件发生变化的时候,就会重新加载。 如果ConfigFile和ConfigFileExtension都没有设置,则使用应用程序的配置文件App.config(Web.config)。
可以在项目的AssemblyInfo.cs文件里添加以下的语句,根据配置业务项目中配置不同,可以直接复制粘贴:
//监视默认的配置文件,App.exe.config [assembly: log4net.Config.XmlConfigurator(Watch = true)] //监视配置文件,App.exe.log4net。 [assembly: log4net. Config.XmlConfigurator(ConfigFileExtension = "log4net", Watch = true)] //使用配置文件log4net.config,不监视改变。注意log4net.config文件的目录,BS程序在站点目录//下,CS则在应用程序启动目录下,如调试时在/bin/Debug下,一般将文件属性的文件输出目录调为//始终复制即可 [assembly: log4net. Config.XmlConfigurator(ConfigFile = "log4net.config")] //使用配置文件log4net.config,不监视改变 [assembly: log4net. Config.XmlConfigurator()]
第五部:我们才用的WebAPI测试,还需要启动项目日志
在WebAPI中找到:Global文件
Global.asax 文件是 ASP.NET 应用程序的中心点。它提供无数的事件来处理不同的应用程序级任务,比如用户身份验证、应用程序启动以及处理用户会话等。你应该熟悉这个可选文件,这样就可以构建出健壮的ASP.NET 应用程序。
protected void Application_Start() { AreaRegistration.RegisterAllAreas(); GlobalConfiguration.Configure(WebApiConfig.Register); FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters); RouteConfig.RegisterRoutes(RouteTable.Routes); BundleConfig.RegisterBundles(BundleTable.Bundles);
//启动项日志记录 //若不想把lognet配置文件写在web.config中,也可以另外手动指定。 log4net.Config.XmlConfigurator.ConfigureAndWatch(new FileInfo(Server.MapPath("/log4net.config"))); } /// <summary> /// 程序出错时通过lognet写日志 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> protected void Application_Error(Object sender, EventArgs e) { Exception objExp = HttpContext.Current.Server.GetLastError(); LogHelper.ErrorLog(" 客户机IP:" + Request.UserHostAddress + " 错误地址:" + Request.Url + " 异常信息:" + Server.GetLastError().Message, objExp); }
方法解析: Application_Error,该方法我个人建议添加,如果你的项目其中过程就报错,我们可以捕捉到异常信息。
最后一步:我们进行测试,在你需要的地方,引用WebAPICommon类库,
在你需要的地方加入 LogHelper.ErrorLog(object);
public bool Add(Department department) { try { return dep.Add(department); } catch (Exception ex) { LogHelper.ErrorLog(ex); //在你需要的地方 加入 LogHelper.ErrorLog(ex)
throw;
} }
查看结果:C盘默认创建我配置的文件,
按照:::年----月-----创建
文本记录显示:就是我们在配置文件中自行定义,