从哪个标识开始
应用保存业务 request ID、Session ID、Run ID、幂等键和事件 cursor。Console 中按对应 Session / Run 查看输入、初始化、事件、工具活动和资源状态。Run origin 可携带 request_id、message_id、channel,帮助关联来源;它不代替认证或业务归属。一次排障路线
假设界面长时间没有输出:先查询原 Run,而不是重提任务。如果是 waiting_authorization / waiting_approval,找到具体调用和待决定操作。如果处于 provisioning,检查 Sandbox 创建操作和执行阶段。如果 Runtime unreachable,观察原 invocation 的恢复状态,避免启动第二份进程。如果 Run 已完成,检查客户端事件 cursor 和最终结果读取。 可用 SDK 调用包括run、events / stream、tool_calls / toolCalls、session_initialization / sessionInitialization。读取事件时每页有上限,需要继续补读;数据返回为空不证明执行终止。
排查实例:云恢复完成后的执行失败
对一条既有真实失败的只读复查,将 Modal/OpenClaw OCI Run 的持久事件与同一 Session 的资源操作关联起来。事件顺序为run.provisioning → workspace.inputs_verified → run.running → harness.starting → harness.running → harness.exited → run.failed。终态诊断为 harness_execution_failed,退出码 1,Runtime 状态 exited。
对应云端 create 与 restore 操作均为 completed;两条 delete 操作均为 completed,checkpoint 为 deleted。这将故障定位在资源准备之后的 Harness 执行阶段,不能据此判断资源分配失败或仍有资源未清理。仅凭诊断码也不能认定 Harness 的底层根因。应保留原 Run,在再次提交任务前调查私有执行历史。本次复查没有创建 Run 或云资源。
排查自己的故障时,查询已保存的 Run 并保留 session_id,遍历 resource operation 分页,只选择同一 Session 的记录,不取整个租户里最新的操作。读取相关 operation 的详情与复核记录,再对照事件阶段与操作状态。实际标识保留在私有事故记录中。下面列出其他可能观察到的情况:
资源详情提供
kind、state、provider_resource_id、provider_operation_id、provider_build_id、attempt_count、review_state、last_checked_at、next_check_at、reason 与过滤后的 failure。未获得回执时部分字段可能为空,缺少 Provider ID 不证明请求没有效果。真实 ID 保存在私有事故记录;公开报告保留因果顺序,不携带账户秘密或任务内容。
需要可分享的健康摘要时,npm run local -- diagnostics /absolute/new-report.json 创建具有私有权限的新文件,并拒绝覆盖。该允许列表投影刻意省略资源 ID 与私有端点,不能替代私有关联记录。分享前仍须检查报告。