ASP.NET Core 日志记录最佳实践
内容提要
本文介绍了在ASP.NET Core应用程序中实现日志记录的最佳实践，建议使用Serilog作为日志记录库，提及了适当的日志级别、日志过滤器、结构化日志记录、避免记录敏感信息、记录错误、监控日志大小和性能以及使用日志UI集中和可视化日志的最佳实践。
延伸解读
结构化日志：从文本到可查询数据
文章强调结构化日志记录的重要性，建议使用命名参数而非字符串插值。例如，使用 logger.LogInformation("Shipment for order '{OrderId}' is already created", request.OrderId) 将 OrderId 作为独立字段记录，便于在日志工具中搜索和分析。避免使用字符串插值，否则日志将变为纯文本，无法按关键参数查询。
敏感信息处理：掩码与过滤策略
文章指出记录敏感信息如密码、信用卡号会带来安全风险，并提供了 Serilog 的三种防护措施：使用 Destructure.ByMaskingProperties 对复杂对象中的敏感属性进行掩码；手动替换敏感数据为星号；配置过滤器排除包含特定属性（如 Password）的日志事件。定期审查日志以确保没有意外记录敏感信息。
日志性能与存储管理
日志记录可能影响应用性能，尤其是写入磁盘或网络时。文章建议使用异步日志记录（如 Serilog.Sinks.Async）将日志写入后台线程，减少 I/O 瓶颈。同时，通过日志轮换和保留策略管理存储，例如按天轮换并保留最近 7 天的日志，限制文件大小。在生产环境中应关闭控制台日志记录，因其可能显著降低应用速度。
集中化日志与可视化工具
在分布式或微服务架构中，日志分散难以排查问题。文章推荐使用集中式日志 UI 如 Seq，聚合来自不同来源的日志，提供搜索、可视化和告警功能。通过 Serilog.Sinks.Seq 将日志发送到 Seq，并利用结构化日志的字段进行精确查询。文章还列举了其他替代方案，如 ELK Stack、Datadog、Azure Monitor Logs 等。
Q&A
为什么在ASP.NET Core中使用Serilog作为日志记录库？
Serilog性能优越，支持结构化日志记录，且具有灵活的配置选项和丰富的接收器生态系统。
如何设置ASP.NET Core应用程序的日志级别？
可以在appsettings.json中配置MinimumLevel，设置不同的日志级别，如Debug、Information、Warning等。
什么是结构化日志记录，为什么要使用它？
结构化日志记录允许以键值对的形式记录数据，使日志更易于查询和分析，避免使用字符串插值。
如何避免在日志中记录敏感信息？
可以使用去标识化策略、手动遮蔽敏感数据，或配置过滤器来排除特定的日志事件。
为什么需要监控日志的大小和性能？
监控日志大小和性能可以防止存储过度消耗和性能瓶颈，确保应用程序的稳定性。
如何使用集中化的日志UI工具？
可以使用像Seq这样的工具来聚合和可视化日志数据，增强监控和分析能力。
