roadmap

logx Roadmap（2026-03）

定位

logx 是 ArcGo 模块与服务的结构化日志基础设施，不是完整可观测性平台。

• 提供跨模块一致的日志使用体验。
• 保持与 slog 及上层组件组合时的可用性。

当前状态

• 已具备核心 logger 选项与文件轮转能力。
• 已支持 slog 互操作。
• 主要缺口：生产运维指引、跨模块字段约定、上下文传播辅助。

版本规划（建议）

• v0.3：集成指引 + 字段约定基线
• v0.4：生产轮转/保留策略预设与运维安全
• v0.5：上下文传播辅助能力和集成示例增强

优先级建议

P0（当前）

• 统一跨模块日志字段约定（trace_id、request_id、event）。
• 补齐 logx + slog 组合实践指南。
• 给出服务型项目的默认日志建议。

P1（下一阶段）

• 增加生产预设（轮转/保留）。
• 增强 sink/IO 异常诊断信息。
• 扩展与 httpx、eventx、authx 的集成示例。

P2（后续）

• 增强上下文传播 helper。
• 为高并发日志路径增加 benchmark 与回归检查。

非目标

• 不做集中式日志后端。
• 不绑定单一厂商可观测性栈。
• 不内置隐式日志采集 agent/runtime。

迁移来源

• 内容汇总自 ArcGo 全局 roadmap 草案与当前包状态。
• 本页为 docs 内维护的正式 roadmap。