本文介绍如何使用流程运行日志功能,帮助技术人员查看流程执行状态、定位错误节点并快速排查问题。
流程运行日志记录了连接流每次执行的完整信息,包括各节点的执行状态、请求响应数据和错误详情。通过日志列表的筛选搜索和详情页的错误定位能力,帮助技术人员高效排查流程执行问题。核心能力:支持报文关键字搜索、错误状态自动传播、错误列表一键跳转定位,即使面对多层嵌套的复杂流程也能快速找到错误根因。
前提条件#
日志列表页#
查看日志列表#
| 筛选条件 | 说明 |
|---|
| 时间范围 | 选择日志的起止时间 |
| 流程名称 | 下拉搜索选择具体流程 |
| 执行状态 | 按成功/失败状态过滤 |
| 日志内容 | 按报文关键字搜索(需满足前置条件) |
报文关键字搜索#
支持在请求/响应报文中搜索关键字,快速定位包含特定数据的日志记录。1
步骤 1:满足搜索前置条件
报文关键字搜索需同时满足以下两个条件:
| 条件 | 要求 |
|---|
| 时间范围 | 缩小至单日(≤1 天)以内 |
| 流程名称 | 已选择具体某一条流程 |
| 未满足情况 | 提示内容 |
|---|
| 时间和流程均未选择 | 使用报文搜索前,请先选择具体流程,并将时间范围缩小至单日内 |
| 已选时间,未选流程 | 请先选择具体流程后再进行报文搜索 |
| 已选流程,时间超范围 | 报文搜索仅支持单日时间范围,请缩小查询范围 |
2
步骤 2:输入关键字并搜索
在「日志内容」搜索框中输入目标关键字,点击查询。
说明:搜索会递归扫描流程日志中所有节点(包括深层嵌套节点)的请求数据和响应数据,区分大小写,支持模糊匹配(包含即命中)。
日志详情页#
在日志列表中,点击目标日志条目的「详情按钮」, 打开抽屉页面查看执行详情。抽屉页面分为左右分栏:左侧「节点信息」展示节点列表,右侧「运行详情」展示选中节点的详细数据。查看基础日志详情#
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 层开始平铺展示。
常见问题#