Log4Net配置详解及输出自定义消息类示例

安河桥

1.简单使用实例

1.1 添加log4net.dll的引用。

  在NuGet程序包中搜索log4net并添加，此次我所用版本为2.0.17。如下图：

1.2 添加配置文件

  右键项目，添加新建项，搜索选择应用程序配置文件，命名为log4net.config，步骤如下图：

1.2.1 log4net.config简单配置示例

  下面是一个简单的配置示例，详细节点及相应的说明详见 2. 配置文件节点详解 。
点击查看log4net.config配置

1. <?xml version="1.0" encoding="utf-8" ?>
2. <configuration>
3. <log4net>
4.         <logger name="DefaultLog">
5.                
6.                
7.                 <level value="ALL" />
8.                 <appender-ref ref="FileAppenderDefault"></appender-ref>
9.         </logger>
10.        
11.        
12.         <appender name="FileAppenderDefault" type="log4net.Appender.RollingFileAppender">
13.                
14.                
15.                
16.                 <file value="../../Log/DefalutLog" />
17.                
18.                
19.                
20.                
21.                
22.                 <lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
23.                
24.                 <appendToFile value="true" />
25.                
26.                
27.                 <rollingStyle value="Composite" />
28.                
29.                
30.                
31.                
32.                 <maxSizeRollBackups value="10" />
33.                
34.                
35.                
36.                 <datePattern value="_yyyy-MM-dd'.log'" />
37.                
38.                 <maximumFileSize value="10MB" />
39.                
40.                 <staticLogFileName value="false" />
41.                
42.                
43.                
44.                 <filter type="log4net.Filter.LevelMatchFilter">
45.                         <param name="LevelToMatch" value="WARN" />
46.                 </filter>
47.                 <filter type="log4net.Filter.DenyAllFilter" />
48.                 <layout type="log4net.Layout.PatternLayout">
49.                         <conversionPattern value="%n＝＝＝＝＝＝＝＝＝＝
50.                         %n【日志级别】%-5level
51.                         %n【记录时间】%date
52.                         %n【执行时间】[%r]毫秒
53.                         %n【执行Log分类的名称】%logger
54.                         %n【传入信息内容】%message
55.                         %n＝＝＝＝＝＝＝＝＝＝"/>
56.                 </layout>
57.         </appender>
58. </log4net>
59. </configuration>

复制代码

1.2.2 设置log4net.config配置文件属性

  点击log4net.config，将其文件属性设为始终复制，如下图：

1.3 在项目中引入该配置文件

  这里有两种方式引入配置文件。
1.3.1 在项目的 AssemblyInfo.cs 中引入配置文件

  首先在项目中新建一个Config文件夹，将之前创建的log4net.config文件放入其中，随后在 AssemblyInfo.cs 中添加如下语句：

1.3.2 在项目运行时动态引入配置文件

  使用固定语句引入配置文件，如下所示，其中，configFilePath 为配置文件的绝对路径。

1. log4net.Config.XmlConfigurator.ConfigureAndWatch(new System.IO.FileInfo(configFilePath));

复制代码

1.4 创建帮助类使用日志进行记录

  我们首先创建名为 Log4Helper 的类，并使用固定的log4net.LogManager.GetLogger()语句实例化对应的Log对象，然后调用其对应的方法即可写入日志。示例代码如下：
点击查看Log4Helper代码

1. public class Log4Helper
2. {
3.      private static readonly log4net.ILog logDefault = log4net.LogManager.GetLogger("DefaultLog");
5.      /// <summary>
6.      /// 测试默认配置信息输出（输出范围做了限制）
7.      /// </summary>
8.      public static void TestDefaultLog()
9.      {
10.          logDefault.Debug("这是条调试信息");
11.          logDefault.Info("这是条提示信息");
12.          logDefault.Warn("这是条警告信息");
13.          logDefault.Error("这是条错误信息");
14.          logDefault.Fatal("这是条致命错误信息");
15.      }
17.      /// <summary>
18.      /// Log4Net初始化（可读取自定义配置）
19.      /// </summary>
20.      /// <param name="configFilePath"></param>
21.      public static void Log4NetInit(string configFilePath)
22.      {
23.          log4net.Config.XmlConfigurator.ConfigureAndWatch(new System.IO.FileInfo(configFilePath));
24.      }
25.      /// <summary>
26.      /// 返回指定名称的日志对象
27.      /// </summary>
28.      public static log4net.ILog Log(string appenderName)
29.      {
30.          return log4net.LogManager.GetLogger(appenderName);
31.      }
32. }

复制代码

1.5 在主程序中引用

  最后一步就是在主程序中引用 Log4Helper 中的日志记录方法，如下所示：

1. private void Application_Startup(object sender, StartupEventArgs e)
2. {
3.      Log4Helper.TestDefaultLog();
4. }

复制代码

  根据上面 log4net.config 配置中 file 节点中的地址，在项目中会生成 Log 文件夹，该文件夹下会生成类似 DefalutLog_2024-07-01.log 的文件。该文件名由 file 节点和 datePattern 节点两部分组合而成，其中，staticLogFileName节点需要被设置为 false ，若为 true ，则当前最新日志文件名永远为 file 节点中的名字，其余日志会根据 datePattern 节点自动添加后缀。
  打开日志文件，会发现里面只有 WARN 警告信息，例如：

1. ＝＝＝＝＝＝＝＝＝＝                     
2. 【日志级别】WARN                     
3. 【记录时间】2024-07-01 00:18:28,828                     
4. 【执行时间】[53]毫秒                     
5. 【执行Log分类的名称】DefaultLog              
6. 【传入信息内容】这是条警告信息            
7. ＝＝＝＝＝＝＝＝＝＝

复制代码

  这是因为配置中的 filter 过滤节点，详见注释，将其注释再次运行，则会正常显示全部日志信息。
2. 配置文件节点详解

  log4net的主要组成有四部分，分别是 Logger、Appender、Layout、Filter等，详见下方。
2.1 Logger 节点配置详解

  以上文的配置为例解释：

1. <logger name="DefaultLog">
2.        
3.        
4.         <level value="ALL" />
5.         <appender-ref ref="FileAppenderDefault"></appender-ref>
6. </logger>

复制代码

  level 定义记录的日志级别,就是说,你要记录哪个级别以上的日志,级别由低到高依次是:
ALL|DEBUG|INFO|WARN|ERROR|FATAL|OFF
  如果你 level 定义 INFO，那么低于 INFO 级别以下的信息，将不会记入日志，啥意思呢？
  就是说，就算你在程序里，用 log.Debug() 来写入一个日志信息，可是你在配置中指定 level 为 INFO，由于 DEBUG 级别低于 INFO，所以，不会被记入日志。这样的处理非常灵活。
  在具体写日志时，一般可以这样理解日志等级：

1. FATAL（致命错误）：记录系统中出现的能使用系统完全失去功能，服务停止，系统崩溃等使系统无法继续运行下去的错误。例如，数据库无法连接，系统出现死循环。
3. ERROR（一般错误）：记录系统中出现的导致系统不稳定，部分功能出现混乱或部分功能失效一类的错误。例如，数据字段为空，数据操作不可完成，操作出现异常等。
5. WARN（警告）：记录系统中不影响系统继续运行，但不符合系统运行正常条件，有可能引起系统错误的信息。例如，记录内容为空，数据内容不正确等。
7. INFO（一般信息）：记录系统运行中应该让用户知道的基本信息。例如，服务开始运行，功能已经开户等。
9. DEBUG （调试信息）：记录系统用于调试的一切信息，内容或者是一些关键数据内容的输出。

复制代码

  appender-ref，要引用的 appender 的名字，由 Layout 控制输出格式。
  最后还要说一个LogManager类，它用来管理所有的Logger。它的GetLogger静态方法，可以获得配置文件中相应的Logger：
log4net.ILog log = log4net.LogManager.GetLogger("logger-name");
2.2 Appender 节点配置详解

  以上文的 FileAppenderDefault 节点为例：
点击查看 FileAppenderDefault 节点配置

1. <logger name="DefaultLog">
2.        
3.        
4.         <level value="ALL" />
5.         <appender-ref ref="FileAppenderDefault"></appender-ref>
6. </logger><logger name="DefaultLog">
7.        
8.        
9.         <level value="ALL" />
10.         <appender-ref ref="FileAppenderDefault"></appender-ref>
11. </logger><logger name="DefaultLog">
12.        
13.        
14.         <level value="ALL" />
15.         <appender-ref ref="FileAppenderDefault"></appender-ref>
16. </logger><logger name="DefaultLog">
17.        
18.        
19.         <level value="ALL" />
20.         <appender-ref ref="FileAppenderDefault"></appender-ref>
21. </logger><logger name="DefaultLog">
22.        
23.        
24.         <level value="ALL" />
25.         <appender-ref ref="FileAppenderDefault"></appender-ref>
26. </logger><logger name="DefaultLog">
27.        
28.        
29.         <level value="ALL" />
30.         <appender-ref ref="FileAppenderDefault"></appender-ref>
31. </logger><logger name="DefaultLog">
32.        
33.        
34.         <level value="ALL" />
35.         <appender-ref ref="FileAppenderDefault"></appender-ref>
36. </logger><logger name="DefaultLog">
37.        
38.        
39.         <level value="ALL" />
40.         <appender-ref ref="FileAppenderDefault"></appender-ref>
41. </logger><logger name="DefaultLog">
42.        
43.        
44.         <level value="ALL" />
45.         <appender-ref ref="FileAppenderDefault"></appender-ref>
46. </logger><logger name="DefaultLog">
47.        
48.        
49.         <level value="ALL" />
50.         <appender-ref ref="FileAppenderDefault"></appender-ref>
51. </logger><logger name="DefaultLog">
52.        
53.        
54.         <level value="ALL" />
55.         <appender-ref ref="FileAppenderDefault"></appender-ref>
56. </logger><logger name="DefaultLog">
57.        
58.        
59.         <level value="ALL" />
60.         <appender-ref ref="FileAppenderDefault"></appender-ref>
61. </logger><logger name="DefaultLog">
62.        
63.        
64.         <level value="ALL" />
65.         <appender-ref ref="FileAppenderDefault"></appender-ref>
66. </logger><logger name="DefaultLog">
67.        
68.        
69.         <level value="ALL" />
70.         <appender-ref ref="FileAppenderDefault"></appender-ref>
71. </logger><logger name="DefaultLog">
72.        
73.        
74.         <level value="ALL" />
75.         <appender-ref ref="FileAppenderDefault"></appender-ref>
76. </logger><logger name="DefaultLog">
77.        
78.        
79.         <level value="ALL" />
80.         <appender-ref ref="FileAppenderDefault"></appender-ref>
81. </logger><logger name="DefaultLog">
82.        
83.        
84.         <level value="ALL" />
85.         <appender-ref ref="FileAppenderDefault"></appender-ref>
86. </logger><logger name="DefaultLog">
87.        
88.        
89.         <level value="ALL" />
90.         <appender-ref ref="FileAppenderDefault"></appender-ref>
91. </logger><logger name="DefaultLog">
92.        
93.        
94.         <level value="ALL" />
95.         <appender-ref ref="FileAppenderDefault"></appender-ref>
96. </logger><logger name="DefaultLog">
97.        
98.        
99.         <level value="ALL" />
100.         <appender-ref ref="FileAppenderDefault"></appender-ref>
101. </logger>       

复制代码

  每个节点均写有注释，这里额外介绍下 appender 的输出方式( type 属性)，如下所示：
点击查看 appender 输出方式

1.         AdoNetAppender              将日志记录到数据库中。可以采用SQL和存储过程两种方式。
2.         AnsiColorTerminalAppender   将日志高亮输出到ANSI终端。
3.         AspNetTraceAppender         能用asp.net中Trace的方式查看记录的日志。
4.         BufferingForwardingAppender 在输出到子Appenders之前先缓存日志事件。
5.         ConsoleAppender             将日志输出到应用程序控制台。
6.         EventLogAppender            将日志写到Windows Event Log。
7.         FileAppender                将日志输出到文件。
8.         ForwardingAppender          发送日志事件到子Appenders。
9.         LocalSyslogAppender         将日志写到local syslog service (仅用于UNIX环境下)。
10.         MemoryAppender              将日志存到内存缓冲区。
11.         NetSendAppender             将日志输出到Windows Messenger service.这些日志信息将在用户终端的对话框中显示。
12.         OutputDebugStringAppender   将日志输出到Debuger，如果程序没有Debuger，就输出到系统Debuger。如果系统Debuger也不可用，将忽略消息。
13.         RemoteSyslogAppender        通过UDP网络协议将日志写到Remote syslog service。
14.         RemotingAppender            通过.NET Remoting将日志写到远程接收端。
15.         RollingFileAppender         将日志以回滚文件的形式写到文件中。
16.         SmtpAppender                将日志写到邮件中。
17.         SmtpPickupDirAppender       将消息以文件的方式放入一个目录中，像IIS SMTP agent这样的SMTP代理就可以阅读或发送它们。
18.         TelnetAppender              客户端通过Telnet来接受日志事件。
19.         TraceAppender               将日志写到.NET trace 系统。
20.         UdpAppender                 将日志以无连接UDP数据报的形式送到远程宿主或用UdpClient的形式广播。

复制代码

2.3 Filter 节点配置详解

  filter只能作为 appender 的子元素，type 属性表示 Filter 的类型。常用子元素 param 数量0个或多个，作用设置一些参数。具体例子详见上文 2.2 Appender 节点配置详解 。
  额外补充下 filter 的类型说明:

1.         DenyAllFilter       阻止所有的日志事件被记录
2.         LevelMatchFilter    只有指定等级的日志事件才被记录
3.         LevelRangeFilter    日志等级在指定范围内的事件才被记录
4.         LoggerMatchFilter   Logger名称匹配，才记录
5.         PropertyFilter      消息匹配指定的属性值时才被记录
6.         StringMathFilter    消息匹配指定的字符串才被记录

复制代码

2.4 Layout 节点配置详解

  layout 节点只能作为 appender 的子元素。type 属性表示 Layout 的类型。具体例子详见上文 2.2 Appender 节点配置详解 。
  额外补充 layout 节点的 type 属性取值：

1.         ExceptionLayout         只呈现日志事件中异常的文本信息
2.         PatternLayout           可以通过类型字符串来配置的布局
3.         RawPropertyLayout       从日志事件中提取属性值
4.         RawTimeStampLayout      从日志事件中提取日期
5.         RawUtcTimeStampLayout   从日志事件中提取UTC日期
6.         SimpleLayout            很简单的布局
7.         XmlLayout               把日志事件格式化为XML元素的布局

复制代码

  这其中我们主要使用的还是PatternLayout 类型，而在 ConversionPattern 节点中，我们可以进一步的配置日志输出格式，以 PatterLayout 的格式化字符串输出为例：
点击查看 PatterLayout 的格式化字符串

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

复制代码

  额外补充下 PatterLayout 格式修饰符：
格式修饰符对齐最小宽最大宽说明%20logger右对齐20无如果logger名不足20个字符，就在左边补空格%-20logger左对齐20无如果logger名不足20个字符，就在右边补空格%.30logger左对齐无30超过30个字符将截断%20.30logger右对齐2030logger名要在20到30之间，少了在左边补空格，多了截断%-20.30logger左对齐2030logger名要在20到30之间，少了在右边补空格，多了截断3. 如何输出自定义类

  自定义扩展输出，通过继承 log4net.Layout.PatternLayout 和 log4net.Layout.Pattern.PatternLayoutConverter 类，使用 log4net.Core.LoggingEvent 类的方法得到了要输出的 LogEntity 类的名称。
  然后通过反射得到各个属性的值，使用 PatternLayout 类 AddConverter 方法传入得到的值，在 PatternLayoutConverter 中对其进行处理。注意配置文件 Appender 中的 Layout type 用到的类的命名空间以及类名，要同步更改为自定义类的。详见示例：
点击查看自定义拓展类的代码

1. namespace WPFPractice
2. {
3.     public class CustomLayout : log4net.Layout.PatternLayout
4.     {
5.         public CustomLayout()
6.         {
7.             this.AddConverter("Custom", typeof(CustomConvert));
8.         }
9.     }
10.     public class CustomConvert : log4net.Layout.Pattern.PatternLayoutConverter
11.     {
12.         protected override void Convert(System.IO.TextWriter writer, log4net.Core.LoggingEvent loggingEvent)
13.         {
14.             if (!string.IsNullOrEmpty(Option))
15.             {
16.                 object obj = loggingEvent.MessageObject;
17.                 if (obj != null)
18.                 {
19.                     PropertyInfo info = obj.GetType().GetProperty(Option);
20.                     if (info != null)
21.                     {
22.                         object cusMsg = info.GetValue(obj, null);
23.                         writer.Write(cusMsg);
24.                     }
25.                 }
26.             }
27.         }
28.     }
29. }

复制代码

  与之对应的，我们的配置文件也添加以下代码：
点击查看配置文件新增代码

1. <logger name="DefaultLog">
2.        
3.        
4.         <level value="ALL" />
5.         <appender-ref ref="FileAppenderDefault"></appender-ref>
6. </logger><logger name="DefaultLog">
7.        
8.        
9.         <level value="ALL" />
10.         <appender-ref ref="FileAppenderDefault"></appender-ref>
11. </logger><logger name="DefaultLog">
12.        
13.        
14.         <level value="ALL" />
15.         <appender-ref ref="FileAppenderDefault"></appender-ref>
16. </logger><logger name="DefaultLog">
17.        
18.        
19.         <level value="ALL" />
20.         <appender-ref ref="FileAppenderDefault"></appender-ref>
21. </logger><logger name="DefaultLog">
22.        
23.        
24.         <level value="ALL" />
25.         <appender-ref ref="FileAppenderDefault"></appender-ref>
26. </logger><logger name="DefaultLog">
27.        
28.        
29.         <level value="ALL" />
30.         <appender-ref ref="FileAppenderDefault"></appender-ref>
31. </logger><logger name="DefaultLog">
32.        
33.        
34.         <level value="ALL" />
35.         <appender-ref ref="FileAppenderDefault"></appender-ref>
36. </logger><logger name="DefaultLog">
37.        
38.        
39.         <level value="ALL" />
40.         <appender-ref ref="FileAppenderDefault"></appender-ref>
41. </logger><logger name="DefaultLog">
42.        
43.        
44.         <level value="ALL" />
45.         <appender-ref ref="FileAppenderDefault"></appender-ref>
46. </logger>

复制代码

  接下来我们新建一个类 LabwareModel，并在帮助类 Log4Helper 中添加调用 CustomLog 的方法，来测试能否输出自定义类 LabwareModel 中的内容。
点击查看自定义类 LabwareModel

1. public class LabwareModel
2. {
3.     public string LabTypeName { get; set; } = "采样管";
4.     public string LabName { get; set; } = "Custom_2000ul";
5.     public double LabNumber { get; set; } = 200;
6.     public int IsTip { get; set; } = 1;
7. }

复制代码

  帮助类 Log4Helper 如下：
点击查看帮助类 Log4Helper

1. private static readonly log4net.ILog logDefault = log4net.LogManager.GetLogger("DefaultLog");
3. /// <summary>
4. /// 生成默认实例
5. /// </summary>
6. /// <returns></returns>
7. public static LabwareModel GetLabwareModel()
8. {
9.      LabwareModel labwareModel = new LabwareModel();
10.      return labwareModel;
11. }
13. /// <summary>
14. /// 测试自定义配置信息输出
15. /// </summary>
16. public static void TestCustomLog()
17. {
18.      var labware = GetLabwareModel();
19.      logCustom.Debug("这是条调试信息");
20.      logCustom.Info("这是条提示信息");
21.      logCustom.Warn("这是条警告信息");
22.      logCustom.Error(labware);
23.      logCustom.Fatal("这是条致命错误信息");
24. }

复制代码

  在主程序中调用进行测试：

1. private void Application_Startup(object sender, StartupEventArgs e)
2. {
3.     Log4Helper.TestCustomLog();
4.     Log4Helper.TestDefaultLog();
5. }

复制代码

  根据上面 FileAppenderCustom 配置中 file 节点中的地址，在项目中会生成 Log 文件夹，该文件夹下会生成类似 CustomLog_2024-07-01.log 的文件。打开文件会看到输出内容如下：
点击查看日志输出内容

1. ＝＝＝＝＝＝＝＝＝＝           
2. 【日志级别】DEBUG                  
3. 【记录时间】2024-07-01 00:18:28,812                  
4. 【执行时间】[37]毫秒           
5. 【执行线程ID】[1]           
6. 【执行Log分类的名称】CustomLog           
7. 【耗材类型名】           
8. 【耗材名】           
9. 【耗材编号】           
10. 【是否吸头】           
11. 【传入信息内容/类型】这是条调试信息           
12. ＝＝＝＝＝＝＝＝＝＝
13. ＝＝＝＝＝＝＝＝＝＝           
14. 【日志级别】INFO                  
15. 【记录时间】2024-07-01 00:18:28,823                  
16. 【执行时间】[48]毫秒           
17. 【执行线程ID】[1]           
18. 【执行Log分类的名称】CustomLog           
19. 【耗材类型名】           
20. 【耗材名】           
21. 【耗材编号】           
22. 【是否吸头】           
23. 【传入信息内容/类型】这是条提示信息           
24. ＝＝＝＝＝＝＝＝＝＝
25. ＝＝＝＝＝＝＝＝＝＝           
26. 【日志级别】WARN                  
27. 【记录时间】2024-07-01 00:18:28,825                  
28. 【执行时间】[50]毫秒           
29. 【执行线程ID】[1]           
30. 【执行Log分类的名称】CustomLog           
31. 【耗材类型名】           
32. 【耗材名】           
33. 【耗材编号】           
34. 【是否吸头】           
35. 【传入信息内容/类型】这是条警告信息           
36. ＝＝＝＝＝＝＝＝＝＝
37. ＝＝＝＝＝＝＝＝＝＝           
38. 【日志级别】ERROR                  
39. 【记录时间】2024-07-01 00:18:28,826                  
40. 【执行时间】[51]毫秒           
41. 【执行线程ID】[1]           
42. 【执行Log分类的名称】CustomLog           
43. 【耗材类型名】采样管           
44. 【耗材名】Custom_2000ul           
45. 【耗材编号】200           
46. 【是否吸头】1           
47. 【传入信息内容/类型】WPFPractice.LabwareModel           
48. ＝＝＝＝＝＝＝＝＝＝
49. ＝＝＝＝＝＝＝＝＝＝           
50. 【日志级别】FATAL                  
51. 【记录时间】2024-07-01 00:18:28,828                  
52. 【执行时间】[53]毫秒           
53. 【执行线程ID】[1]           
54. 【执行Log分类的名称】CustomLog           
55. 【耗材类型名】           
56. 【耗材名】           
57. 【耗材编号】           
58. 【是否吸头】           
59. 【传入信息内容/类型】这是条致命错误信息           
60. ＝＝＝＝＝＝＝＝＝＝

复制代码

  以上就是关于 Log4Net 配置详解。

来源:https://www.cnblogs.com/letmebaby/p/18278934
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！