Wima.Log 1.8.2

Wima.Log

A lightweight, independent logger for .NET that provides multi-target logging with Common.Logging and Microsoft.Extensions.Logging compatibility, plus built-in ElasticSearch connectivity.

一款轻量级独立 .NET 日志库，兼容 Common.Logging 和 Microsoft.Extensions.Logging，内置 ElasticSearch 连接支持。

Features / 功能特性

• Multi-target: net10.0 + netstandard2.0
• Dual interface: Implements both Common.Logging.ILog and Microsoft.Extensions.Logging.ILogger
• Log modes: Console, Native file, ElasticSearch, CommonLog bridge
• Buffered ES indexing: Batch writes to ElasticSearch with configurable buffer
• Log rotation: Auto-renew log files by hour with configurable retention
• DI integration: builder.Services.AddWimaLogger() for ASP.NET / Generic Host
• AOT compatible: Trim-safe, AOT-compatible on .NET 10

Installation / 安装

dotnet add package Wima.Log --version 1.8.2.0

Quick Start / 快速开始

using Wima.Log;

// Basic usage / 基本用法
var logger = new WimaLogger("MyApp", logMode: LogMode.Console | LogMode.Native);
logger.Info("Hello Wima.Log!");

// Log with exception / 带异常日志
try { /* ... */ }
catch (Exception ex) { logger.Error("Something failed", ex); }

Log Modes / 日志模式

LogMode.None          // No output / 无输出
LogMode.Console       // Console output / 控制台输出
LogMode.Native        // File output / 文件输出
LogMode.ElasticSearch // ES output / ES 输出
LogMode.CommonLog     // Bridge to Common.Logging / 桥接到 Common.Logging
LogMode.Verbose       // Verbose output / 详细输出
LogMode.StackTrace    // Stack trace on error / 错误时输出堆栈

// Combine modes / 组合模式
LogMode.Console | LogMode.Native | LogMode.ElasticSearch

DI Integration / 依赖注入

// ASP.NET Core / Generic Host
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddWimaLogger();

// With configuration / 带配置
builder.Services.AddWimaLogger(cfg =>
{
    cfg.LogLevel = Common.Logging.LogLevel.Info;
    cfg.LogMode = LogMode.Console | LogMode.Native;
});

ElasticSearch / ES 输出

// Initialize ES service / 初始化 ES 服务
WimaLogger.InitESService("http://localhost:9200", "my-index-prefix");

// Logs will auto-index to ES when ElasticSearch mode is enabled
// 启用 ElasticSearch 模式后日志将自动索引到 ES

Log Levels / 日志级别

License / 许可证

MIT License