
要点
运行记录至少要能说明哪项任务、用了哪个版本、在哪一步发生问题以及哪些动作已经完成。保留足够定位的状态和引用位置,同时限制敏感原文与凭据进入日志。记录应服务于诊断和责任交接。
从业务任务定位执行过程
为一次任务分配稳定标识,将触发时间、输入来源、流程版本和最终状态关联起来。业务同事提出问题时,维护人员可以找到对应执行,而不必在大量模型对话中猜测。
每个关键节点记录开始、完成或失败,以及耗时和错误类型。对外部动作还要保留目标记录标识,便于核查是否已经创建、发送或修改。
记录足够信息,避免复制全部资料
通常可以保存来源位置、必要字段和脱敏样例,不需要把所有客户资料或整份附件长期复制进日志。密钥和访问令牌应排除,日志查看和保留期限按企业实际要求设置。
为了复现问题需要保留原输入时,应明确存放位置与授权人员。调试记录也属于资料管理范围,不能因为名称叫“日志”就绕开原有访问要求。
让异常记录指向后续处理
区分输入不完整、模型返回异常、接口不可用与业务校验失败,给出适合使用者理解的说明。只有错误码而没有处理去向,会让员工反复提交同一任务。
维护人员应能筛选待处理事项,并记录修复、补做或取消。上线后的观察不仅是统计调用次数,还要知道未完成任务由谁承接、什么时候需要暂停相关流程。
从一条业务标识找到执行证据
记录流程版本、关键步骤状态、结果位置与处理人,用脱敏数据重现一次失败。日志不保存不必要的敏感原文与凭据,保留期限和读取人员由企业明确,调试功能可用性按实际环境核对。
参考来源
外部资料用于说明方法;具体功能、费用和许可条件以供应商现行说明及实际验证为准。
- n8n Docs|调试执行记录利用已有执行数据定位问题