C#的日志记录(Logging)是什么？如何集成Serilog或NLog？

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

C#的日志记录(Logging)是什么？如何集成Serilog或NLog？

2025-11-11

浏览次数：次

返回列表

答案：C#中常用Serilog和NLog实现日志记录，Serilog支持结构化日志和多种输出，适用于微服务；NLog配置灵活、性能高，适合企业应用，两者均通过ILogger接口集成。

c#的日志记录(logging)是什么？如何集成serilog或nlog？

日志记录（Logging）在C#开发中是用于跟踪应用程序运行状态、捕获错误信息和调试问题的重要手段。它帮助开发者了解程序执行流程，尤其是在生产环境中排查异常或性能瓶颈时非常关键。

.NET 提供了内置的 ILogger 接口和默认的日志提供程序（如 Console、Debug、EventLog 等），但第三方日志框架如 Serilog 和 NLog 功能更强大，支持结构化日志、多种输出目标（文件、数据库、网络服务等）以及灵活的配置方式。

集成 Serilog

Serilog 以结构化日志著称，适合将日志写入 JSON 格式并对接 ELK、Seq 等分析平台。

1. 安装 NuGet 包
在项目中安装以下包：

Serilog.AspNetCore（用于 ASP.NET Core 集成）
Serilog.Sinks.Console（控制台输出）
Serilog.Sinks.File（文件输出）

可通过 Package Manager 或 CLI 执行：

dotnet add package Serilog.AspNetCore
dotnet add package Serilog.Sinks.Console  
dotnet add package Serilog.Sinks.File

2. 配置 Serilog
在 Program.cs 中配置：

using Serilog;

var builder = WebApplication.CreateBuilder(args);

// 配置 Serilog
builder.Host.UseSerilog((context, services, configuration) => configuration
    .WriteTo.Console()
    .WriteTo.File("logs/log-.txt", rollingInterval: RollingInterval.Day)
    .ReadFrom.Services(services)
    .Enrich.FromLogContext());

var app = builder.Build();

app.Run();

3. 使用 ILogger
在控制器或其他服务中注入 ILogger 即可使用：

public class HomeController : Controller
{
    private readonly ILogger<HomeController> _logger;

    public HomeController(ILogger<HomeController> logger)
    {
        _logger = logger;
    }

    public IActionResult Index()
    {
        _logger.LogInformation("访问了首页");
        return View();
    }
}

集成 NLog

NLog 是一个高性能、易于配置的日志框架，支持大量目标和规则过滤。

千鹿Pr助手

智能Pr插件，融入众多AI功能和海量素材

128 查看详情千鹿Pr助手

1. 安装 NuGet 包
安装以下包：

NLog.Extensions.Logging
NLog.Config（可通过模板生成 nlog.config）

命令示例：

dotnet add package NLog.Extensions.Logging
dotnet add package NLog.Config

2. 添加 nlog.config 配置文件
在项目根目录添加 nlog.config，内容如下：

<?xml version="1.0" encoding="utf-8"?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

  <targets>
    <target xsi:type="File" name="fileTarget" 
            fileName="logs/${shortdate}.log" 
            layout="${longdate} ${level} ${message} ${exception}" />
    <target xsi:type="Console" name="consoleTarget" />
  </targets>

  <rules>
    <logger name="*" minlevel="Trace" writeTo="fileTarget,consoleTarget" />
  </rules>
</nlog>

确保设置该文件的“复制到输出目录”为“始终复制”。 3. 在 Program.cs 中启用 NLog

using NLog;
using NLog.Web;

var builder = WebApplication.CreateBuilder(args);

// 添加 NLog
builder.Host.UseNLog();

var app = builder.Build();

app.Run();

4. 使用 ILogger
与 Serilog 一样，通过依赖注入使用标准 ILogger 接口写日志。