cloud
2.0 KiB
2.0 KiB
name, description
| name | description |
|---|---|
| edge-technical-zeroing-report | edge_collector 技术归零与现场故障报告编写规范。用于边缘网关、协议采集、云平台、网络、4G/WiFi、内网穿透、端口转发、AI 分析、部署同步等故障需要形成正式根因报告、归零报告、事故复盘或客户交付说明时使用。 |
edge_collector 技术归零报告
目标
把现场故障从“现象描述”整理为证据闭环：
现象
-> 影响范围
-> 现场证据
-> 排查路径
-> 根因
-> 修复
-> 验证
-> 预防措施
适用故障
- 边缘服务异常、CPU/内存/磁盘异常。
- 云端设备离线、历史数据缺失、AI 接口失败。
- 协议采集失败、第三方库或跨架构运行问题。
- 4G/WiFi、frpc、端口转发等独立 agent 异常。
- 打包同步后运行异常、动态配置被覆盖。
报告结构
问题概述
影响范围
现场环境
现象与时间线
证据清单
排查过程
根因分析
修复措施
验证结果
预防措施
结论
证据要求
优先收集：
git log、git status、构建主机信息。journalctl、应用日志、浏览器 console、接口响应。systemctl status、进程、端口、CPU、内存、磁盘。- 配置文件差异，但注意隐藏密钥。
- 远程主机系统版本和架构。
根因表达
结论必须具体到可操作层级：
- 不写“网络问题”，要写是哪段链路、哪个接口、什么失败。
- 不写“部署问题”，要写是哪个脚本、哪个文件、哪个动态配置规则。
- 不写“兼容问题”，要写构建系统、库版本、架构或符号冲突证据。
归零判定
只有同时满足以下条件才写“已归零”：
- 根因有证据支撑。
- 修复已实施。
- 回归验证通过。
- 已说明预防同类问题的规则或检查项。
否则写“暂不具备归零条件”，并列出缺失证据。
文档落点
- 通用事故：
docs/ - 鲁班猫设备：
docs/鲁班猫*/ - 协议故障：
collector/docs/protocols/