Serilog结构化日志通过占位符解析为属性字典，支持跨平台查询；需用WriteTo链式配置多sink并分别控制级别；LogContext.PushProperty适用于async上下文，非线程安全；Seq查不到日志常见于服务未启、级别过滤或属性名转换问题。
为什么直接用 Log.Information("User {UserId} logged in at {Time}", userId, DateTime.Now) 就算结构化日志
因为 Serilog 的占位符（如 {UserId}）不是字符串拼接，而是被解析为日志事件的属性（Properties 字典），底层序列化时保留键值对。这和 string.Format 或插值字符串有本质区别——后者只生成纯文本，丢失字段语义。
常见错误是误用插值： Log.Information($"User {userId} logged in")，这样 userId 变成日志消息体的一部分，无法在 Seq 或 Elasticsearch 中按 UserId 过滤或聚合。
- 必须用位置占位符或命名占位符，且参数数量/名称严格匹配
- 支持任意 .NET 类型，Serilog 会自动展开对象属性（如
Log.Information("Order {Order}", order)） - 如果传入
null，对应属性值为null，不会抛异常，但 Seq 中显示为null
怎么配置 Serilog 同时写文件、SQL Server 和 Seq
Serilog 通过 WriteTo 链式调用添加多个接收器（sink），各 sink 独立工作、互不影响。关键不是“怎么加”，而是“加完要不要调整默认行为”。
例如，默认所有 sink 都接收 Information 及以上级别日志，但你可能希望文件保留全部（含 Debug），而 Seq 只收 Warning 以上 —— 这就得用 restrictedToMinimumLevel 参数分别控制。
- 文件 sink：
.WriteTo.File("logs/log-.txt", rollingInterval: RollingInterval.Day, retainedFileCountLimit: 7)，注意路径需有写权限，否则静默失败 - SQL Server sink：需安装
Serilog.Sinks.MSSqlServer，表结构由 sink 自动创建，但列名固定（如Message,Level,PropertiesJSON 字段），不能自定义 - Seq sink：需安装
Serilog.Sinks.Seq，连接地址必须带协议（http://或https://），端口默认 5341；若 Seq 开启 API key 认证，必须传apiKey参数，否则日志被拒绝且无提示
LogContext.PushProperty 什么时候该用，什么时候不该用
它用于给「当前作用域内所有后续日志」自动附加属性，比如请求 ID、用户 ID、事务 ID。但它不是线程安全的全局变量 —— 实际上依赖 AsyncLocal<ilogeventenricher></ilogeventenricher>，在 async/await 链中能正确传递，但在新线程（如 Task.Run）或线程池回调里会丢失。
- 适合：ASP.NET Core 中间件里为每个 HTTP 请求注入
HttpContext.TraceIdentifier - 不适合：后台定时任务中用它存“本次批次ID”，因为任务可能跨线程调度，属性会突然消失
- 替代方案：显式传参，比如封装一个
LogBatch(string batchId, string message, params object[] args)方法，在内部用Log.ForContext("BatchId", batchId).Information(message, args)
结构化日志写入 Seq 后查不到？先看这三个地方
不是配置没生效，就是数据根本没进 Seq。最常卡在这三处：
- Seq 服务没运行，或防火墙拦截了 5341 端口 —— 直接
curl -v http://localhost:5341/api/events/raw测试连通性 - 日志级别被过滤：检查 Seq 的
Settings → Filters，是否设置了默认Level >= Warning，而你发的是Information - 属性名含空格或特殊字符：Serilog 允许
{User Name}这种占位符，但 Seq 会把空格转成下划线（User_Name），查询时得用转换后的名字，否则UserName查不到
复杂点在于，同一个属性在不同 sink 中表现可能不一致：SQL Server 的 Properties 是 JSON 字符串，而 Seq 把它展开成一级字段。别指望跨平台用同一套查询语法。
