Flynor 文档/运维
草案
日志、监控与告警
使用 executionId 和 traceId 关联入口、节点、工具、外部写入和结果。
统一事件
- 所有结构化事件使用 flynor/platform-event/v1。
- executionId 是业务执行主键;traceId 是一次技术调用链,二者不得混用。
- timestamp、level、component、event 与少量标量 attributes。
- 请求正文、PRD、提示词、源码、完整路径和凭据不得进入事件。
传播规则
- 测试链路从 Intake 到 Writeback 复用原 executionId。
- Robot Job 映射为 AI-ROBOT-<jobId>,入口、Worker 和外发日志使用同一编号。
- Tech Codex 本地诊断与 Server 聚合样本同时保存 executionId/traceId。
- Management Registry 的定义创建、发布、事件与审计复用同一对标识。
- 启动和轮询使用明确的 PROCESS 执行编号,不伪装成业务任务。
按执行查询
测试执行使用 /v1/test-executions/<executionId>;Tech 诊断管理员接口支持 executionId 过滤;Robot 与独立服务日志按精确 executionId 检索。验收必须串起入口、执行、证据、状态、外部写入和最终结果。
最小监控
- 可用性和 ready 状态。
- 队列长度、运行中任务和 lease 过期。
- 成功率、错误率、延迟和模型用量。
- 同步新鲜度、缓存完整性和外部写入失败。
日志安全
不记录 Token、密码、Cookie、完整请求响应、源码、PRD 正文和真实个人路径。错误只保留分类、阶段、脱敏摘要和必要计数。