执行日志
执行日志用于记录 OpenLink 集成流的每一次运行。在执行日志页面中,管理员可以查看触发结果、按 Trace ID 或业务数据搜索、按状态筛选、检查执行详情、打开相关本地记录,并通过载荷快照排查映射、目标执行、回调或脚本问题。
从选中的 OpenLink 进入 集成流配置,选择一个流程,再通过 查看执行日志 进入该页面。
日志列表
页面只展示当前流程的执行记录。
| 区域 | 说明 |
|---|---|
| 返回 | 返回 集成流配置 |
| 搜索日志 | 搜索日志 ID、Trace ID、业务数据、触发方式、状态、时间、耗时和相关记录标识 |
| 状态筛选 | 按全部结果、成功、失败、运行中或排队中筛选日志 |
| 刷新 | 重新加载当前日志列表 |
| 日志表格 | 展示执行记录,并提供详情和业务数据操作 |
| 分页 | 切换页码和调整每页数量 |
手动测试、Webhook 调用、轮询运行或推送事件触发后,可以通过日志列表确认流程是否按预期运行。
表格字段
| 字段 | 说明 |
|---|---|
| 日志 ID | 当前执行日志的唯一 ID |
| Trace ID | 用于串联一次流程执行链路的追踪标识 |
| 业务数据 | 当前处理记录的业务展示名称 |
| 触发方式 | 流程如何被触发,例如手动、Webhook、轮询或推送 |
| 状态 | 当前执行结果:排队中、运行中、成功或失败 |
| 开始时间 | 本次执行开始处理的时间 |
| 结束时间 | 本次执行结束处理的时间 |
| 耗时 | 本次执行耗时,单位为毫秒 |
| 操作 | 打开日志详情,或在可以识别本地记录时打开业务数据 |
如果日志中包含本地表单和本地记录信息,业务数据操作会在新标签页打开对应的 Soln 表单记录。
日志状态
| 状态 | 含义 |
|---|---|
| 排队中 | 执行已经被接收,但还未开始处理;对于使用“同记录顺序执行”的出站推送流程,它可能正在等待同一条记录的前一次执行 |
| 运行中 | 执行正在处理中 |
| 成功 | 执行已经正常完成 |
| 失败 | 执行结束时发生错误 |
排查问题时,可以先筛选失败日志;检查近期运行情况时,可以筛选运行中或排队中的日志。一条记录处于排队中不表示整个流程被阻塞,不同来源记录仍可并行。当使用同记录顺序执行时,前一次执行成功、失败、取消或重试耗尽后,系统会释放同一记录的下一次执行。
日志详情
通过表格操作可以打开日志详情抽屉。
详情抽屉分为基础信息、执行概览和执行详情。
| 区域 | 说明 |
|---|---|
| 基础信息 | 展示日志 ID、Trace ID、业务数据、触发方式、状态、开始时间、结束时间和耗时 |
| 执行概览 | 展示保存的流程图,以及本次执行记录的实际经过路径 |
| 执行详情 | 展示本地记录、错误信息和可用的 JSON 载荷快照 |
当日志包含足够的本地记录信息时,详情中的业务数据也可以打开对应的本地表单记录。
执行路径
执行概览会渲染当前日志附带的流程图快照,并高亮 executionPath 中记录的节点和连线,用于确认本次运行实际经过的分支路径。
| 显示 | 含义 |
|---|---|
| 高亮连线 | 本次执行经过了该连线;日志处于运行中时,高亮连线会显示动画 |
| 高亮节点 | 本次执行已经到达该节点,并展示当前执行的整体状态 |
| 未执行 | 该节点不在本次记录的路径中,例如分支中未选择的一侧 |
| 虚线连线 | 该连线存在于已保存流程图中,但本次执行未经过 |
排查时先通过路径定位最后到达的节点,并确认分支选择的是预期的命中或未命中路径;再查看下方载荷快照,检查来源数据、转换结果、目标输出、回调数据或运行上下文。
载荷快照
执行详情中可能展示多段 JSON 快照。只有存在数据的区块才会展示。
| 载荷区块 | 说明 |
|---|---|
| 错误详情 | 执行失败时的结构化错误信息 |
| 输入载荷 | 流程接收到的原始输入 |
| 转换结果 | 字段映射后生成的数据 |
| 子表结果 | 子表映射生成的结果 |
| 创建记录 | 目标创建 Soln 表单记录后的结果 |
| 脚本结果 | 目标调用 Studio 脚本后的执行结果 |
| 字段映射 | 本次执行实际应用的字段映射 |
| 原始输出 | 流程执行捕获到的完整输出载荷 |
| 上下文快照 | 本次执行中的运行上下文 |
每个 JSON 面板都可以复制。对比外部请求、OpenLink 外部字段、字段映射、目标动作或 Studio 脚本入参时,可以直接使用这些快照。
常见排查顺序
当流程没有得到预期结果时,可以按这个顺序检查日志:
- 确认列表中存在最新一次运行记录
- 检查状态筛选是否隐藏了目标记录
- 打开失败或结果异常的日志
- 确认触发方式和输入载荷是否符合本次测试请求或计划任务
- 检查字段映射数量、子表映射数量和转换结果
- 检查目标执行中的创建记录、匹配记录、脚本结果或错误信息
- 如果外部侧等待异步响应,检查回调状态
- 日志提供业务数据时,打开相关本地记录确认实际结果
- 回到流程设计画布调整节点或映射,发布后重新测试
推荐使用流程
测试或排查流程时,建议按这个顺序处理:
- 确认流程已经存在发布版本
- 触发方式需要启用流程时,先在 集成流配置 中启用流程
- 通过立即执行轮询、Webhook、轮询计划或推送事件运行流程
- 从流程列表进入 执行日志
- 刷新列表,并通过时间、Trace ID 或业务数据定位最新记录
- 打开详情抽屉,先查看执行路径
- 通过载荷快照判断问题出在来源数据、转换映射、目标执行还是回调投递
- 调整流程设计,重新发布并再次测试