.Net日志系统Logging-五

最新推荐文章于 2025-09-19 09:58:43 发布
原创 最新推荐文章于 2025-09-19 09:58:43 发布 · 841 阅读 · 14 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#.net

日志概念

        日志级别

      NET (Microsoft.Extensions.Logging) 中定义的 6 个标准日志级别，按严重性从低到高排列：

日志级别数值描述典型使用场景
Trace0最详细的信息，包含敏感数据（如请求体、密码哈希等）。仅在开发或深度故障排除时启用。记录方法入口/出口、详细变量值、低级别通信细节。
Debug1开发调试信息。比 Trace 略少细节，但仍包含对开发者有用的内部信息。记录关键变量状态、流程步骤、非性能关键操作的耗时、配置加载值。
Information2应用程序流信息。描述应用程序正常、预期内的操作。服务启动/停止、重要操作完成（如“用户登录成功”、“订单创建”）、主要里程碑事件。
Warning3异常或意外事件，但应用程序仍能继续运行。表明可能需要调查的潜在问题。重试操作、降级功能使用、预期内的外部服务错误、接近资源限制（如磁盘空间不足）。
Error4无法处理的错误。表示当前操作或请求失败，但应用程序整体仍可运行。捕获的异常、数据库连接失败、关键操作失败（如支付处理失败）、外部API调用关键错误。
Critical5最严重的故障，可能导致应用程序崩溃或不可恢复的损坏。需要立即处理。系统崩溃、数据丢失、磁盘空间耗尽、启动失败、灾难性未处理异常。

        日志提供者:需要把日志输出那个地方文件，数据库，控制台等。

        

输出日志到控制台

1.安装Nuget日志所需要的包：

        Microsoft.Extensions.Logging.Console

2.DI注入：

//创建DI容器对象
ServiceCollection services = new ServiceCollection();

       
 services.AddLogging(logBuilder => {
     //容器注入控制台输出
     logBuilder.AddConsole();

详细步骤：

1.创建一个类，使用构造方法注入ILogger<一般填写当前类名> 

 class TestLog
{
    //定义一个ILogger类型私有变量，泛型中类型填写本类
    private readonly ILogger<TestLog> logger;


    //使用构造方法进行注入
    public TestLog(ILogger<TestLog> logger) { 

        this.logger = logger;

    }

    public void Log()
    {
        logger.LogDebug("调试记录信息");
        logger.LogWarning("警告记录信息");
        logger.LogError("错误记录信息");
    }

}

2.在主程序中创建DI容器，注册服务、添加控制器输出

 public class Program
 {
     static void Main(string[] args)
     {
        //创建DI容器对象
        ServiceCollection services = new ServiceCollection();

    
         services.AddLogging(logBuilder => {
             //-----------------------------------
          
             //容器注入控制台输出
             logBuilder.AddConsole();

           //--------------------------------------

             //设置输出级别为最低
             logBuilder.SetMinimumLevel(LogLevel.Trace);  
         });

         //容器注册服务对象
         services.AddScoped<TestLog>();

         //构建一个服务提供者（Service Provider）对象
         //创建一个 `ServiceProvider` 实例。
         //-这个 `ServiceProvider` 对象就是依赖注入容器，它负责管理服务的生命周期和解析服务
         using (var sp = services.BuildServiceProvider())
         {
             //获取服务对象
          TestLog tlog =   sp.GetRequiredService<TestLog>();
             tlog.Log();
             Console.ReadKey();
         }
     }
 }

3.输出结果

输出日志到Windows的事件查看器中

1.创建一个类，使用构造方法注入ILogger<一般填写当前类名> 

 class TestLog
{
    //定义一个ILogger类型私有变量，泛型中类型填写本类
    private readonly ILogger<TestLog> logger;


    //使用构造方法进行注入
    public TestLog(ILogger<TestLog> logger) { 

        this.logger = logger;

    }

    public void Log()
    {
        logger.LogDebug("调试记录信息");
        logger.LogWarning("警告记录信息");
        logger.LogError("错误记录信息");
    }

}

2.在主程序中创建DI容器，注册服务、添加事件查看器输出

 public class Program
 {
     static void Main(string[] args)
     {
        //创建DI容器对象
        ServiceCollection services = new ServiceCollection();

    
         services.AddLogging(logBuilder => {
          //---------------------------------------

             //注入windows事件查看器中输出
             logBuilder.AddEventLog();
          //---------------------------------------

             //设置输出级别为最低
             logBuilder.SetMinimumLevel(LogLevel.Trace);  
         });

         //容器注册服务对象
         services.AddScoped<TestLog>();

         //构建一个服务提供者（Service Provider）对象
         //创建一个 `ServiceProvider` 实例。
         //-这个 `ServiceProvider` 对象就是依赖注入容器，它负责管理服务的生命周期和解析服务
         using (var sp = services.BuildServiceProvider())
         {
             //获取服务对象
          TestLog tlog =   sp.GetRequiredService<TestLog>();
             tlog.Log();
             Console.ReadKey();
         }
     }
 }

3.输出结果

NLog文本日志输出

1.安装Nuget包：NLog.Extensions.Logging

控制台输入：Install-Package  NLog.Extensions.Logging

2..创建配置文件
添加 nlog.config 配置文件（右键项目 → 新建项 → NLog 配置文件），nlog.config 位于项目根目录

内容示例如下：

<?xml version="1.0" encoding="utf-8"?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
      autoReload="true"
      internalLogLevel="info"
      internalLogFile="interal_NLog.log"
      throwExceptions="false" 
      encoding="utf-8">
  <targets>
    <!-- 控制台输出 ，layout输出布局格式-->
    <target name="console" xsi:type="Console" layout="${longdate}|${level}|${message}" />
    <!-- 文件输出（按日期分目录） -->
    <target name="file" xsi:type="File" 
            fileName="Logs/${date:format=yyyy}/${date:format=MM}/${shortdate}.log"
            layout="${longdate}|${level}|${logger}|${message} ${exception}" />
  </targets>
  <rules>
    <!--输出日志的匹配规则 ，以name名称进行匹配，输入日志的等级，输出到哪里-->
     <logger name="*" minlevel="Info" writeTo="console,file" />
     <logger name="*" minlevel="Debug" writeTo="file" />
  </rules>
</nlog>

关键设置：将文件属性设为 复制到输出目录：【始终复制】

3.创建一个类，使用构造方法注入ILogger<一般填写当前类名> 

 class TestLog
{
    //定义一个ILogger类型私有变量，泛型中类型填写本类
    private readonly ILogger<TestLog> logger;


    //使用构造方法进行注入
    public TestLog(ILogger<TestLog> logger) { 

        this.logger = logger;

    }

    public void Log()
    {
        logger.LogDebug("调试记录信息");
        logger.LogWarning("警告记录信息");
        logger.LogError("错误记录信息");
    }

}

4.在主程序中创建DI容器，注册服务、添加Nlog文本输出

 public class Program
 {
     static void Main(string[] args)
     {
        //创建DI容器对象
        ServiceCollection services = new ServiceCollection();

    
         services.AddLogging(logBuilder => {

    //========================NLog日志========================
             //注入NLog日志
             logBuilder.AddNLog();
    //========================================================


             //设置输出级别为最低
             logBuilder.SetMinimumLevel(LogLevel.Trace);  
         });

         //容器注册服务对象
         services.AddScoped<TestLog>();

         //构建一个服务提供者（Service Provider）对象
         //创建一个 `ServiceProvider` 实例。
         //-这个 `ServiceProvider` 对象就是依赖注入容器，它负责管理服务的生命周期和解析服务
         using (var sp = services.BuildServiceProvider())
         {
             //获取服务对象
          TestLog tlog =   sp.GetRequiredService<TestLog>();
             tlog.Log();
             Console.ReadKey();
         }
     }
 }

配置高级设置

  1. 异步日志提升性能

    <!-- AsyncWrapper 时会自动启用批量写入-->
<target name="asyncFile" xsi:type="AsyncWrapper">
  <target xsi:type="File" fileName="logs/async.log" KeepFileOpen=false async="true"/>
</target>

    • 避免阻塞主线程，适合高并发场景。

  2. 全局诊断上下文（GDC）

    • 设置全局变量（如应用版本）：

      NLog.GlobalDiagnosticsContext.Set("AppVersion", "2.0.0");

    • 配置中引用：

      ${gdc:item=AppVersion}

  3. 日志轮转与压缩

    <target xsi:type="File" 
        fileName="logs/app.log"
        maxArchiveFiles="30"          <!-- 保留30个文件 -->
        archiveAboveSize="10485760"   <!-- 单个文件 >10MB 时分割 -->
        enableArchiveFileCompression="true" /> <!--启用文档压缩 -->

⚡ 五、性能优化建议

  • 缓冲写入：减少 I/O 操作

    <target xsi:type="BufferingWrapper" bufferSize="1000">
  <target xsi:type="File" fileName="logs/buffered.log" />
</target>

  • 按环境调整日志级别：

    • 开发环境：Debug

    • 生产环境：Warn 或 Error。

  • 条件日志记录：避免不必要的计算

    if (logger.IsEnabled(LogLevel.Debug)) 
{
    var data = ExpensiveOperation();
    logger.Debug(data);
}

    目标标签配置选项：

  • File target · NLog/NLog 数据库https://github.com/NLog/NLog/wiki/Database-target

  • File target · NLog/NLog Wiki · GitHubhttps://github.com/NLog/NLog/wiki/File-target

  • NLog 和 SQL Server 示例配置

    <target name="database" xsi:type="Database">
  <connectionString>server=localhost;Database=*****;user id=****;password=*****</connectionString>

  <!--
    数据库中创建日志表
  Script for creating the dbo.Log table.
      
  SET ANSI_NULLS ON
  SET QUOTED_IDENTIFIER ON
  CREATE TABLE [dbo].[Log] (
	  [Id] [int] IDENTITY(1,1) NOT NULL,
	  [MachineName] [nvarchar](50) NOT NULL,
	  [Logged] [datetime] NOT NULL,
	  [Level] [nvarchar](50) NOT NULL,
	  [Message] [nvarchar](max) NOT NULL,
	  [Logger] [nvarchar](250) NULL,
	  [Exception] [nvarchar](max) NULL,
    CONSTRAINT [PK_dbo.Log] PRIMARY KEY CLUSTERED ([Id] ASC)
      WITH (PAD_INDEX  = OFF, STATISTICS_NORECOMPUTE  = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS  = ON, ALLOW_PAGE_LOCKS  = ON) ON [PRIMARY]
  ) ON [PRIMARY]
  -->
      
  <commandText>
    insert into dbo.Log (
      MachineName, Logged, Level, Message,
      Logger, Exception
    ) values (
      @MachineName, @Logged, @Level, @Message,
      @Logger, @Exception
    );
  </commandText>

  <parameter name="@MachineName" layout="${machinename}" />
  <parameter name="@Logged" layout="${date}" />
  <parameter name="@Level" layout="${level}" />
  <parameter name="@Message" layout="${message}" />
  <parameter name="@Logger" layout="${logger}" />
  <parameter name="@Exception" layout="${exception:tostring}" />
</target>

    Serilog结构化日志输出

  • 官方文档：NuGet 库 |Serilog.AspNetCore 9.0.0https://www.nuget.org/packages/Serilog.AspNetCore/9.0.0
  • 安装Nuget包：
    • Serilog.AspNetCore

日志设置：

Log.Logger = new LoggerConfiguration()
    .MinimumLevel.Debug()
    .MinimumLevel.Override("Microsoft", LogEventLevel.Information)
    .Enrich.FromLogContext()
    .WriteTo.Console()
    // Add this line:
    .WriteTo.File(
        //连接路径 存放位置：C:\Users\xxxxxx\LogFiles\Application\diagnostics.txt
       System.IO.Path.Combine(Environment.GetEnvironmentVariable("HOME"), "LogFiles", "Application", "diagnostics.txt"),
       rollingInterval: RollingInterval.Day,
       fileSizeLimitBytes: 10 * 1024 * 1024,
       retainedFileCountLimit: 2,
       rollOnFileSizeLimit: true,
       shared: true,
       flushToDiskInterval: TimeSpan.FromSeconds(1))
    .CreateLogger();

 //添加serilog日志对象
 services.AddSerilog();

完整代码：

1.安装serilog包：

       

 Install-Package  Serilog.AspNetCore

2.创建一个类，使用构造方法注入ILogger<一般填写当前类名> 

 class TestLog
{
    //定义一个ILogger类型私有变量，泛型中类型填写本类
    private readonly ILogger<TestLog> logger;


    //使用构造方法进行注入
    public TestLog(ILogger<TestLog> logger) { 

        this.logger = logger;

    }

    public void Log()
    {
        logger.LogDebug("调试记录信息");
        logger.LogWarning("警告记录信息");
        logger.LogError("错误记录信息");
    }

}

3.在主程序中创建DI容器，注册服务、添加serilog文本输出

public class Program
{
    static void Main(string[] args)
    {
       //创建DI容器对象
       ServiceCollection services = new ServiceCollection();

   
        services.AddLogging(logBuilder => {
   
            //存放日志路径
            string path = System.IO.Path.Combine(Environment.GetEnvironmentVariable("HOME"), "LogFiles", "Application", "diagnostics.txt");

            //serilog日志的设置
            Log.Logger = new LoggerConfiguration()
                            .MinimumLevel.Debug()
                            .Enrich.FromLogContext()
                             .WriteTo.Console(new JsonFormatter())
                             .WriteTo.File(path,
                               rollingInterval: RollingInterval.Day,
                               fileSizeLimitBytes: 10 * 1024 * 1024,
                               retainedFileCountLimit: 2,
                               rollOnFileSizeLimit: true,
                               shared: true,
                               flushToDiskInterval: TimeSpan.FromSeconds(1))
                             .CreateLogger();

            //添加serilog日志对象
            logBuilder.AddSerilog();

            //设置输出级别为最低
            logBuilder.SetMinimumLevel(LogLevel.Trace);  
        });


        //容器注册服务对象
        services.AddScoped<TestLog>();

        //构建一个服务提供者（Service Provider）对象
        //创建一个 `ServiceProvider` 实例。
        //-这个 `ServiceProvider` 对象就是依赖注入容器，它负责管理服务的生命周期和解析服务
        using (var sp = services.BuildServiceProvider())
        {
            //获取服务对象
         TestLog tlog =   sp.GetRequiredService<TestLog>();
            tlog.Log();
            Console.ReadKey();
        }
    }
}

qq_18519869
关注
.net日志系统
qq_45800365的博客
08-21 1321
NLog 是一个流行的 .NET 平台上的开源日志记录库，用于在应用程序中进行日志记录。它提供了丰富的特性和灵活的配置选项，使开发人员能够轻松地集成日志记录功能，并将日志信息记录到不同的目标，如文件、数据库、控制台、第三方服务等。NLog 是一个强大而又广泛使用的日志记录解决方案，适用于各种不同规模和类型的应用程序。以下是 NLog 的一些关键特点和用法：多种目标支持：NLog 支持将日志记录到多种不同的目标，包括文件、数据库、控制台、网络、邮件等。您可以根据应用程序的需求将日志信息存储在不同的地方。
.NET Core 核心知识点(六) -- 日志系统
liyumin2006的博客
08-01 1109
我们在实际项目开发的过程中，日志记录是一个非常重要的功能点，记录日志，可以帮我们很好的分析问题，定位问题，解决问题，一个完整的项目必须要有日志记录的模块。
.net 日志
周自包的博客
02-29 711
1、nuget引入log4net、Microsoft.Extensions.Logging.Log4Net.AspNetCore这2个2、引入配置文件，可以直接去官网()复制下来，放到项目目录下面，设置成始终复制，因为这个文件最终要到我们项目运行目录下面去3、要在program.cs文件配置4、注入到构造函数，然后使用也可以注入一个loggerFactory，通过loggerFactory来创建日志实例。
.net日志的用法
bankuang9226的博客
05-23 210
public class Logs { private static Logger logger = LogManager.GetCurrentClassLogger(); //初始化日志类 /// <summary> /// 日志状态枚举 /// </summary> privat...
.NET自定义数据操作日志
最新发布
yqsy123123的博客
09-19 1245
本文介绍了一种高效的数据库操作日志记录方案，采用Vue3、.NET 8 WebAPI和SQL Server技术栈实现。方案通过创建日志配置表和日志记录表，结合系统视图获取表结构信息，在数据操作时自动检查配置并记录变更日志。相比传统触发器方式，该方案具有配置灵活、资源占用少的特点，支持选择性记录指定表和字段的变更情况，日志内容以JSON格式存储新旧数据，便于后续审计追踪。
.NET日志系统
ahao214——Dreamspace
05-28 438
1、日志级别：Trace < Debug < Information < Warning < Error < Critical 2、日志提供者(LoggingProvider):把日志输出到哪里。控制台、文件、数据库等 3、.NET的日志非常灵活，对应业务代码只要注入日志对象记录日志即可，具体哪些日志输出到哪里、什么样的格式、是否输出等都有配置或者初始化代码块决定 ...
.Net 日志系统-Serilog
每天学习一点点
01-16 5325
Serilog 是一个结构化的 C# 日志库。 跟log4net和nlog相比，Serilog记录结构化日志更加方便，可以对日志内容自定义格式输出，方便查询和使用。 .Net Core程序记录日志到文本文件中，下面用代码来演示如何实现： 基于.Net Core WebApi 3.1程序，项目结构如下图： 1.NuGet应用程序集：Serilog.AspNetCore 2.在Program.cs中创建全局静态实例并启用Serilog Program.cs完整代码： us
.net5 mvc项目输出日志
浩瀚与渺小
07-20 759
我们在创建一个项目时，有时候需要查看日志，我们一般会集成插件。log4j就是一个不错的插件，常见的项目首选插件。log4net库是Apache log4j框架在Microsoft .NET平台的实现。 首先我们针对.net5的mvc项目进行配置日志文件。 步骤一：创建项目。 步骤2：创建一个专门存放配置文件的文件夹cdgfile，创建log4net.config的配置文件。 配置文件以及详细说明如下。 <?x...
.Net5-elastic-logging:登录弹性搜索的示例配置
04-03
在.NET 5开发环境中，日志记录是至关重要的，它帮助开发者追踪应用程序的运行状态、错误和异常。本文将深入探讨如何使用C#语言集成Elasticsearch（简称Elasticsearch或ES）作为日志存储和分析平台，实现.NET 5应用的...
NLog - Advanced .NET Logging-开源
05-03
总而言之，NLog作为一款开源的.NET日志库，不仅提供了丰富的日志记录功能，还具备高度的灵活性和可扩展性，是.NET开发者不可或缺的工具。其强大的路由和管理特性，使其能够轻松应对各种复杂的日志记录场景，确保应用...
如何查看和收集Service Fabic 中ASP.NET core应用 logging产生的日志-chen rui1
08-08
Microsoft.Extensions.Logging框架是ASP.NET Core中用于生成应用服务日志的标准工具，它提供了多种日志提供者（Log Providers）来记录不同级别的日志信息。下面我们将详细介绍如何查看和收集这些日志，以及如何利用...
ASP.NET教务管理平台-权限及公共模块设计与开发(源代码+论文).zip
03-12
日志记录对于追踪系统行为和错误诊断至关重要，可以使用ASP.NET的Logging框架如Log4Net或NLog实现。 在ASP.NET中，数据库交互通常使用ADO.NET或Entity Framework。前者允许直接SQL操作，适合复杂查询，后者则是ORM...
LoggerNet 4.0
06-21
LoggerNet 4.0安装文件 无使用期限。序列号内附。文件过大，需各位从网盘下载。
.Net 日志系统-常用日志框架
每天学习一点点
01-09 6202
程序记录日志是非常重要的事情，下面总结常用的程序记录日志的框架。 1.Windows日志 这是Windows操作系统自带的日志记录程序，它记录了操作系统中程序所执行的各种操作。 这种方式也可以用来记录程序的各种日志，因为它只能在Windows平台使用，并且查看问题并不方便，不能放到文本中查看等等一些弊端。所以并不常用，但是也可满足.Net程序记录日志。 .Net 日志系统-Windows日志 2.Log4Net 这个是非常老牌的日志框架，项目中使用的非常普遍。之前写过几篇文章记录log4ne
.net core 5 入门（二）日志篇
a632374118的博客
03-16 1061
.net core 5 入门日志篇1.日志选择2.配置文件3.创建log4net工具类4.startup 初始化log4net配置5.调用6.结果 日志篇 1.日志选择 log4net 2.0.12 2.配置文件 新建文件夹 Log4Net 创建xml 文件 log4net.xml <?xml version="1.0" encoding="utf-8" ?> <configuration> <configSections> <section name="
.net最简单的日志记录
ycstephenlmj的博客
07-17 1100
.net中 最常用的日志记录一般都知道log4net，相对需要引用dll和一些配置，其实可以最简单的自己生成日志，为了方便以后自己的使用，在此记录下 public static class Logger { public static void WriteLog(string msg) { string filePath = ""; string logPath = ""; ...
一个简单的.net写日志方法 - 可能的改进点
tangtiantian520的专栏
05-30 541
参见:http://www.cnblogs.com/PurpleTide/archive/2012/05/21/2511466.html
企业中的.NET Core微服务：Logger作为微服务
寒冰屋的专栏
01-22 439
传统方法 在单体应用程序或来自不同供应商的独立应用程序的世界中，系统中日志信息的模式主要使用直接合并到应用程序中的日志器程序，并在每个应用程序中单独配置。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值