执行日志
1. 简介
1.1 功能简介
执行日志是 智能助手Pro 执行的记录明细,能够帮助用户概览整体执行情况,并精准追踪每个节点的执行细节。
1.2 应用场景
- 追踪与调试:可以通过日志精准追踪工作流的执行路径,为工作流设计提供优化方向;
- 错误反馈与处理:工作流执行出现错误、异常或中断时,可以通过日志快速定位问题节点,并可手动重试;
- 日志分析:通过深入分析不同工作流的执行情况,可以及时发现潜在问题,并及时采取相应的优化措施;
- 安全审计:执行日志可靠、可追溯,且记录了触发人、触发时间、触发动作等关键信息,满足合规性要求。
2. 执行日志入口
可以从以下两个入口进入执行日志:
1)单个表单的智能助手:「表单编辑 >> 扩展功能 >> 智能助手 >> 查看执行日志 」。
2)所有智能助手:「应用后台 >> 智能助手 >> 单个智能助手Pro >> 查看执行日志」。
3. 执行日志筛选
执行日志可以按照以下筛选条件查询数据:
- 触发时间:触发时间的区间,时间精确到秒;
- 执行结果:进行中/成功/失败;
- 触发人:全选/匿名用户/具体成员;
未设置筛选条件时将自动显示所有执行日志,可单独设置一或多个筛选条件,设置完成后点击「筛选」。
4. 执行日志内容
4.1 触发时间
触发时间即触发该「智能助手Pro」执行的时间。
4.2 触发人
触发人即触发「智能助手Pro」执行的成员昵称。其中:
4.3 触发动作
不同的触发方式以及触发节点配置,在执行日志中展示的触发动作内容不同,具体如下:
触发方式 | 触发动作 | 展示内容 |
新增数据时 修改数据时 删除数据时 流程结束时 | 触发动作类型、触发表单名称、对应的数据标题 | |
节点流转时 | 触发动作类型、触发表单名称、对应数据标题和流程节点名称 | |
自定义时间 | 定时单次/定时重复 | |
根据表单日期时间字段 | 定时单次/定时重复、触发表单名称、对应的数据标题 | |
HTTP触发 | HTTP触发 | |
点击按钮 | 点击「按钮名称」、触发表单名称、对应的数据标题 |
对于拥有表单查看权限的成员,点击数据标题可以查看单条数据详情:
4.5 执行结果
执行结果中展示的内容为:
1)进行中、执行成功时:仅展示如下类型节点的执行结果(最多展示 5 个):
- 新增/修改/删除数据节点:执行动作、目标表单名称、成功执行的条数;
- 插件节点:执行动作、插件名称;
- 计算节点:执行动作、公式计算结果;
2)执行失败时:执行失败的原因。
4.6 节点执行详情
4.6.1 查看所有节点的执行情况
查看「智能助手Pro」的执行结果后,可点击「查看详情」进入节点执行详情页,进一步查看所有节点的执行情况。具体展示内容如下所示:
- 智能助手Pro 的执行结果,包括:成功、失败、进行中;
- 执行的设计版本信息:版本号、版本状态(为历史/最新版本),并可悬停查看版本的发布时间和发布人;
- 所有节点的执行情况:以设计画布形式呈现,提供预览信息并通过颜色进行直观区分,包括如下四类:
- 绿色:为执行成功的节点,显示执行结果;
- 红色:为执行失败的节点,显示失败原因;
- 蓝色:为正在执行的节点;
- 灰色:为不执行的节点。
如需查看当前执行版本的具体配置,可点击版本号进入新页面内查看「智能助手Pro」配置以及 智能助手属性,但不支持在该页面内调整配置。如下图所示:
注:日志中展示的版本信息为执行时的版本配置,不一定为当前最新设计版本。
4.6.2 查看单个节点的执行情况
选中单个节点,即可进入节点执行日志查看具体信息。节点的执行结果不同,可查看的信息也不同,具体如下:
- 绿色(执行成功):支持查看节点配置、执行时间、执行结果;
- 红色(执行失败):支持查看节点配置、进行重试、执行时间、失败原因和修改建议;
- 灰色(不执行):不支持查看节点执行日志。
如需查看节点配置,可点击「查看节点配置」进入新页面内查看该节点的具体配置,但不支持在该页面内调整配置。如下图所示:
4.6.3 手动重试
通过本文 4.6.2 节定位到失败原因后,需要根据不同的原因类型,采取不同的处理措施:
- 非「智能助手Pro」配置有误,无需调整配置。可直接在执行日志中进行手动重试;
- 为「智能助手Pro」配置问题,需调整配置。则在修改配置后,使其按照新设计版本执行即可。
注:若在执行失败后进行了不同的调整操作,则重试执行逻辑也不同。具体如下:
1)调整了触发数据以外的数据,重试时,后续执行节点将按照最新数据执行;
2)调整了「智能助手Pro」配置,则不会按照最新设计重试,而是按照当前日志所对应的版本重试。
手动重试步骤如下:
1)对于支持重试的节点,会在对应节点执行日志中显示「重试」按钮,点击即可重新执行该节点。
2)重试后,会根据不同的重试结果,在日志中显示不同内容。具体如下:
- 若重试失败,则会更新失败节点的执行信息,并在「执行失败记录」中新增一条记录,展示失败时间和失败原因。如下图所示:
- 若重试成功,则会显示重新执行的结果,并更新原失败节点在重试后的执行状态和日志明细。如下图所示:
注:重试失败后,仍会显示「重试」按钮,可继续重试。
5. 执行失败消息提醒
5.1 设置入口
可以在「消息管理 >> 通知设置 >> 系统日志 >> 智能助手执行失败」处设置执行失败的消息提醒:
5.2 提醒方式
支持的提醒方式为:系统消息、邮件提醒以及短信提醒,具体区别如下:
提醒方式 | 如何查看消息提醒 | 是否默认勾选 | 提醒对象 |
系统消息 | 简道云「消息管理 >> 系统日志」中查看 | 是 | 默认选中账号创建者和系统管理员,不可设置其他提醒对象 |
邮件提醒 | 邮件查看 | 否 | 默认选中账号创建者,可设置其他提醒对象 |
短信提醒 | 短信查看 | 否 | 默认选中账号创建者,可设置其他提醒对象 |
5.3 设置提醒对象
对于邮件和短信的提醒方式,可以单独设置提醒对象。点击「设置提醒对象」进入设置页面,勾选对应的提醒对象即可,或者在左下角添加新的提醒对象,设置完成点击「确定」。
注:提醒方式为邮箱或短信提醒时,除账号创建者之外,提醒对象最多设置 5 人。
6. 注意事项
1)仅保留最近 6 个月的执行日志。
2)由于免费版账号没有数据回收站,当触发动作为删除数据时,执行失败的所有情况均不支持重新执行;
3)当执行失败原因为「当前表单正在执行其它批量编辑任务」时,会自动重试 5 次。5 次重试后,会在执行日志中展示最终执行结果(重试期间,「智能助手Pro」的执行状态为「重试中」)