C#日志分级详解（从Trace到Fatal：掌握日志级别提升开发效率）

什么是日志分级？

日志分级是指将日志信息按照其重要性或严重程度划分为不同级别。这样开发者可以根据需要选择输出哪些级别的日志，避免在生产环境中输出过多无用信息，同时在调试时又能获取足够细节。

在 C# 生态中，主流的日志框架（如 NLog、log4net、Serilog 以及 .NET 内置的 ILogger 接口）都支持以下六个标准日志级别：

• Trace：最详细的日志，通常用于追踪程序执行流程。
• Debug：调试信息，用于开发阶段排查逻辑问题。
• Information（Info）：常规操作信息，如服务启动、用户登录等。
• Warning（Warn）：潜在问题，但不影响系统正常运行。
• Error：错误事件，导致某项功能失败。
• Fatal（Critical）：严重错误，可能导致整个应用崩溃。

各日志级别的使用场景

1. Trace（跟踪）

用于记录非常细粒度的信息，比如方法进入/退出、变量值变化等。仅在深度调试时启用。

logger.LogTrace("Entering method CalculateTotal with parameters: {amount}, {tax}", amount, tax);

2. Debug（调试）

记录有助于调试的信息，例如中间计算结果、配置加载情况等。开发环境常用，生产环境通常关闭。

logger.LogDebug("User cache refreshed. Total users: {count}", userCount);

3. Information（信息）

记录应用程序的关键流程节点，如服务启动、数据库连接成功、用户操作等。这些日志在生产环境中通常保留。

logger.LogInformation("Application started on {timestamp}", DateTime.Now);

4. Warning（警告）

表示异常情况，但系统仍可继续运行。例如磁盘空间不足、API 调用超时等。

logger.LogWarning("API call to {url} took longer than 5 seconds.", apiUrl);

5. Error（错误）

记录导致功能失败的错误，如数据库连接失败、空引用异常等。这类日志必须被监控。

try {    ProcessOrder(orderId);}catch (Exception ex){    logger.LogError(ex, "Failed to process order {orderId}", orderId);}

6. Fatal / Critical（致命）

表示系统无法恢复的严重故障，如配置文件缺失、核心服务崩溃等。这类日志通常会触发告警。

logger.LogCritical("Database connection string is missing. Application cannot start.");

如何在 ASP.NET Core 中配置日志级别？

在 .NET 6+ 项目中，你可以通过 appsettings.json 文件轻松控制日志输出级别：

{  "Logging": {    "LogLevel": {      "Default": "Information",      "Microsoft.AspNetCore": "Warning"    }  }}

上述配置表示：默认日志级别为 Information，而来自 Microsoft.AspNetCore 命名空间的日志只显示 Warning 及以上级别。

日志记录最佳实践

• 不要在生产环境中开启 Trace 或 Debug 级别，以免影响性能。
• 使用结构化日志（如 Serilog），便于后续分析和搜索。
• 避免在日志中记录敏感信息（如密码、身份证号）。
• 对 Error 和 Critical 日志设置监控告警。

总结

掌握 C#日志分级 是每位 .NET 开发者的必备技能。通过合理使用 Trace、Debug、Info、Warn、Error、Fatal 这六个级别，你可以在不同环境下灵活控制日志输出，既保证调试效率，又确保生产环境的稳定性。结合 Logging in C# 的现代框架（如 ILogger），再配合 日志记录最佳实践，你的应用将更加可观测、可维护。

希望这篇教程能帮助你理解 C# 中的日志级别。动手试试吧！