ResourceWorkflow tools
geni workflow execution
Inspect one execution, or download its full trace.
geni workflow execution <executionId> [flags]Inspects a single execution: status, runtime, the parsed run output, and (with --logs) its logs. Add --input or --thread to print the trigger payload or the step-by-step thread, or --download to write the whole trace to disk for offline debugging.
Synopsis
geni workflow execution exec_01HX --logs
geni workflow execution exec_01HX --thread
geni workflow execution exec_01HX --download
geni workflow execution exec_01HX --workflow wf_01HX --json| Arg / Flag | Notes |
|---|---|
<executionId> | The execution to inspect. |
--workflow <id> | Workflow id. Omit to use the marker in --dir. |
--dir <path> | Resource directory for id resolution. Defaults to cwd. |
--logs | Include the execution logs. |
--input | Include the trigger input payload. |
--thread | Include the step-by-step thread (every step the run took). |
--download [dir] | Write the full trace to <dir>/<id>/. Defaults to executions. |
--json | Machine-readable output. |
Downloading a full trace
--download writes whatever the run persisted into <dir>/<id>/, the same layout the cloud agent produces:
executions/exec_01HX/
run.json parsed run output
logs.txt raw logs
input.json the trigger payload that started the run
thread.json every step the run took (the agent conversation for agent workflows)This is the way to debug an agent workflow that misbehaved: read thread.json to see exactly what the agent did, step by step.
List a workflow's executions with geni workflow executions.