服务注册与分布式协调 / 系统课时

使用 CLI 与 Web UI 检查执行

使用 CLI 与 Web UI 检查执行

本课解决日常运行检查中“工作流到底卡在哪里”的问题:先用 CLI 确认当前状态与事件历史,再进入 Web UI 查看待处理 Activity 和失败细节,形成固定排查路径。

学习目标

  • 能使用 Workflow describe 和 show 快速确认执行状态与事件历史
  • 能在 Web UI 中定位 Pending Activity、失败事件和最近执行变化
  • 能按“状态 → 事件 → Activity → 失败原因”的顺序完成一次运行检查

先用 CLI 确认当前执行

CLI 适合第一轮检查,因为它不依赖浏览器界面,并且便于把检查过程复制到终端记录中。实际排查时先锁定 Namespace 和 Workflow ID;同一个 Workflow ID 可能对应多个 Run,因此需要进一步确认当前关注的 Run ID。

下面用占位符表示实际环境中的 Namespace、Workflow ID 和 Run ID。<ID> 等值应替换为真实执行标识。

bash
temporal workflow describe \
  --namespace <NAMESPACE> \
  --workflow-id <WORKFLOW_ID> \
  --run-id <RUN_ID>

temporal workflow show \
  --namespace <NAMESPACE> \
  --workflow-id <WORKFLOW_ID> \
  --run-id <RUN_ID>

预期结果

text
Workflow describe:输出当前 Workflow Execution 的状态、Run ID 等执行信息。
Workflow show:输出该 Run 的事件历史,可继续定位 Activity 调度、完成、失败或重试相关事件。
实际字段与终端格式会随 Temporal CLI 版本变化,但应至少能够确认“正在运行什么、运行到哪里”。

describe 更适合回答“现在是什么状态”,show 更适合回答“为什么变成这个状态”。不要看到 Running 就停止检查,因为运行中的 Workflow 仍可能存在长期 Pending Activity、反复失败重试或下游资源异常。

CLI 到 Web UI 的执行检查路径

再用事件历史还原执行位置

当状态本身无法解释问题时,事件历史是第二层证据。重点观察最近一段事件,而不是从头逐条阅读全部历史。通常先寻找最近一次 Activity 调度,再向后确认它是否完成、失败或进入下一次尝试。

排查时可以把事件问题压缩成三个判断:最近发生了什么、哪个动作没有完成、失败后系统采取了什么动作。这样比单独搜索某个异常字符串更容易找到真正阻塞点。

在 Web UI 检查 Pending Activity

CLI 适合快速确认,Web UI 更适合人工连续浏览。打开目标 Namespace 后,根据 Workflow ID 找到对应执行,再核对当前状态、事件时间线和 Activity 信息。

看到 Pending Activity 时,不要直接把它理解成“Temporal 出故障”。Pending 可能只是 Activity 尚未被 Worker 处理,也可能已经被调度但 Worker 长时间没有完成;还要结合 Activity 类型、开始时间、重试状态和 Worker 健康情况判断。

失败信息同样需要结合上下文阅读。单个 Activity 的失败异常只能说明这一层发生了错误,还应继续向事件历史确认它是否重试、后续是否成功,以及 Workflow 是否因此进入失败、继续运行或等待状态。

建立固定的日常检查顺序

生产环境可以把检查固定成下面的顺序,避免一上来就在页面里漫无目的搜索。

  1. 用 Namespace、Workflow ID 和 Run ID 锁定目标执行。
  2. 用 describe 确认当前状态和执行身份。
  3. 用 show 查看最近事件,找到最后一个关键业务动作。
  4. 在 Web UI 检查对应 Activity 是否 Pending、失败或持续重试。
  5. 将失败信息与事件时间线对齐,再决定继续看 Worker、下游依赖还是 Workflow 代码。

这个顺序的核心不是工具本身,而是先确认事实,再解释原因。把“当前状态”和“历史证据”分开检查,可以减少仅凭一条异常日志误判执行问题的情况。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 CLI 与 Web UI 检查执行

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通