CMMS 排障
当 CMMS 运营、多提供商汇聚、数据集成、附件同步或 AI Agent 工作流与客户预期不一致时,使用本指南。
排障流程
常见症状
| 症状 | 检查 |
|---|---|
| 工单缺失 | 来源记录、过滤器、提供商 ID、必填字段、拒绝行和同步时间。 |
| 工单重复 | 提供商 ID、来源工单 ID、重试行为、重复规则和导入窗口。 |
| 状态不一致 | 来源状态映射、同步方向、最近写回、冲突规则。 |
| 资产错误 | MDM 别名、退役资产、父子层级、Inspector 绑定。 |
| 用户看不到工单 | 角色、租户、站点、提供商、状态范围和权限。 |
| 附件缺失 | 文件大小、文件类型、ECM 权限、附件映射和同步日志。 |
| Agent 摘要缺少最新工作 | 数据新鲜度、工单过滤器、状态映射和权限范围。 |
诊断缺失工单
- 确认来源 CMMS 中存在该工单。
- 检查连接器同步时间和错误日志。
- 检查来源状态是否被过滤。
- 按来源工单 ID 和共享工单 ID 查询。
- 检查资产引用是否被拒绝或等待 steward 审阅。
预期输出
每次排障应留下:问题 ID、受影响工单、来源记录、检查步骤、修正动作、重跑结果、负责人和后续防范措施。
启用和运行专项排障
| 现象 | 检查 |
|---|---|
| CMMS 菜单不可见 | 租户目录中的 cmms 模块键、模块启用状态、导航白名单和用户角色。 |
| 概览返回 403 | 用户或服务账号是否具备 cmms.read,以及是否在正确租户内访问。 |
| 概览为空或 MTTR / MTBF 暂无数据 | 是否存在当前租户的工单、逾期计划、完成记录和故障标签。 |
| 技术员或班组无法分派 | 工单状态、工单操作权限、技术员或班组记录、服务商归属和同步错误。 |
| 到期计划未生成工单 | 计划到期日、计划状态、生成配置和同一窗口是否已有生成记录。 |
| 备件扣减失败 | 备件主数据、库存位置、可用数量、交易权限和库存事务日志。 |
| AI Agent 无法调用 CMMS 工具 | 模块启用、cmms.read、写入动作权限、服务账号范围和审阅门。 |