本文介绍如何使用流程运行日志功能,帮助技术人员查看流程执行状态、定位错误节点并快速排查问题。
流程运行日志记录了连接流每次执行的完整信息,包括各节点的执行状态、请求响应数据和错误详情。通过日志列表的筛选搜索和详情页的错误定位能力,帮助技术人员高效排查流程执行问题。核心能力:支持按时间、流程和执行状态筛选日志,查看节点请求、返回和错误详情,并从错误列表定位失败节点。
准备工作#
日志列表页#
查看日志列表#
| 筛选条件 | 说明 |
|---|
| 时间范围 | 选择日志的起止时间 |
| 流程名称 | 下拉搜索选择具体流程 |
| 执行状态 | 按成功/失败状态过滤 |
流程版本#
运行日志为每条执行记录标注本次执行使用的流程版本(例如 v3),用于复盘对齐「那次跑的是哪一版」。| 位置 | 说明 |
|---|
| 日志列表 | 每条执行记录展示流程版本字段 |
| 执行详情 | 详情中可查看本次执行所用版本 |
该字段固定为执行当时使用的版本。之后发布新版本或回滚历史版本,都不会改写既有日志中的版本号。
手动运行、事件触发与定时调度三个入口统一执行当前生效版本,因此同一时间段的记录通常指向同一版本;发布或回滚之后产生的记录会指向新的生效版本。如果连接流从未发布却被触发,该次执行判定为失败,并在日志中明确提示,不会静默按草稿内容运行。日志详情页#
在日志列表中,点击目标日志条目的「详情按钮」,打开抽屉页面查看执行详情。抽屉页面分为左右分栏:左侧「节点信息」展示节点列表,右侧「运行详情」展示选中节点的详细数据。查看基础日志详情#
1
步骤 1:打开日志详情
在流程运行日志列表中,点击目标日志条目的「详情按钮」。
2
步骤 2:查看执行概览
在抽屉页面顶部,查看流程名称、状态图标和执行时间。
3
步骤 3:查看节点信息
在左侧「节点信息」区域,查看每个节点的序号、名称和运行状态(成功、失败、跳过)。
说明:节点名称优先显示备注名称,无备注则显示节点原始名称。
4
步骤 4:查看节点运行详情
点击左侧任一节点,在右侧「运行详情」区域查看该节点的名称、备注、请求数据 JSON 和返回数据 JSON。
错误列表与一键定位#
当流程执行存在错误时,详情页顶部会显示「错误列表 (N)」按钮,N 为错误节点数量。1
步骤 1:打开错误列表
点击详情页顶部的「错误列表 (N)」按钮,右侧展开错误列表面板。
2
步骤 2:查看错误信息
每个错误项展示以下内容:
| 信息项 | 说明 |
|---|
| 错误路径 | 从根节点到错误节点的完整路径 |
| 节点名称 | 发生错误的节点名称 |
| 错误信息 | 错误描述或错误码 |
说明:错误列表仅收集真正发生错误的叶子节点,不包含因子节点失败而被传播标记为失败的父节点。
3
步骤 3:一键跳转定位
点击错误列表中的任一错误项,系统自动完成以下操作:
节点状态筛选#
详情页支持按节点执行状态快速过滤,便于在大量节点中定位目标。| 筛选选项 | 显示内容 |
|---|
| 全部状态 | 当前层级所有节点 |
| 成功 | 当前层级 status = success 的节点 |
| 失败 | 当前层级 status = failed 的节点(包含因子节点失败而被传播标记的父节点) |
说明:筛选基于状态传播后的结果。当用户进行层级下钻或返回操作时,筛选状态会自动重置为「全部状态」。
错误计数角标#
嵌套节点(循环、条件分支、Switch 等)的左侧卡片会显示错误计数角标,标识该节点内部的错误数量。计数规则:角标数量 = 该节点内部真实发生错误的叶子节点数量(递归统计所有子层级),不包含因子节点失败而被传播标记为失败的 中间父节点。
循环执行节点下钻后,看到 3 次循环,其中第 2 次循环失败
第 2 次循环的角标数量 = 该次迭代内部真实失败的叶子节点数量
不是循环执行整体的错误数,而是该次迭代内部的错误数
查看条件分支节点详情#
1
步骤 1:进入条件分支
在节点信息列表中,找到条件分支节点(以父节点形式展示),点击进入子页面。
2
步骤 2:查看分支执行情况
查看分支结果子节点(序号如 x.1、x.2),每个分支显示「符合条件」或「不符合条件」,以及对应的执行状态。
说明:未执行的分支显示灰色「未执行(条件不满足)」状态。已执行且内部存在失败节点的分支会显示红色错误标识和错误计数角标。
3
步骤 3:查看分支子节点详情
若分支结果下有子节点,点击展开按钮查看该分支的子节点列表,点击任一子节点在右侧查看运行详情。
查看循环节点详情#
1
步骤 1:进入循环概览
在节点信息列表中,找到循环节点(显示子节点数量标签),点击进入「循环概览页面」。
2
步骤 2:按状态过滤循环
在循环概览页面,通过 Tab 分栏(全部、成功、失败、警告)过滤循环列表,快速找到目标循环。
说明:循环节点状态根据所有循环结果确定——全部成功为成功,混合为警告,全失败为失败。失败的循环会显示错误计数角标。
3
步骤 3:查看循环详情
点击「查看详情」按钮,跳转至二级页面。左侧显示该循环的节点列表,第一个节点为「当前遍历详情」,展示入参和出参。
4
步骤 4:层级导航
使用顶部面包屑(如「循环节点备注名称 > 第x次循环」)定位当前层级
说明:多层级嵌套支持深度导航;若嵌套超过 4 层,从第 5 层开始平铺展示。
MCP 网关日志边界(6.7.1)#
本文前述列表、节点详情和错误定位能力适用于普通连接流日志。对于 MCP 网关工具调用,6.7.1 中即使客户端已经收到成功响应,流程运行日志仍可能长时间停留在 进行中。客户端收到的 JSON-RPC 响应和 HTTP 状态;
MCP Tool、动作节点和 MCP 返回变量节点的测试结果;
不要把 MCP 运行日志的“进行中”状态单独解释为调用尚未完 成,也不要仅凭客户端成功响应忽略后台执行异常。当前版本需要组合证据判断;日志状态问题修复并复验后再按实际结果更新本文。
验证结果#
1.
日志列表中的每条执行记录都能看到流程版本字段,并读出具体版本号。
2.
打开任一执行详情后,可以定位到失败节点并查看其请求数据与返回数据。
3.
发布并产生新记录后,新记录的流程版本为发布后的生效版本。
4.
回滚到历史版本并再次产生运行记录后,既有日志中的版本号未被改写。
常见问题#
批量重试#
当前流程日志页支持对符合条件的失败记录执行批量重试,单次选择范围为 2–50 条。1
筛选失败记录
按时间、流程和执行状态缩小范围,确认所选记录来自可以安全重试的同一业务场景。
2
选择 2–50 条记录
勾选需要重试的失败记录。少于 2 条可使用单条重试,超过 50 条应拆分批次。
3
确认副作用
对创建、更新、发送通知或调用外部系统的流程,先确认幂等性和重复执行风 险。
4
执行并回读
发起批量重试后重新查询日志,逐条确认新执行结果,不能只以操作提示作为成功证明。
当前前端未展示报文关键字搜索输入,因此本文不再把“按请求或响应内容搜索”作为可用功能。后续如正式页面重新提供该入口,应以目标租户实际发布结果补充。