Skip to main content

miren debug saga show

Show a saga execution in detail

Shows one saga execution in full: its status, its initial inputs, and every action it ran with timing, undo state, and output.

Output details

Action outputs are truncated by default so a long saga stays readable. Pass --full to print them whole. --format json always carries them in full, since a partial record is worse than a large one for anything parsing it.

A saga marked BLOCKED is one the server refused to resume, usually because it was started by an older release whose saga definition the running one cannot vouch for. Nothing ran or was undone when it refused, and nothing will drive the saga until someone acts: running a release that can still resume it lets it finish or compensate normally, and miren debug saga abandon gives it up when that is not possible.

A saga is also BLOCKED when one of its undos has failed at least three times over more than an hour. The release that gave up won't try that undo again, and the action shows its undo error and how long it has been failing. A different release tries it once more when it starts, so deploying a fix usually clears the block without anyone stepping in. If the undo can't succeed under any release, abandon the saga and clean up after the action by hand.

Where a saga stopped is the last action listed. This shows the actions that ran, not the complete set the definition declares, since the saga definitions live in the server process and are not exposed over the API.

miren debug saga show saga/sg-4TzP9hQ2mKdX8vNfR3wLbY
miren debug saga show saga/sg-4TzP9hQ2mKdX8vNfR3wLbY --full
miren debug saga show saga/sg-4TzP9hQ2mKdX8vNfR3wLbY --format json

Usage​

miren debug saga show [args...] [flags]

Flags​

  • --cluster, -C — Cluster name
  • --config — Path to the config file
  • --format — Output format (text, json) (default: text)
  • --full — Print complete action outputs instead of truncating them (JSON always includes them)
  • --id, -i — Saga execution ID
  • --json — Shorthand for --format json

Global Options​

  • --options — Path to file containing options
  • --server-address — Server address to connect to (default: 127.0.0.1:8443)
  • --verbose, -v — Enable verbose output

See also​