UniversalLogger - 通用日志记录库

一个基于Serilog构建的功能完整的C#日志记录库，支持多种输出方式、自动维护、配置灵活等特性。

主要功能

✅ 多种输出方式: 支持控制台、文件输出，可单独或同时使用
✅ 按日期分割: 自动按日期创建日志文件
✅ 文件大小控制: 超过指定大小自动创建新文件
✅ 自动压缩: 指定天数后自动压缩旧日志文件
✅ 自动清理: 超过保留期限自动删除旧日志
✅ 配置灵活: 支持代码配置、JSON文件配置
✅ 功能完整: 支持各级别日志、异常堆栈、上下文信息
✅ 性能优化: 基于Serilog高性能日志框架
✅ 易于使用: 提供静态类和实例两种使用方式

安装依赖

在你的项目中添加以下NuGet包：

<PackageReference Include="Serilog" Version="3.1.1" />
<PackageReference Include="Serilog.Sinks.Console" Version="5.0.1" />
<PackageReference Include="Serilog.Sinks.File" Version="5.0.0" />
<PackageReference Include="Serilog.Formatting.Json" Version="1.0.0" />
<PackageReference Include="Microsoft.Extensions.Configuration" Version="8.0.0" />
<PackageReference Include="Microsoft.Extensions.Configuration.Json" Version="8.0.0" />

快速开始

1. 使用默认配置

using UniversalLogger;

// 使用默认配置创建日志记录器
using var logger = new UniversalLogger(new LoggerConfig());

logger.LogInformation("Hello, World!");
logger.LogWarning("这是一个警告");
logger.LogError("这是一个错误");

2. 使用静态日志记录器

// 初始化静态日志记录器
Log.Initialize();

// 直接使用
Log.Information("应用程序启动");
Log.Warning("警告信息");
Log.Error(exception, "发生错误: {Message}", exception.Message);

3. 从配置文件加载

创建 appsettings.json 文件：

{
  "Logging": {
    "EnableConsole": true,
    "EnableFile": true,
    "LogPath": "logs",
    "MaxFileSizeMB": 1,
    "RetentionDays": 30,
    "CompressDaysThreshold": 3,
    "MinimumLevel": "Information",
    "OutputTemplate": "{Timestamp:yyyy-MM-dd HH:mm:ss.fff} [{Level:u3}] {Message:lj}{NewLine}{Exception}",
    "UseJsonFormat": false,
    "CompressCheckIntervalHours": 24
  }
}

使用配置文件：

// 从配置文件初始化
Log.InitializeFromJsonFile("appsettings.json");

Log.Information("使用配置文件的日志记录器");

配置选项

属性	类型	默认值	说明
`EnableConsole`	bool	true	是否启用控制台输出
`EnableFile`	bool	true	是否启用文件输出
`LogPath`	string	"logs"	日志文件存储路径
`MaxFileSizeMB`	int	1	单个日志文件最大大小(MB)
`RetentionDays`	int	30	日志保留天

2.8 KiB Raw Blame History