YYZ.LOGGER 1.0.1

YyzLogger，让日志自动化规范化，yyds

适合API项目

后台使用LiteDB、消息队列插入数据库的方式，可配置指定时间删除归档数据库日志文件。

• appsetting.json配置以下选项：

"Yyzlog": {
    "LogFolderName": "log",
    "RetentionDays": 3,
    "CleanupHour": 17,
    "CleanupMinute": 5
}

• program.cs 注册：

using YYZ.LOGGER;
var builder = WebApplication.CreateBuilder(args);
// Add services to the container.
builder.Services.AddControllers();
// 注册 YYZ 日志组件
builder.Services.AddYyzLogger(builder.Configuration);
var app = builder.Build();
// 启动后台日志清理任务
using (var scope = app.Services.CreateScope())
{
   var logger = scope.ServiceProvider.GetRequiredService<IyyzLogger>();
   await logger.StartBacgroudTick();
}
app.UseHttpsRedirection();
app.MapControllers();
app.Run();

• controller 注入：

  private readonly IyyzLogger _logger;

  public TestController(IyyzLogger logger)
  {
      _logger = logger;
  }

• controller 使用：

await _logger.WriteBatch(entries);  //批量插入日志
await _logger.WriteOne(log);  //插入单条

/// <summary>
/// 读取日志。
/// level: 0=全部，1=Info，2=Warn，3=Error。
/// BillNo: 单据号过滤，可空。
/// container: 容器号过滤，可空。
/// platform: 业务平台过滤，可空。
/// order: "asc" 或 "desc"，为空时默认为时间升序。
/// page: 页码，从1开始。
/// size: 每页大小。
/// </summary>
[HttpGet("logs")]
public async Task<ActionResult<List<YlogEntry>>> GetLogs(
   int level = 0,
   DateTime? t_start = null,
   DateTime? t_end = null,
   string? BillNo = null,
   string? container = null,
   string? platform = null,
   string? order = "asc",
   int page = 1,
   int size = 100)
{
   var start = t_start ?? DateTime.Today.AddDays(-7);
   var end = t_end ?? DateTime.Now;
   
   var logs = await _logger.ReadLog(level, start, end, BillNo, container, platform, order, page, size);
   return Ok(logs);
}

/// <summary>
/// 批量删除符合条件的日志。
/// level: 0=全部，1=Info，2=Warn，3=Error。
/// t_start: 开始时间，必须。
/// t_end: 结束时间，必须。
/// BillNo: 单据号过滤，可空。
/// container: 容器号过滤，可空。
/// platform: 业务平台过滤，可空。
/// </summary>
[HttpDelete("logs")]
public async Task<IActionResult> DeleteLogs(
   int level = 0,
   DateTime? t_start = null,
   DateTime? t_end = null,
   string? BillNo = null,
   string? container = null,
   string? platform = null)
{
   if (!t_start.HasValue || !t_end.HasValue)
   {
       return BadRequest("开始时间和结束时间不能为空");
   }

   // 调用删除方法
   var result = await _logger.DeleteLogByCondition(
       level, 
       t_start.Value, 
       t_end.Value, 
       BillNo, 
       container, 
       platform);

   return Ok(new 
   { 
       Success = result.Success, 
       AffectedCount = result.AffectedCount, 
       Message = result.Message 
   });
}

• YLogEntry实体类源码：

public class YlogEntry
{
    /// <summary>
    /// 日志ID（大写 UID 字符串）
    /// </summary>
    [BsonId]
    public string Uid { get; set; } = Guid.NewGuid().ToString("N").ToUpperInvariant();

    /// <summary>
    /// 日志级别：1-Info，2-Warn，3-Error，0 仅用于查询（全部）
    /// </summary>
    public int Level { get; set; }

    /// <summary>
    /// 日志时间（含日期）
    /// </summary>
    public DateTime LogTime { get; set; } = DateTime.Now;

    /// <summary>
    /// 日志内容（5000 字以内）
    /// </summary>
    public string Content { get; set; } = string.Empty;

    /// <summary>
    /// 业务平台（可空）
    /// </summary>
    public string? Platform { get; set; }

    /// <summary>
    /// 事件类别（可空）
    /// </summary>
    public string? EventCategory { get; set; }

    /// <summary>
    /// 单据号（可空）
    /// </summary>
    public string? BillNo { get; set; }

    /// <summary>
    /// 容器号（可空）
    /// </summary>
    public string? ContainerNo { get; set; }

    /// <summary>
    /// 方法名称（可空）
    /// </summary>
    public string? MethodName { get; set; }
}