基于ASP.NET Web API通过Serilog将Unity日志转发至Elasticsearch

1. Unity用Serilog.Sinks.Http + Web API用Serilog.Sinks.Elasticsearch是否可行？ #

完全可行，这是一套成熟的跨端日志转发方案：

• Unity端：Serilog.Sinks.Http会将结构化日志序列化为JSON，通过HTTP POST请求发送到你的Web API接口，适配Unity的网络环境，只要配置好目标API地址、请求超时、重试策略即可。需要注意选择与Unity所用.NET版本兼容的Serilog包（比如Unity 2022+可选用.NET Standard 2.1版本的包），同时可以搭配Serilog.Sinks.File做本地缓存，避免离线时丢失日志。
• Web API端：收到JSON日志后，通过Serilog.Sinks.Elasticsearch直接转发至Elasticsearch，该sink会自动处理日志的批量发送、索引管理、错误重试等逻辑，无需手动对接ES的底层API。

2. 直接发送日志而非借助日志组件是否可行？Serilog.Sinks.Elasticsearch的专属特性？ #

直接发送的可行性 #

完全可行：Unity端手动构造包含所有自定义字段的JSON对象，POST到Web API；API端再将JSON原封不动转发至ES的_index或_bulk接口。但这种方式需要自己实现日志结构化、批量发送、错误重试、索引分片管理等功能，开发和维护成本较高，且容易出现日志丢失、性能瓶颈等问题。

Serilog.Sinks.Elasticsearch的专属特性 #

• 自动索引管理：支持按日期自动创建索引（如unity-logs-2024.05.20），并自动生成适配的索引模板，简化ES的运维工作。
• 批量优化：自动将多条日志打包发送，减少ES的请求次数，提升整体性能。
• 动态字段支持：无需提前定义ES的mapping，自动适配日志中的自定义字段，满足灵活字段的需求。
• 日志级别映射：自动将Serilog的日志级别（Debug/Info/Warn/Error等）映射到ES的标准字段，便于后续筛选分析。
• 容错机制：内置重试逻辑与死信队列，发送失败时会自动重试，无法重试的日志可存入死信队列避免丢失。
• 上下文关联：支持传递CorrelationId等上下文信息，便于追踪跨服务的日志链路。

最优方案推荐（支持灵活字段，无需服务端DTO） #

推荐采用Unity Serilog.Http + Web API Serilog.Elasticsearch的组合，同时优化API端的接收逻辑以支持动态字段：

Unity端配置 #

使用Serilog构建结构化日志，自定义字段直接通过Log.Information的属性参数传入，无需手动构造JSON：

// Unity端Serilog配置
Log.Logger = new LoggerConfiguration()
    .MinimumLevel.Information()
    .Enrich.FromLogContext()
    .WriteTo.File("local-logs.txt", rollingInterval: RollingInterval.Day) // 本地缓存
    .WriteTo.Http("http://your-api-domain/logs", batchPostingLimit: 100) // 发送到API
    .CreateLogger();

// 输出带自定义字段的日志
Log.Information("Player {PlayerId} completed level {LevelName} in {Duration}s", 
    playerId, levelName, duration);

Web API端配置 #

无需定义DTO，直接接收动态JSON对象，转发给Serilog处理：

// ASP.NET Core API 接收接口
[HttpPost("logs")]
public async Task<IActionResult> ReceiveLogs([FromBody] IEnumerable<JObject> logs)
{
    foreach (var logObj in logs)
    {
        var level = Enum.Parse<LogEventLevel>(logObj["Level"].ToString());
        var messageTemplate = logObj["MessageTemplate"].ToString();
        var properties = logObj["Properties"].ToObject<Dictionary<string, object>>();
        
        Log.Write(level, messageTemplate, properties);
    }
    return Ok();
}

// Web API端Serilog配置（指向ES）
Log.Logger = new LoggerConfiguration()
    .MinimumLevel.Information()
    .WriteTo.Elasticsearch(new ElasticsearchSinkOptions(new Uri("http://your-es-domain:9200"))
    {
        AutoRegisterTemplate = true,
        IndexFormat = "unity-logs-{0:yyyy.MM.dd}",
        BatchPostingLimit = 500,
        Period = TimeSpan.FromSeconds(10)
    })
    .CreateLogger();

核心优势 #

• 全程无需定义固定DTO，Unity端的任意自定义字段都会被自动序列化并转发到ES。
• 利用Serilog的生态完成日志的缓存、批量、重试等核心功能，稳定性与可维护性更高。
• ES端自动生成索引与映射，后续可直接通过Kibana进行日志分析与可视化。

内容的提问来源于stack exchange，提问作者Viacheslav Rud'