.NET中的日志系统是什么?如何集成Serilog或NLog进行结构化日志记录?

答案:.NET日志系统基于Microsoft.Extensions.Logging抽象,支持通过Serilog或NLog实现结构化和灵活的日志记录,其中Serilog适合现代结构化日志场景,NLog适合复杂路由需求,两者均可通过统一ILogger接口集成,便于后续替换。

.NET中的日志系统基于内置的Microsoft.Extensions.Logging抽象,提供统一的日志接口,允许开发者在不绑定具体实现的情况下记录日志。默认情况下,.NET使用简单的控制台或调试输出,但为了更强大的功能(如结构化日志、文件归档、集中收集),通常会集成第三方日志框架,如Serilog或NLog。

Serilog:结构化日志的首选

Serilog以支持结构化日志著称,它将日志记录为带有属性的事件,而不是纯文本。这使得日志更容易被查询和分析,尤其适合与ELK、Seq或Application Insights等工具配合使用。

集成步骤:

  • 安装NuGet包:Microsoft.Extensions.LoggingSerilog.AspNetCore
  • Program.cs中配置Serilog作为日志提供者
  • 定义日志输出格式和目标(如控制台、文件、Seq)

示例代码:

using Serilog;

var builder = WebApplication.CreateBuilder(args);

// 配置Serilog
Log.Logger = new LoggerConfiguration()
.WriteTo.Console(outputTemplate: "[{Timestamp:HH:mm:ss} {Level:u3}] {Message:lj}{NewLine}{Exception}")
.WriteTo.File("logs/log-.txt", rollingInterval: RollingInterval.Day)
.CreateLogger();

builder.Host.UseSerilog(); // 使用Serilog代替默认日志

var app = builder.Build();

之后,在控制器或服务中注入ILogger即可使用,所有日志会自动通过Serilog处理,并保留结构化数据:

_logger.LogInformation("用户 {UserId} 在 {LoginTime} 登录", userId, DateTime.Now);

这条日志会被解析为带UserIdLoginTime字段的结构化事件,便于搜索和过滤。

NLog:灵活且成熟的日志方案

NLog是一个高性能、可扩展的日志框架,支持丰富的目标(targets)和规则(rules),适合需要复杂日志路由的场景,比如按级别写入不同文件、发送邮件告警等。

集成方式:

  • 安装NLog.Extensions.LoggingNLog.Config
  • 在项目根目录添加nlog.config文件
  • Program.cs中注册NLog

示例nlog.config









Program.cs中启用NLog:

builder.Host.UseNLog();

NLog会读取配置文件并自动路由日志,也支持结构化日志,但默认输出是文本。可通过启用${message:raw=true}结合JSON layout提升结构化能力。

如何选择Serilog还是NLog?

两者都能很好地与.NET集成,选择取决于需求:

  • Serilog更适合需要深度结构化日志和现代日志管道(如Seq、Elasticsearch)的项目
  • NLog更适合传统企业应用,尤其是需要复杂条件路由、多种输出目标和精细控制的场景
  • 两者性能都足够好,开发体验上Serilog更简洁,NLog更灵活

基本上就这些。根据团队习惯和运维体系选一个,集成后统一使用ILogger接口,后续更换实现也不会影响业务代码。