Lobsters项目中JSON日志性能数据格式问题分析

问题背景

在Lobsters项目中，开发团队发现JSON日志输出中存在性能数据格式不规范的问题。具体表现为性能指标数据（如执行时间、内存分配等）在日志结构中出现了重复和不一致的情况。

问题现象

日志输出中出现了以下异常情况：

1. allocations和duration值同时出现在日志顶层和perf子哈希中
2. view和db时间指标在顶层和perf子哈希中重复出现
3. 时间值在perf子哈希中保留了过多小数位，未进行合理的四舍五入

技术分析

这个问题源于Lograge gem的内部实现机制。在ActionController的LogSubscriber中，allocations、durations、view和db等性能指标是核心选项，它们会作为事件的基本属性被自动记录。同时，当开发者尝试通过自定义配置将这些指标放入perf子哈希时，就导致了数据重复的问题。

从技术实现角度看：

• allocations和duration属于事件(event)本身的属性，而非事件负载(payload)的一部分
• 要正确获取这些值，需要使用event.allocations而非event.payload[:allocations]
• 时间值需要使用event.duration.to_f.round(2)进行格式化处理

解决方案

经过技术评估，最合理的解决方案是：

1. 完全移除perf子哈希结构
2. 将所有性能数据保留在日志顶层
3. 对时间值进行适当的四舍五入处理

这种方案的优势在于：

• 保持日志结构的简洁性
• 避免数据重复带来的混淆
• 减少不必要的处理逻辑
• 与其他日志条目保持一致的格式

实施建议

对于需要在项目中实现类似日志功能的开发者，建议：

1. 仔细阅读所使用日志框架的文档，了解其核心事件属性的处理方式
2. 避免对框架自动记录的数据进行重复处理
3. 对数值型日志数据进行适当的格式化处理
4. 保持日志结构的简单和一致

这个问题虽然看似简单，但它提醒我们在集成不同组件时需要充分理解它们的工作机制，避免因理解不足而导致的数据处理问题。