服务注册与分布式协调 / 系统课时
启动并观察 Workflow Execution
启动并观察 Workflow Execution
本课把已经运行的 Worker、Go Client、Temporal CLI 和 Web UI 串起来:先启动一个 Workflow,再用 CLI 与 Web UI 确认它的执行状态、事件历史和最终结果。
学习目标
- 能使用 Go Client 或 Temporal CLI 启动指定 Workflow Execution
- 能从 Web UI 和 CLI 区分执行状态、事件历史与最终结果
- 能用 Workflow ID 和 Run ID 定位一次具体执行
准备一个可观察的 Workflow
先准备一个最小 Workflow。下面的示例不依赖外部服务,Worker 启动后会等待一小段时间再返回结果,因此有足够时间观察运行状态。
package main
import (
"context"
"fmt"
"log"
"time"
"go.temporal.io/sdk/client"
"go.temporal.io/sdk/worker"
"go.temporal.io/sdk/workflow"
)
const taskQueue = "demo-task-queue"
func ObserveWorkflow(ctx workflow.Context) (string, error) {
// 使用 Temporal Timer,保证等待行为可持久化并支持重放。
if err := workflow.Sleep(ctx, 10*time.Second); err != nil {
return "", err
}
return "workflow completed", nil
}
func main() {
c, err := client.Dial(client.Options{})
if err != nil {
log.Fatal(err)
}
defer c.Close()
w := worker.New(c, taskQueue, worker.Options{})
w.RegisterWorkflow(ObserveWorkflow)
// 先让 Worker 持续轮询 Task Queue,再从 CLI 或其他 Client 启动 Workflow。
if err := w.Run(worker.InterruptCh()); err != nil {
log.Fatal(err)
}
_ = context.Background()
_ = fmt.Sprintf
}上面的程序负责注册并运行 Worker;启动 Workflow 的动作可以交给另一个 Go Client,也可以交给 Temporal CLI。实际项目通常会把 Worker 和启动端拆成不同进程。
使用 Go Client 启动
独立准备一个启动端,指定 Workflow 类型、Task Queue 和稳定的 Workflow ID。
package main
import (
"context"
"fmt"
"log"
"go.temporal.io/sdk/client"
)
func main() {
c, err := client.Dial(client.Options{})
if err != nil {
log.Fatal(err)
}
defer c.Close()
run, err := c.ExecuteWorkflow(
context.Background(),
client.StartWorkflowOptions{
ID: "observe-demo-workflow",
TaskQueue: "demo-task-queue",
},
"ObserveWorkflow",
)
if err != nil {
log.Fatal(err)
}
fmt.Printf("workflow_id=%s run_id=%s\n", run.GetID(), run.GetRunID())
}预期输出
workflow_id=observe-demo-workflow run_id=<ID>这里的 Workflow ID 用来标识业务层面的 Workflow Execution,而 Run ID 标识一次具体运行。重试、继续执行等场景下可能出现新的 Run ID,因此排查时不要只复制一个模糊的任务名称。
使用 Temporal CLI 启动
确认 Temporal Service 已运行、Worker 已监听 demo-task-queue 后,可以直接从终端启动同一个 Workflow 类型。CLI 的参数重点是 Workflow ID、Task Queue 和 Workflow 类型。
temporal workflow start --id observe-cli-workflow --task-queue demo-task-queue --type ObserveWorkflow预期结果
Started Workflow Id: observe-cli-workflow
Run Id: <ID>CLI 启动成功只说明 Workflow Execution 已提交并获得执行标识,并不等于 Workflow 已经完成。下一步要查看它当前处于什么状态,以及历史中实际发生了什么。
在 Web UI 中观察状态与事件历史
打开当前 Temporal 环境对应的 Web UI,先按 Workflow ID 找到 observe-cli-workflow,再进入该 Execution 的详情页。观察时重点区分三个层次:当前状态、执行输入与结果、Event History。
对于本例,Workflow 先保持运行状态,等待结束后才进入完成状态。Event History 则记录执行过程中由 Temporal 持久化的事件,因此它比单纯看一条日志更适合确认一次 Execution 到底走过了哪些阶段。
用 CLI 再做一次结果验证
找到 Workflow ID 后,可以直接描述这次 Execution,适合脚本化检查和终端排障。
temporal workflow describe --workflow-id observe-cli-workflow预期结果
WorkflowId: observe-cli-workflow
RunId: <ID>
Status: COMPLETED实际 CLI 输出会随版本和配置显示更多字段,但验证重点不变:确认 Workflow ID 对得上,并检查当前 Execution 是否已经 COMPLETED。若仍在运行,不要把“已经 Started”误判成“已经 Completed”。
把一次执行串成证据链
最实用的观察顺序是:启动命令得到 Workflow ID 和 Run ID;Worker 从 Task Queue 获取 Workflow Task;Web UI 查看当前状态与 Event History;Workflow 完成后,再用 CLI 或客户端取得结果。这样可以把“请求已提交”“Workflow 正在执行”和“Workflow 已成功结束”三个事实分开验证。
排查启动问题时,优先确认 Workflow 类型是否已注册、Task Queue 是否完全一致,以及 Worker 是否确实处于运行状态。这三个条件任意一个不满足,都可能出现启动请求成功但 Workflow 无法向前推进的情况。