Skip to content

流程监控与分析 ​

页面入口为 工作流引擎 → 运维与集成 → 流程监控,包含六个页签:实例监控、任务监控、数据分析、引擎诊断、作业账本、补偿工单。实例监控解释单次申请,任务监控查看跨实例任务,数据分析汇总效率与负载;后台执行和健康恢复各有独立说明。

页签 / 入口说明
实例监控实例查询、详情、执行路径诊断与管理员干预
任务监控跨实例任务筛选、状态 / 时长 / 意见与催办,详情打开关联实例
数据分析实例趋势、节点瓶颈、处理人负载与超时预警
引擎诊断、健康与运行配置组件与队列内省、健康趋势、定向恢复;另含独立健康巡检入口
作业账本自动执行、逐次尝试、排队状态、失败聚类与重放
补偿工单反向 / 兜底动作和人工修复过程

流程监控(实例监控) ​

工作流引擎 → 运维与集成 → 流程监控 → 实例监控 提供实例维度的查询和处置能力:

能力说明
实例列表按流程、状态、发起人、时间等维度查询,支持保存视图快速切换筛选组合
实例导出按当前筛选导出实例列表(单次封顶 10000 行)
流程详情查看实例基础信息、表单数据、当前节点和任务
运行时诊断汇总节点、任务、触发器、事件派发、执行 Token、定义快照
强制跳转将实例推进到指定节点(原因必填 + 终止任务清单,见下文)
改派处理人调整待办任务处理人;目标用户已在同节点持有待办时返回 409
批量推进卡死实例对卡住实例的活动 Token 执行批量跳过并推进(原因必填)
诊断包导出导出实例运行快照,便于工单留档和离线分析

强制干预留痕 ​

强制跳转与批量恢复属于改写执行位置的高危动作,统一要求留痕:

  • 强制跳转:确认框展示将被终止的活动任务清单(任务号、节点、处理人、状态),跳转原因必填(服务端 schema 同步强制);执行后被终止任务标记 skipped 并写入 [管理员强制跳转至「目标节点」] + 原因 备注,原因同时进入操作审计。
  • 批量推进卡死实例:按定义、节点和卡住时长圈定实例,恢复原因必填,逐实例跳过活动 Token 并推进,单个失败不影响其它。

运行时诊断 ​

运行时诊断抽屉包含这些视图:

视图内容
引擎轨迹实例相关的引擎事件和作业链路
节点流程图节点状态、当前节点、异常节点
任务全量任务、处理人、动作、耗时和状态(抄送任务显示「已抄送」)
触发器节点触发器派发状态、请求、响应和错误
事件派发事件投递状态、订阅命中和错误
执行 Token并行、包容、子流程等待等执行路径状态
流程图按运行状态渲染的流程定义快照
表单数据实例运行时表单数据
定义快照本轮提交时冻结的流程定义

诊断结论内置双向 Token 一致性校验:

规则级别说明
运行中实例没有活动任务criticalrunning 但无 pending/waiting 任务,推进中断或状态未回写
运行中实例无活动执行 Tokencriticalrunning 但没有任何 active Token,执行路径中断
活动任务缺少执行 Token(Task→Token)critical节点存在待处理任务但没有 active Token,任务提交必然失败,需用「强制跳转」重置执行位置
Token 与任务不一致(Token→Task)warning节点存在 active Token 但无活动任务,可能状态漂移(parked join Token 除外)
等待任务无法被唤醒(疑似死锁)critical仅剩 waiting 任务且不存在外部回调、触发器、子流程或同节点 pending 等任何唤醒来源
外部审批分派失败 / 触发器执行失败critical对应作业 failed/dead
事件派发失败 / 待处理critical / warningoutbox 作业异常或积压

数据分析 ​

工作流引擎 → 运维与集成 → 流程监控 → 数据分析 提供流程效率与负载的聚合视图,可按流程定义过滤:

板块内容
总量指标各状态实例计数、已完结实例平均耗时、当前挂起任务数、近 7 天发起数
发起 / 完结趋势近 14 天按日的发起与完结曲线
流程定义排行实例量 Top 定义的运行中/通过/驳回分布与平均耗时
节点瓶颈人工节点的平均处理时长与积压待办数,定位卡点节点
审批人工作量各审批人的待办与已处理量
超时预警已超时待办数、24 小时内将超时待办数,以及超时待办明细列表
异步健康作业、Webhook 投递、子流程实例的状态分布速览

运维操作的边界 ​

实例页的强制跳转、改派、取消、挂起 / 恢复、迁移与 Token 干预分别受功能权限控制,实例和任务查询同时遵守租户与数据范围。具体授权见权限与范围控制,状态变化见实例生命周期。

后台执行失败先查看作业账本,确认是等待退避、已取消、死信还是外部结果待确认。定向恢复扫描提交唤醒后,应继续核对作业尝试和实例任务,不把补投成功当成业务已成功。补偿工单的「恢复推进」消费失败节点并继续向后流转;「标记修复放行」只闭环工单,具体条件见补偿与 Saga。

API ​

实例技术诊断路径相对于 /api/workflows,读取使用 workflow:instance:monitor。

方法路径说明
GET/instances/{id}/diagnostics实例运行时诊断
GET/instances/{id}/trace引擎运行轨迹
GET/instances/{id}/tokens执行 Token 与路径
GET/instances/{id}/diagnostic-bundle导出诊断包
POST/instances/batch-skip-stuck批量推进卡死实例,原因必填
POST/instances/tokens/{id}/skip跳过卡死 Token
POST/instances/tokens/{id}/replay从 Token 重放,需 workflow:instance:cancel
POST/instances/{id}/jump强制跳转,需 workflow:instance:cancel,原因必填

引擎内省、恢复扫描、作业处理与补偿接口分别见引擎诊断、健康与运行配置、作业执行与恢复和补偿与 Saga。

排查顺序 ​

Built with VitePress for local documentation preview.