如何为.NET中Serilog日志关联Windows事件查看器的Event ID？

我之前也碰到过这个问题——Serilog默认不会自动把咱们自定义的Event ID同步到Windows事件查看器里，得做两步关键配置才行，结合你现有的LoggingEvents类，咱们一步步来：

1. 确保安装了Event Log Sink包 #

首先得有Serilog专门输出到Windows事件日志的组件，用NuGet安装：

# NuGet包管理器命令
Install-Package Serilog.Sinks.EventLog

# 或者.NET CLI命令
dotnet add package Serilog.Sinks.EventLog

2. 配置Serilog，指定Event ID映射属性 #

在初始化Serilog日志器的时候，要给Event Log Sink指定哪个属性作为Windows事件日志的Event ID。咱们就用EventId这个属性名，和你定义的日志事件ID对应：

示例配置（控制台项目或ASP.NET Core通用） #

Log.Logger = new LoggerConfiguration()
    .WriteTo.Console() // 保留你原来的控制台输出
    .WriteTo.EventLog(
        source: "你的应用程序名称", // 这个会显示在事件查看器的"来源"列
        propertyToEmitAsEventId: "EventId" // 核心：把名为EventId的属性映射到系统事件ID
    )
    .CreateLogger();

ASP.NET Core的Host配置方式 #

如果是ASP.NET Core项目，更推荐在Host里配置：

var builder = WebApplication.CreateBuilder(args);

builder.Host.UseSerilog((context, config) =>
{
    config
        .ReadFrom.Configuration(context.Configuration) // 支持从appsettings.json读取配置
        .WriteTo.Console()
        .WriteTo.EventLog(
            source: "MyDotNetApplication",
            propertyToEmitAsEventId: "EventId"
        );
});

3. 日志调用时传递Event ID #

现在需要在写日志的时候，把LoggingEvents里的常量作为EventId属性传递给Serilog，有两种常用方式：

方式一：用ForContext明确传递属性 #

这种方式更清晰，适合结构化日志：

// 信息日志示例
Log.ForContext("EventId", LoggingEvents.ADMIN_ACCESS)
   .Information("管理员访问了后台面板");

// 错误日志示例
Log.ForContext("EventId", LoggingEvents.ERROR_POST_APPLICATION)
   .Error("提交应用数据时发生异常");

方式二：在日志消息中包含Event ID属性 #

如果你喜欢简洁写法，也可以直接在日志模板里指定：

Log.Information("管理员访问后台面板 {EventId}", LoggingEvents.ADMIN_ACCESS);

额外注意事项 #

• Windows事件日志的Event ID必须是1-65535之间的整数，你定义的LoggingEvents里的ID都符合要求，没问题。
• 第一次运行应用时可能需要管理员权限，因为Serilog需要注册事件源到系统中；之后普通权限即可。
• 确保属性名完全一致：配置里的propertyToEmitAsEventId是EventId，日志调用时传递的属性名也必须是EventId，大小写敏感。

做完这些配置后，再去Windows事件查看器里看日志，就能看到对应的Event ID和你定义的LoggingEvents常量关联上了。

内容的提问来源于stack exchange，提问作者Ariel Larisma