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

来源:这里教程网 时间:2026-02-21 17:30:26 作者:

.NET中的日志系统基于内置的

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

Serilog:结构化日志的首选

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

集成步骤:

安装NuGet包:
Microsoft.Extensions.Logging
Serilog.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<t></t>
即可使用,所有日志会自动通过Serilog处理,并保留结构化数据:

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

这条日志会被解析为带

UserId
LoginTime
字段的结构化事件,便于搜索和过滤。

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

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

集成方式:

安装
NLog.Extensions.Logging
NLog.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
接口,后续更换实现也不会影响业务代码。

相关推荐