基于Common.Logging + Log4Net实现的日志管理
2024-10-02 04:29:15
前言
Common.Logging 是Commons-Logging(apache最早提供的日志门面接口,提供了简单的日志实现以及日志解耦功能) 项目的.net版本。其目的是为 "所有的.net日志实现"提供一个统一的接口,在系统的迭代过程中，可灵活的切换不同的日志实现组件(Log4Net、NLog、EntLib等)。
原理
Common.Logging.LogManager类 作为操作日志实例的主接口，提供了3个对外的方法来获取日志实例
上图所示的Adapter是日志实例工厂类，是从配置文件中获取并创建的
Web.config中的配置, factoryAdapter 节点类型为Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter，该类就是日志实例工厂类的实现。
如何集成至项目
Common.logging结合Log4Net如何集成至项目中实现日志管理？
选择安装的版本
查看Log4Net的官方版本发布记录发现，从1.2.11版本开始支持的.NET 3.5 和 .NET 4.0， 从2.0.6版本(17年5月)开始支持.NET Core 和 .NET Standard 1.3。那么我们选择的Log4Net版本，至少得是1.2.11版本。 而适配Common.Logging的Log4Net插件版本也有很多(主要是不同版本的Log4Net进行适配),我选择的是Common.Logging.Log4Net1211.
在项目中最好是使用Nuget安装包，会自动关联其Log4Net的版本
先安装 Common.Logging
Install-Package Common.Logging -Version 3.3.1
再安装Common.Logging.Log4Net1211
Install-Package Common.Logging.Log4Net1211 -Version 3.3.1
web.config的配置
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<configSections>
<sectionGroup name="common">
<section name="logging" type="Common.Logging.ConfigurationSectionHandler, Common.Logging" />
</sectionGroup>
</configSections>
<common>
<!--[DEBUG < INFO < WARN < ERROR < FATAL]-->
<logging>
<factoryAdapter type="Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter, Common.Logging.Log4Net1211">
<!--表示log4net的配置直接写在配置文件里-->
<!--<arg key="configType" value="INLINE"/>-->
<!--log4net使用独立的配置文件-->
<arg key="configType" value="FILE-WATCH" />
<arg key="configFile" value="~/XmlConfig/log4net.config" />
</factoryAdapter>
</logging>
</common>
</configuration>
log4net的配置
<?xml version="1.0" encoding="utf-8"?>
<log4net>
<appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender">
<!--目录路径，可以是相对路径或绝对路径-->
<file value="Log/" />
<!--日期的格式，每天换一个文件记录，如不设置则永远只记录一天的日志，需设置-->
<datePattern value='yyyy-MM-dd/"info.log"' />
<!--追加到文件-->
<appendToFile value="true" />
<!--创建日志文件的方式，可选值：Date[日期],文件大小[Size],混合[Composite]-->
<rollingStyle value="Composite" />
<!--写到一个文件-->
<staticLogFileName value="false" />
<!--单个文件大小。单位:KB|MB|GB-->
<maximumFileSize value="200MB" />
<!--最多保留的文件数，设为"-1"则不限-->
<maxSizeRollBackups value="-1" />
<!--日志格式-->
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%-5level %date [%-5.5thread] %-40.40logger - %message%newline" />
</layout>
</appender>
<appender name="TraceRollingFileAppender" type="log4net.Appender.RollingFileAppender">
<!--目录路径，可以是相对路径或绝对路径-->
<file value="Log/" />
<!--日期的格式，每天换一个文件记录，如不设置则永远只记录一天的日志，需设置-->
<datePattern value='yyyy-MM-dd/"trace.log"' />
<!--追加到文件-->
<appendToFile value="true" />
<!--创建日志文件的方式，可选值：Date[日期],文件大小[Size],混合[Composite]-->
<rollingStyle value="Composite" />
<!--写到一个文件-->
<staticLogFileName value="false" />
<!--单个文件大小。单位:KB|MB|GB-->
<maximumFileSize value="200MB" />
<!--最多保留的文件数，设为"-1"则不限-->
<maxSizeRollBackups value="-1" />
<!--日志格式-->
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%-5level %date [%-5.5thread] %-40.40logger - %message%newline" />
</layout>
</appender>
<appender name="WarnRollingFileAppender" type="log4net.Appender.RollingFileAppender">
<!--目录路径，可以是相对路径或绝对路径-->
<file value="Log/" />
<!--日期的格式，每天换一个文件记录，如不设置则永远只记录一天的日志，需设置-->
<datePattern value='yyyy-MM-dd/"warn.log"' />
<!--追加到文件-->
<appendToFile value="true" />
<!--创建日志文件的方式，可选值：Date[日期],文件大小[Size],混合[Composite]-->
<rollingStyle value="Composite" />
<!--写到一个文件-->
<staticLogFileName value="false" />
<!--单个文件大小。单位:KB|MB|GB-->
<maximumFileSize value="200MB" />
<!--最多保留的文件数，设为"-1"则不限-->
<maxSizeRollBackups value="-1" />
<!--日志格式-->
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%-5level %date [%-5.5thread] %-40.40logger - %message%newline" />
</layout>
</appender>
<appender name="ErrorRollingFileAppender" type="log4net.Appender.RollingFileAppender">
<!--目录路径，可以是相对路径或绝对路径-->
<file value="Log/" />
<!--日期的格式，每天换一个文件记录，如不设置则永远只记录一天的日志，需设置-->
<datePattern value='yyyy-MM-dd/"error.log"' />
<!--追加到文件-->
<appendToFile value="true" />
<!--创建日志文件的方式，可选值：Date[日期],文件大小[Size],混合[Composite]-->
<rollingStyle value="Composite" />
<!--写到一个文件-->
<staticLogFileName value="false" />
<!--单个文件大小。单位:KB|MB|GB-->
<maximumFileSize value="200MB" />
<!--最多保留的文件数，设为"-1"则不限-->
<maxSizeRollBackups value="-1" />
<!--日志格式-->
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%-5level %date [%-5.5thread] %-40.40logger - %message%newline" />
</layout>
</appender>
<root>
<appender-ref ref="RollingFileAppender" />
<!--控制级别，由低到高: ALL|DEBUG|INFO|WARN|ERROR|FATAL|OFF
比如定义级别为INFO，则INFO级别向下的级别，比如DEBUG日志将不会被记录
如果没有定义LEVEL的值，则缺省为DEBUG-->
<level value="INFO" />
</root>
<!--TraceLog 名称固定，写入调试跟踪日志-->
<logger name="TraceLog" additivity="false">
<appender-ref ref="TraceRollingFileAppender" />
<level value="INFO" />
</logger>
<!--Warnlog 名称固定，写入警告日志-->
<logger name="WarnLog" additivity="false">
<appender-ref ref="WarnRollingFileAppender" />
<level value="WARN" />
</logger>
<!--Errorlog 名称固定，写入异常错误日志-->
<logger name="ErrorLog" additivity="false">
<appender-ref ref="ErrorRollingFileAppender" />
<level value="ERROR" />
</logger>
</log4net>
更多参数配置说明，请移步Log4Net官网。
应用案例
在实际的项目中，我们还封装了LogHelper类用来获取定义好的日志实例(ErrorLog、WarnLog、TraceLog)，具体使用如下:
LogHelper.Trace("log222");
LogHelper.Warn("log222");
LogHelper.Error(new Exception('出错了'));
有关LogHelper的源代码，以及测试demo,我已整理放至github上https://github.com/yinboxie/BlogExampleDemo
参考
1、使用Common.Logging+log4net规范日志管理
2、Common.Logging源码解析
3、Log4net配置与使用简要说明
4、非常完善的Log4net详细说明
最新文章
- 二叉树学习笔记之B树、B+树、B*树
- 【设计模式六大原则6】开闭原则（Open Close Principle）
- Java栈实现
- oracle删除表的方法
- linux 开机自动挂载ntfs盘
- 数据库MySQL与xls文件的互导
- Fatal error: Allowed memory size of 8388608 bytes exhausted
- kobox: key_proc.c -v1 怎样使用proc文件系统调试驱动
- tp中phpexcel导出实例
- redis优化配置和redis.conf说明
- android 物理按键 监听
- ICC_lab总结——ICC_lab1：数据设置和基本流程
- d3js可视化策略
- SQL表变量和临时表
- 基数排序模板（基数排序，C++模板）
- 从零开始搭建一个从Win7环境备份至CentOS7的SVN双机备份环境
- textfield内边距
- dev-server.js浅析
- vRealize Automation的REST API Reference在哪里可以看到？
- vue v-if与v-show使用注意问题