LyuLogExtension 1.6.1

LyuLogExtension

基于 ZLogger 的日志扩展库。

安装

dotnet add package LyuLogExtension

使用方式

方式一：依赖注入（ASP.NET Core / Host）

using LogExtension.Builder;
using LogExtension.Extensions;
using Microsoft.Extensions.Logging;

services.AddZLogger(builder => builder
    // 文件输出配置
    .AddFileOutput("logs/trace/", minLevel:LogLevel.Trace, maxLevel:LogLevel.Debug)  // Trace + Debug
    .AddFileOutput("logs/info/", LogLevel.Information)              // Info 及以上
    .AddFileOutput("logs/error/", LogLevel.Error)                   // Error 及以上
    .AddFileOutput("logs/debug/", LogLevel.debug, null, RollingInterval.Hour, 2048) //debug使用独立滚动配置
    
    // 控制台输出
    .WithConsole()              // 带时间戳
    // .WithConsoleDetails()    // 带时间戳和类名
    
    // 过滤器
    .FilterMicrosoft()          // 过滤 Microsoft 命名空间 (Warning+)
                    			//.FilterMicrosoft(LogLevel.Information) 
    .FilterSystem()             // 过滤 System 命名空间 (Warning+)
    .WithFilter("MyApp.Verbose", LogLevel.Warning)  // 自定义过滤
    
    // 滚动配置（全局默认）
    .WithRollingInterval(RollingInterval.Day)  // 按天滚动
    .WithRollingSizeKB(4096)                   // 单文件最大 4MB
);

方式二：静态方式（控制台应用 / 无 DI 场景）

using LogExtension;
using LogExtension.Builder;
using Microsoft.Extensions.Logging;

// 配置
ZLogFactory.Configure(builder => builder
    .AddFileOutput("logs/trace/", LogLevel.Trace, LogLevel.Debug)
    .AddFileOutput("logs/info/", LogLevel.Information)
    .WithConsole()
    .FilterMicrosoft()
);

// 获取 Logger
var logger = ZLogFactory.Get<Program>();
logger.ZLogInformation($"应用启动");

方式三：从配置文件加载

services.AddZLogger(configuration, "ZLogger");

// 配置文件 + 链式覆盖
services.AddZLogger(configuration, builder => builder
    .WithConsole()
    .FilterMicrosoft(),
    "ZLogger"
);

appsettings.json 示例：

{
  "ZLogger": {
    "GlobalRollingInterval": "Day",
    "GlobalRollingSizeKB": 4096,
    "Outputs": [
      {
        "Path": "logs/trace/",
        "MinLevel": "Trace",
        "MaxLevel": "Debug"
      },
      {
        "Path": "logs/info/",
        "MinLevel": "Information"
      },
      {
        "Path": "logs/error/",
        "MinLevel": "Error"
      }
    ],
    "LogLevel": {
      "Microsoft": "Warning",
      "System": "Warning"
    }
  }
}

文件输出配置

快捷方法

.AddTraceOutput()           // logs/trace/ (Trace + Debug)
.AddTraceOutput("custom/")  // 自定义路径

.AddInfoOutput()            // logs/ (Info+)
.AddInfoOutput("custom/")   // 自定义路径

.AddErrorOutput()           // logs/error/ (Error+)
.AddErrorOutput("custom/")  // 自定义路径

滚动配置

// 全局默认配置（对所有未单独配置的输出生效）
.WithRollingInterval(RollingInterval.Day)   // Hour / Day / Month / Year
.WithRollingSizeKB(4096)                    // 单文件最大大小 KB

// 单个输出独立配置（覆盖全局）
.AddFileOutput("logs/error/", LogLevel.Error, null, RollingInterval.Hour, 2048)

默认值：

• 滚动间隔：Hour（每小时）
• 单文件大小：2048 KB（2MB）

控制台配置

.WithConsole()          // 时间戳格式：2025-01-01 12:00:00.000 [INF] 消息
.WithConsoleDetails()   // 详细格式：2025-01-01 12:00:00.000 [INF] [MyApp.Service] 消息

过滤器配置

// 快捷方法
.FilterMicrosoft()                          // Microsoft 命名空间 Warning+
.FilterMicrosoft(LogLevel.Error)            // Microsoft 命名空间 Error+
.FilterSystem()                             // System 命名空间 Warning+
.FilterSystem(LogLevel.Error)               // System 命名空间 Error+

// 自定义过滤
.WithFilter("MyApp.Verbose", LogLevel.Warning)
.WithFilter("System.Net.Http", LogLevel.Error)

// 批量过滤
.WithFilters(new Dictionary<string, LogLevel>
{
    ["Microsoft"] = LogLevel.Warning,
    ["System"] = LogLevel.Warning,
    ["MyApp.Debug"] = LogLevel.Information
})

日志记录

// 注入方式
public class MyService(ILogger<MyService> logger)
{
    public void DoWork()
    {
        logger.ZLogTrace($"跟踪信息");
        logger.ZLogDebug($"调试信息: {value}");
        logger.ZLogInformation($"普通信息");
        logger.ZLogWarning($"警告信息");
        logger.ZLogError($"错误信息");
        logger.ZLogCritical($"严重错误");
        
        // 带异常
        try { ... }
        catch (Exception ex)
        {
            logger.ZLogError(ex, $"操作失败: {operation}");
        }
    }
}

// 静态方式
var logger = ZLogFactory.Get<Program>();
logger.ZLogInformation($"消息");

⚠️ 注意：必须使用 $"" 字符串插值语法，否则会编译报错。

日志输出格式

控制台：

2025-01-01 12:00:00.000 [INF] 应用启动成功
2025-01-01 12:00:00.001 [WRN] 配置缺失

文件：

2025-01-01 12:00:00.000 [INF] [MyApp.Services.UserService:42] 用户登录成功
2025-01-01 12:00:00.001 [ERR] [MyApp.Controllers.ApiController:78] 数据库连接失败
异常: System.InvalidOperationException: Connection timeout
堆栈: at MyApp.Controllers.ApiController.GetData() in ApiController.cs:line 78

默认配置

链式方法一览

致谢

本项目基于 ZLogger 构建。

License

MIT