【.Net5】002Log4net

---

Log4Net介绍

log4net是一个可以帮助程序员把日志信息输出到各种 不同目标(控制台、文件、数据库等)，它可以容易的加载到开发项目中,实现程序调试和运行的时候的日志信息输出,提供了比.net自己提供的debug类和trace 类的功能更多。log4net是从java下有卓越表现的log4j移植过来的。它是apache基金资助的项目的一部分。

截至2020年4月1日，Log4Net是Apache Logging Services的一个休眠项目。休眠状态表示该项目被归类为非活动状态

日志记录器（Logger）的行为是分等级的，一般可分为5种日志等级(Level)，优先级从高到低：

1、FATAL（致命错误）：记录系统中出现的能使用系统完全失去功能，服务停止，系统崩溃等使系统无法继续运行下去的错误。例如，数据库无法连接，系统出现死循环。

2、ERROR（一般错误）：记录系统中出现的导致系统不稳定，部分功能出现混乱或部分功能失效一类的错误。例如，数据字段为空，数据操作不可完成，操作出现异常等。

3、WARN（警告）：记录系统中不影响系统继续运行，但不符合系统运行正常条件，有可能引起系统错误的信息。例如，记录内容为空，数据内容不正确等。

4、INFO（一般信息）：记录系统运行中应该让用户知道的基本信息。例如，服务开始运行，功能已经开户等。

5、DEBUG （调试信息）：记录系统用于调试的一切信息，内容或者是一些关键数据内容的输出。

我们可以控制到应用程序中相应级别的日志信息的开关。比如在定义了INFO级别， 则应用程序中所有DEBUG级别的日志信息将不被打印出来。

Log4Net组件使用

1.Nuget引入程序集：

log4Net Microsoft.Extensions.Logging.Log4Net.AspNetCore

2.准备好配置文件

<?xml version="1.0" encoding="utf-8"?>
<log4net>
	<!-- Define some output appenders -->
	<appender name="rollingAppender" type="log4net.Appender.RollingFileAppender">
		<file value="..\log\log.txt" />
		<!--追加日志内容-->
		<appendToFile value="true" />
 
		<!--防止多线程时不能写Log,官方说线程非安全-->
		<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
 
		<!--可以为:Once|Size|Date|Composite-->
		<!--Composite为Size和Date的组合-->
		<rollingStyle value="Composite" />
 
		<!--当备份文件时,为文件名加的后缀-->
		<datePattern value="yyyyMMdd.TXT" />
 
		<!--日志最大个数,都是最新的-->
		<!--rollingStyle节点为Size时,只能有value个日志-->
		<!--rollingStyle节点为Composite时,每天有value个日志-->
		<maxSizeRollBackups value="20" />
 
		<!--可用的单位:KB|MB|GB-->
		<maximumFileSize value="3MB" />
 
		<!--置为true,当前最新日志文件名永远为file节中的名字-->
		<staticLogFileName value="true" />
 
		<!--输出级别在INFO和ERROR之间的日志-->
		<filter type="log4net.Filter.LevelRangeFilter">
			<param name="LevelMin" value="ALL" />
			<param name="LevelMax" value="FATAL" />
		</filter>
		<layout type="log4net.Layout.PatternLayout">
			<conversionPattern value="%date [%thread] %-5level %logger - %message%newline"/>
		</layout>
	</appender>
	<root>
		<priority value="ALL"/>
		<level value="ALL"/>
		<appender-ref ref="rollingAppender" />
	</root>
</log4net>

3.配置好配置文件使用

放置好配置文件，并设置始终复制到目录

方法一：配置Program文件

 .ConfigureLogging(loggingBuilder=> 
 {  //配置log4Net配置文件的读取
      loggingBuilder.AddLog4Net("CfgFile/log4net.Config");
}) 

方法二：配置Startup 文件

public void Configure(IApplicationBuilder app, IWebHostEnvironment env,ILoggerFactory loggerFactory)

loggerFactory.AddLog4Net("CfgFile/log4net.Config");

配置Config文件路径

<file value="Zdylog\log.txt"/>

配置Controller

 public HomeController(ILogger<HomeController> logger)//使用log
 {
     _logger = logger;
     _logger.LogWarning("HomeController被构造。。。");//提示log
}

 _logger.LogInformation("this is HomeController.Index");//提示方法log 

4.运行测试Log4Net 记录日志

IIS启动
在对应目录下找到记录

测试成功

---