# 工作流出了问题，运行记录应该留下哪些信息？

用任务状态、版本和关键节点帮助定位问题，同时控制日志中的敏感内容。

要点：运行记录至少要能说明哪项任务、用了哪个版本、在哪一步发生问题以及哪些动作已经完成。保留足够定位的状态和引用位置，同时限制敏感原文与凭据进入日志。记录应服务于诊断和责任交接。

![同事在独立资料夹之间核对任务与接手信息（AI概念配图）](/images/guides/scenes/v152-enterprise-portal.jpg)

## 从业务任务定位执行过程

为一次任务分配稳定标识，将触发时间、输入来源、流程版本和最终状态关联起来。业务同事提出问题时，维护人员可以找到对应执行，而不必在大量模型对话中猜测。

每个关键节点记录开始、完成或失败，以及耗时和错误类型。对外部动作还要保留目标记录标识，便于核查是否已经创建、发送或修改。

## 记录足够信息，避免复制全部资料

通常可以保存来源位置、必要字段和脱敏样例，不需要把所有客户资料或整份附件长期复制进日志。密钥和访问令牌应排除，日志查看和保留期限按企业实际要求设置。

为了复现问题需要保留原输入时，应明确存放位置与授权人员。调试记录也属于资料管理范围，不能因为名称叫“日志”就绕开原有访问要求。

## 让异常记录指向后续处理

区分输入不完整、模型返回异常、接口不可用与业务校验失败，给出适合使用者理解的说明。只有错误码而没有处理去向，会让员工反复提交同一任务。

维护人员应能筛选待处理事项，并记录修复、补做或取消。上线后的观察不仅是统计调用次数，还要知道未完成任务由谁承接、什么时候需要暂停相关流程。

## 从一条业务标识找到执行证据

记录流程版本、关键步骤状态、结果位置与处理人，用脱敏数据重现一次失败。日志不保存不必要的敏感原文与凭据，保留期限和读取人员由企业明确，调试功能可用性按实际环境核对。

## 参考来源

- [n8n Docs｜调试执行记录](https://docs.n8n.io/build/understand-workflows/understand-executions/debug-executions)：利用已有执行数据定位问题

## 运行记录回答三个问题

- 哪一项：任务标识、输入来源、版本

- 哪一步：状态、耗时与错误类型

- 谁处理：待办、负责人和恢复结果

![运行记录回答三个问题](/images/guides/diagrams/workflow-observability.svg)

## 继续阅读

- [AI 应用上线后，谁来更新资料、处理失败和维护？](/guides/ai-operating-routine)

- [AI 工作流失败后怎样重试，才能避免重复处理？](/guides/workflow-retries)

- [智能体和工作流怎么测试？把失败样例保留下来](/guides/workflow-evaluation)

围绕当前问题查看任务、资料与人工确认示例，再用企业样例验证。

下一步：[按业务环节查看沙盘](/library)

原文：/guides/workflow-observability

内容版本：guide:workflow-observability:v1

<!-- version:guide:workflow-observability:v1 -->

[结合企业情况咨询](/intake?source=%2Fguides%2Fworkflow-observability&articleId=guide%3Aworkflow-observability&versionId=guide%3Aworkflow-observability%3Av1)