Longcher.Logging 1.2.3

Longcher.Logging

龙旗统一日志组件 - 基于 Serilog 的多目标日志框架

功能特性

• 多输出目标：控制台、文件、Elasticsearch、飞书告警
• log4net 桥接器：无需修改现有 log4net 业务代码，自动转发到 Serilog 管道
• 结构化日志：支持 JSON 格式，便于 ELK 分析
• 高性能：批量写入 ES，异步队列缓冲
• 零侵入：现有代码无需改动

安装

Install-Package Longcher.Logging

快速开始

方式一：直接使用 LogWriter

using Longcher.Logging;
using Longcher.Logging.Extensions;

// 初始化（Global.asax.cs 或 Program.cs）
var logWriter = ServiceCollectionExtensions.AddLongcherLogging();

// 写日志
logWriter.Info("用户登录成功", source: "Login", properties: new { UserId = "U001" });
logWriter.Error("数据库连接失败", ex: exception, source: "Database");

// 应用退出时释放
((IDisposable)logWriter).Dispose();

方式二：log4net 桥接（推荐现有项目使用）

只需两步，无需修改业务代码：

1. 创建 appsettings.json

{
  "LogPlatform": {
    "Application": "YourApp",
    "EnvTag": "prod",
    "FactoryCode": "Factory01"
  },
  "ConsoleLogging": { "Enabled": false },
  "FileLogging": {
    "Enabled": true,
    "Path": "Logs/log-.txt",
    "RollingInterval": "Day"
  },
  "Elasticsearch": {
    "Enabled": true,
    "NodeUris": "http://your-es-host:9200",
    "IndexFormat": "your-app-logs-{0:yyyy.MM.dd}",
    "EnableAuthentication": true,
    "Username": "elastic",
    "Password": "your_password"
  },
  "Feishu": {
    "Enabled": false,
    "WebhookUrl": "https://open.feishu.cn/open-apis/bot/v2/hook/xxx",
    "AlertLevels": ["Error", "Fatal"]
  }
}

2. 修改 log4net.config

<log4net>
  
  <appender name="ErrorLog" type="log4net.Appender.RollingFileAppender">
    
  </appender>

  
  <appender name="LongcherBridge" type="Longcher.Logging.Bridge.Log4NetBridgeAppender, Longcher.Logging" />

  <root>
    <level value="DEBUG" />
    <appender-ref ref="ErrorLog" />
    <appender-ref ref="LongcherBridge" />
  </root>
</log4net>

3. 初始化日志（Global.asax.cs）

protected void Application_Start()
{
    // 初始化 Longcher.Logging
    var logWriter = ServiceCollectionExtensions.AddLongcherLogging();

    // 初始化 log4net（桥接器自动生效）
    var log4netConfig = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "log4net.config");
    log4net.Config.DOMConfigurator.Configure(new FileInfo(log4netConfig));
}

日志输出格式

Elasticsearch 字段说明

配置说明

LogPlatform

Elasticsearch

Feishu（飞书告警）

系统要求

• .NET Framework 4.5.2+
• log4net 1.2.0+（桥接模式）

依赖项

• Serilog 2.12.0
• Serilog.Sinks.Console 4.1.0
• Serilog.Sinks.File 5.0.0
• Elasticsearch.Net 7.17.5
• NEST 7.17.5
• Newtonsoft.Json 13.0.3

许可证

MIT License - 龙旗科技 © 2026