.NET 6.0 使用log4net配置日志记录方法
1.包管理器引入相关包
2.添加Log4net文件夹和log4net.config配置文件(配置文件属性设为始终复制)。
3.替换 log4net.config的内容(3.1与3.2选择一个就好,只是创建日志文件有所区别)
3.1:
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<log4net>
<!--根配置-->
<root>
<!--控制级别,由低到高: ALL|DEBUG|INFO|WARN|ERROR|FATAL|OFF-->
<!--OFF:0-->
<!--FATAL:FATAL-->
<!--ERROR: ERROR,FATAL-->
<!--WARN: WARN,ERROR,FATAL-->
<!--INFO: INFO,WARN,ERROR,FATAL-->
<!--DEBUG: INFO,WARN,ERROR,FATAL-->
<!--ALL: DEBUG,INFO,WARN,ERROR,FATAL-->
<level value="ALL"/>
<appender-ref ref="ErrorLog" />
<appender-ref ref="WarnLog" />
<appender-ref ref="InfoLog" />
<appender-ref ref="DebugLog" />
<appender-ref ref="FATALLog" />
</root>
<!-- 错误 Error.log-->
<appender name="ErrorLog" type="log4net.Appender.RollingFileAppender">
<!--日志文件路径,可以是相对路径或绝对路径-->
<file value="Logs\Error"/>
<encoding value="utf-8"/>
<!--文件名,按日期生成文件夹-->
<datePattern value="/yyyy-MM-dd/'Error.log'" />
<!--追加日志内容到文件-->
<appendToFile value="true"/>
<!--防止多线程时不能写Log,官方说线程非安全-->
<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
<!--创建日志文件的方式,可选值:Date[日期],文件大小[Size],混合[Composite]-->
<rollingStyle value="Composite"/>
<!--分割文件时在扩展名之前-->
<preserveLogFileNameExtension value="true" />
<!--日志最大个数,都是最新的,设为"-1"则不限-->
<!--rollingStyle节点为Size时,只能有value个日志-->
<!--rollingStyle节点为Composite时,每天有value个日志-->
<maxSizeRollBackups value="-1"/>
<!--单个文件大小。单位:KB|MB|GB-->
<maximumFileSize value="200MB"/>
<!--写到一个文件,置为true,则当前最新日志文件名永远为file节中的名字-->
<staticLogFileName value="false"/>
<!--日志格式-->
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date{HH:mm:ss.fff} [%thread] %-5level %logger - %message%newline"/>
</layout>
<!--输出级别是ERROR的日志,-->
<filter type="log4net.Filter.LevelRangeFilter">
<param name="LevelMin" value="ERROR" />
<param name="LevelMax" value="ERROR" />
</filter>
</appender>
<!-- 警告 Warn.log-->
<appender name="WarnLog" type="log4net.Appender.RollingFileAppender">
<!--日志文件路径,可以是相对路径或绝对路径-->
<file value="Logs\Warn"/>
<encoding value="utf-8"/>
<!--文件名,按日期生成文件夹-->
<datePattern value="/yyyy-MM-dd/'Warn.log'" />
<!--追加日志内容到文件-->
<appendToFile value="true"/>
<!--防止多线程时不能写Log,官方说线程非安全-->
<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
<!--创建日志文件的方式,可选值:Date[日期],文件大小[Size],混合[Composite]-->
<rollingStyle value="Composite"/>
<!--分割文件时在扩展名之前-->
<preserveLogFileNameExtension value="true" />
<!--日志最大个数,都是最新的,设为"-1"则不限-->
<!--rollingStyle节点为Size时,只能有value个日志-->
<!--rollingStyle节点为Composite时,每天有value个日志-->
<maxSizeRollBackups value="-1"/>
<!--单个文件大小。单位:KB|MB|GB-->
<maximumFileSize value="200MB"/>
<!--写到一个文件,置为true,则当前最新日志文件名永远为file节中的名字-->
<staticLogFileName value="false"/>
<!--日志格式-->
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date{HH:mm:ss.fff} [%thread] %-5level %logger - %message%newline"/>
</layout>
<!--输出级别是Warn的日志,-->
<filter type="log4net.Filter.LevelRangeFilter">
<param name="LevelMin" value="WARN" />
<param name="LevelMax" value="WARN" />
</filter>
</appender>
<!-- 信息 Info.log-->
<appender name="InfoLog" type="log4net.Appender.RollingFileAppender">
<!--日志文件路径,可以是相对路径或绝对路径-->
<file value="Logs\Info"/>
<encoding value="utf-8"/>
<!--文件名,按日期生成文件夹-->
<datePattern value="/yyyy-MM-dd/'Info.log'" />
<!--追加日志内容到文件-->
<appendToFile value="true"/>
<!--防止多线程时不能写Log,官方说线程非安全-->
<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
<!--创建日志文件的方式,可选值:Date[日期],文件大小[Size],混合[Composite]-->
<rollingStyle value="Composite"/>
<!--分割文件时在扩展名之前-->
<preserveLogFileNameExtension value="true" />
<!--日志最大个数,都是最新的,设为"-1"则不限-->
<!--rollingStyle节点为Size时,只能有value个日志-->
<!--rollingStyle节点为Composite时,每天有value个日志-->
<maxSizeRollBackups value="-1"/>
<!--单个文件大小。单位:KB|MB|GB-->
<maximumFileSize value="200MB"/>
<!--写到一个文件,置为true,则当前最新日志文件名永远为file节中的名字-->
<staticLogFileName value="false"/>
<!--日志格式-->
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date{HH:mm:ss.fff} [%thread] %-5level %logger - %message%newline"/>
</layout>
<!--输出级别是INFO的日志,-->
<filter type="log4net.Filter.LevelRangeFilter">
<param name="LevelMin" value="INFO" />
<param name="LevelMax" value="INFO" />
</filter>
</appender>
<!-- 调试 Debug.log-->
<appender name="DebugLog" type="log4net.Appender.RollingFileAppender">
<!--日志文件路径,可以是相对路径或绝对路径-->
<file value="Logs\Debug"/>
<encoding value="utf-8"/>
<!--文件名,按日期生成文件夹-->
<datePattern value="/yyyy-MM-dd/'Debug.log'" />
<!--追加日志内容到文件-->
<appendToFile value="true"/>
<!--防止多线程时不能写Log,官方说线程非安全-->
<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
<!--创建日志文件的方式,可选值:Date[日期],文件大小[Size],混合[Composite]-->
<rollingStyle value="Composite"/>
<!--分割文件时在扩展名之前-->
<preserveLogFileNameExtension value="true" />
<!--日志最大个数,都是最新的,设为"-1"则不限-->
<!--rollingStyle节点为Size时,只能有value个日志-->
<!--rollingStyle节点为Composite时,每天有value个日志-->
<maxSizeRollBackups value="-1"/>
<!--单个文件大小。单位:KB|MB|GB-->
<maximumFileSize value="200MB"/>
<!--写到一个文件,置为true,则当前最新日志文件名永远为file节中的名字-->
<staticLogFileName value="false"/>
<!--日志格式-->
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date{HH:mm:ss.fff} [%thread] %-5level %logger - %message%newline"/>
</layout>
<!--输出级别是DEBUG的日志,-->
<filter type="log4net.Filter.LevelRangeFilter">
<param name="LevelMin" value="DEBUG" />
<param name="LevelMax" value="DEBUG" />
</filter>
</appender>
<!-- 严重错误 FATAL.log-->
<appender name="FATALLog" type="log4net.Appender.RollingFileAppender">
<!--日志文件路径,可以是相对路径或绝对路径-->
<file value="Logs\FATAL"/>
<encoding value="utf-8"/>
<!--文件名,按日期生成文件夹-->
<datePattern value="/yyyy-MM-dd/'FATAL.log'" />
<!--追加日志内容到文件-->
<appendToFile value="true"/>
<!--防止多线程时不能写Log,官方说线程非安全-->
<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
<!--创建日志文件的方式,可选值:Date[日期],文件大小[Size],混合[Composite]-->
<rollingStyle value="Composite"/>
<!--分割文件时在扩展名之前-->
<preserveLogFileNameExtension value="true" />
<!--日志最大个数,都是最新的,设为"-1"则不限-->
<!--rollingStyle节点为Size时,只能有value个日志-->
<!--rollingStyle节点为Composite时,每天有value个日志-->
<maxSizeRollBackups value="-1"/>
<!--单个文件大小。单位:KB|MB|GB-->
<maximumFileSize value="200MB"/>
<!--写到一个文件,置为true,则当前最新日志文件名永远为file节中的名字-->
<staticLogFileName value="false"/>
<!--日志格式-->
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date{HH:mm:ss.fff} [%thread] %-5level %logger - %message%newline"/>
</layout>
<!--输出级别是FATAL的日志,-->
<filter type="log4net.Filter.LevelRangeFilter">
<param name="LevelMin" value="FATAL" />
<param name="LevelMax" value="FATAL" />
</filter>
</appender>
<!--SqlServer形式,我这里没这要求,需要的可以使用,在之前根据配置字段和数据集信息创建自己的记录表-->
<!--Nuget引入程序包:System.Data.Sqlclient-->
<!--log4net日志配置:http://logging.apache.org/log4net/release/config-examples.html -->
<appender name="AdoNetAppender_SqlServer" type="log4net.Appender.AdoNetAppender">
<!--日志缓存写入条数 设置为0时只要有一条就立刻写到数据库-->
<bufferSize value="0" />
<connectionType value="System.Data.SqlClient.SqlConnection,System.Data.SqlClient, Version=4.6.1.3, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
<connectionString value="Data Source=.;Initial Catalog=LogManager;Persist Security Info=True;User ID=sa;Password=123456" />
<commandText value="INSERT INTO Log4Net ([Date],[Thread],[Level],[Logger],[Message],[Exception]) VALUES (@log_date, @thread, @log_level, @logger, @message, @exception)" />
<parameter>
<parameterName value="@log_date" />
<dbType value="DateTime" />
<layout type="log4net.Layout.RawTimeStampLayout" />
</parameter>
<parameter>
<parameterName value="@thread" />
<dbType value="String" />
<size value="255" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%thread" />
</layout>
</parameter>
<parameter>
<parameterName value="@log_level" />
<dbType value="String" />
<size value="50" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%level" />
</layout>
</parameter>
<parameter>
<parameterName value="@logger" />
<dbType value="String" />
<size value="255" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%logger" />
</layout>
</parameter>
<parameter>
<parameterName value="@message" />
<dbType value="String" />
<size value="4000" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%message" />
</layout>
</parameter>
<parameter>
<parameterName value="@exception" />
<dbType value="String" />
<size value="2000" />
<layout type="log4net.Layout.ExceptionLayout" />
</parameter>
</appender>
</log4net>
</configuration>
创建目录根目录(Logs/下):
3.2
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<log4net>
<!-- Define some output appenders -->
<appender name="rollingAppender" type="log4net.Appender.RollingFileAppender">
<!--日志文件路径-->
<file value="Logs\" />
<encoding value="utf-8"/>
<!--文件名,按日期生成文件夹-->
<datePattern value="/yyyy-MM-dd/'filename.log'" />
<!--追加日志内容-->
<appendToFile value="true" />
<!--防止多线程时不能写Log,官方说线程非安全-->
<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
<!--可以为:Once|Size|Date|Composite-->
<!--Composite为Size和Date的组合-->
<rollingStyle value="Composite" />
<!--分割文件时在扩展名之前-->
<preserveLogFileNameExtension value="true" />
<!--当备份文件时,为文件名加的后缀-->
<!--<datePattern value="yyyyMMdd.TXT" />-->
<!--日志最大个数,都是最新的-->
<!--rollingStyle节点为Size时,只能有value个日志-->
<!--rollingStyle节点为Composite时,每天有value个日志-->
<maxSizeRollBackups value="10" />
<!--可用的单位:KB|MB|GB-->
<maximumFileSize value="5MB" />
<!--置为true,当前最新日志文件名永远为file节中的名字-->
<staticLogFileName value="false" />
<!--输出级别在INFO和ERROR之间的日志-->
<filter type="log4net.Filter.LevelRangeFilter">
<param name="LevelMin" value="INFO" />
<param name="LevelMax" value="FATAL" />
</filter>
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date{HH:mm:ss.fff} [%thread] %-5level %logger - %message%newline"/>
</layout>
<!--<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="[%d{HH:mm:ss}]%m%n"/>
</layout>-->
</appender>
<root>
<priority value="ALL"/>
<level value="ALL"/>
<appender-ref ref="rollingAppender" />
</root>
</log4net>
</configuration>
创建目录根目录(Logs/下):
3.3:对配置信息不熟悉的可以参考:【C#】.net core 6.0 使用第三方日志插件Log4net,配置文件详细说明_log4net 日志文件路径-CSDN博客
4.Program下注入(两种方式,哪个有效用哪个):
#region 将Log4Net加入Logging程序集
//方式1:注入Log4Net
//AddLog4Net函数中的参数是配置文件的路径
//如果这个文件创建在根目录下则不用输入参数
//builder.Logging.AddLog4Net("Log4net/log4net2.config");
//方式2:注入Log4Net
builder.Services.AddLogging(cfg =>
{
cfg.ClearProviders();//删除所有其他的关于日志记录的配置
cfg.SetMinimumLevel(LogLevel.Trace);//设置最低的log级别
//默认的配置文件路径是在根目录,且文件名为log4net.config
//cfg.AddLog4Net();
//如果文件路径或名称有变化,需要重新设置其路径或名称
//比如在项目根目录下创建一个名为Log4net的文件夹,将log4net.config文件移入其中
//则配置如下:
cfg.AddLog4Net(new Log4NetProviderOptions()
{
Log4NetConfigFileName = "Log4net/log4net.config",
Watch = true
});
});
#endregion
5.使用方式:
[ApiController]
[Route("[controller]")]
public class WeatherForecastController : ControllerBase
{
private static readonly string[] Summaries = new[]
{
"Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
};
//方式1依赖注入
private readonly ILogger<WeatherForecastController> _logger;
//方式二直接载入
private static ILog _log = log4net.LogManager.GetLogger(typeof(WeatherForecastController));
public WeatherForecastController(ILogger<WeatherForecastController> logger)
{
_logger = logger;
}
[HttpGet(Name = "GetWeatherForecast")]
public IEnumerable<WeatherForecast> Get()
{
_logger.LogInformation("11");
_logger.LogWarning( "22");
_logger.LogDebug( "33");
_logger.LogError( "444");
_log.Info("AA");
_log.Warn("BB");
_log.Debug("CC");
_log.Error("DD");
return Enumerable.Range(1, 5).Select(index => new WeatherForecast
{
Date = DateTime.Now.AddDays(index),
TemperatureC = Random.Shared.Next(-20, 55),
Summary = Summaries[Random.Shared.Next(Summaries.Length)]
})
.ToArray();
}
}
6.两种使用方式的区别(ILogger是.NET框架提供的一个接口,用于统一不同日志库的调用方式。它本身并不提供具体的日志记录功能,而是通过实现它的类来执行这些操作。):
log4net的ILog接口和依赖注入的ILogger接口主要区别在于它们的实现方式、使用场景和灵活性。
-
实现方式:log4net的ILog接口是log4net库中的一个接口,用于日志记录。它通常是通过直接引入log4net.dll并在代码中手动创建和使用Logger对象来实现的。这种方式下,Logger对象的创建和使用都集中在应用程序代码中。
-
使用场景:log4net的ILog接口更适合于传统的.NET应用程序,其中日志记录是应用程序的一部分,需要通过log4net提供的API来手动控制日志的输出。
-
灵活性:由于log4net的ILog接口是直接集成在应用程序中的,因此它的配置和使用相对固定,不太容易进行灵活的配置更改。例如,如果需要更改日志的输出目标(如文件、数据库等),可能需要修改应用程序代码。
相比之下,依赖注入的ILogger接口是.NET Core及以后版本推荐使用的日志记录方式,它提供了更高的灵活性和扩展性:
-
实现方式:ILogger是通过依赖注入的方式实现的,它是一个接口,可以通过不同的实现类来提供不同的日志记录功能。例如,可以使用Serilog、NLog等第三方库来实现ILogger接口的具体类,从而满足不同的日志记录需求。
-
使用场景:ILogger更适合于现代的应用程序开发,特别是那些需要高度可配置和可扩展的日志记录系统。通过依赖注入,ILogger可以很容易地集成到应用程序中,并且可以通过配置文件或代码进行灵活的配置更改。
-
灵活性:由于ILogger是一个接口,可以通过依赖注入来替换具体的实现类,这使得日志记录系统的更换和升级变得非常容易。此外,由于ILogger接口定义了一组标准的日志记录方法,包括信息、警告、错误等不同级别的日志记录,这为应用程序的开发提供了便利,同时也为日志的分析和处理提供了标准化的数据格式。
总的来说,log4net的ILog接口更适合于传统的.NET应用程序开发,而依赖注入的ILogger接口则更适合于现代应用程序开发,特别是那些需要高度可配置和可扩展的日志记录系统
END..........