mirror of
https://github.com/Rain-kl/OpenFlare.git
synced 2026-10-04 07:06:36 +08:00
docs: 核查并润色文档,对齐项目实际实现
- 删除未经验证的环境要求(Docker 版本号、浏览器条目)与括号废话 - 故障排查改为真实处理路径(升级→重新发布→强制同步→重建 Agent→提交 issue),删除仅开发时用的排障章节 - 删除设计文档中的测试与验收、实现检查清单、贡献者阅读建议等开发内容 - 修正与代码不符的事实:reset-passwd 命令名、证书续签窗口 7 天、Pages 检查间隔 1440 分钟、Relay vhost 端口 8080、SSO 仅支持 OIDC 等 - 去除口语化表述与无意义括号,改写「不是…而是…」句式 - 同步修正文档站链接锚点,构建验证通过
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# 日志存储解耦
|
||||
|
||||
你会学到:哪些表属于日志用途、为什么不能绑死 ClickHouse,以及新增一张日志表时必须走哪条代码路径。逐步落地步骤见 `.agents/skills/logstore/SKILL.md`。
|
||||
你会学到:哪些表属于日志用途、为什么不能绑死 ClickHouse,以及新增一张日志表时必须走哪条代码路径。
|
||||
|
||||
观测字段与上报协议仍以 [观测上报协议与表结构](./observability-data-model.md) 为准;本文只约定**存到哪、怎么切库**。
|
||||
|
||||
@@ -70,7 +70,7 @@ ClickHouse 上的小时级物化视图(如 `of_access_log_hourly`)只服务
|
||||
|
||||
## 5. 新增一张日志表
|
||||
|
||||
列名必须在 ClickHouse / PostgreSQL / SQLite 三套 goose 中一致。顺序与禁止项见 `logstore` skill。要点:
|
||||
列名必须在 ClickHouse / PostgreSQL / SQLite 三套 goose 迁移中一致。要点:
|
||||
|
||||
* 高频表:CH 用 `MergeTree` + `toYYYYMM`;PG 用 `PARTITION BY RANGE(时间列)`,主键含分区键;SQLite 普通表 + 索引。
|
||||
* ID 用 snowflake `uint64`,迁移时原样保留。
|
||||
@@ -83,7 +83,4 @@ ClickHouse 上的小时级物化视图(如 `of_access_log_hourly`)只服务
|
||||
|
||||
## 6. 相关文档
|
||||
|
||||
* 开发步骤:`.agents/skills/logstore/SKILL.md`
|
||||
* DDL:`.agents/skills/database-migration/SKILL.md`
|
||||
* 批量写入:`.agents/skills/clickhouse-batchwriter/SKILL.md`
|
||||
* 实现前设计稿(历史):[日志数据库解耦设计](../superpowers/specs/2026-08-08-log-database-decoupling-design.md)
|
||||
* 观测字段与上报协议:[观测上报协议与表结构](./observability-data-model.md)
|
||||
|
||||
Reference in New Issue
Block a user