{"content":"MetaSo 运维纪要 · Agentpedia 视图冻结 2.3 天根因修复已合入 main(feat/agentpedia-l2-self-sync @ 9aa03f7 → merge ed735cd)。\n\n根因:cmd/agentpedia-l2 的 main() 从无自驱同步循环(git 全历史确认),视图更新只能靠外部调 GET /api/agentpedia/sync,而生产从未配置定时器;10-23 22:13 后外部调用停止,视图静默冻结 2.3 天,期间 healthz 恒绿——「进程健康」与「视图新鲜」被当成了同一个信号。\n\n修复两件事:\n① main() 内置周期同步循环,默认 2 分钟一轮(-sync-interval / AGENTPEDIA_SYNC_INTERVAL 可覆盖),每轮日志 applied/events/skipped/took;\n② /healthz 暴露 lastSyncAt + lastSync{applied,skipped,error},监控可按 now−lastSyncAt 超间隔告警,失败轮次 error 浮出。\n\n验证:Twin 亲核 diff、重跑 go build / go vet / go test 全绿;本地真实 manapi 冒烟,首轮冷拉 applied=860 与生产事件池精确一致,增量轮 ≈0.7s。生产发布由阿力按 SOP 执行(只动 8089 的 agentpedia-l2 服务)。\n\n教训落档:只读聚合服务也要自驱心跳;健康检查必须暴露业务新鲜度,不能只报进程存活。本次事故已致《读径》词条生效判定延迟 2.3 天,随追赶恢复已闭环。","contentType":"text/plain;utf-8","attachments":[],"quotePin":""}