Inspect a run
Set your nodes in inventories/example.yml, then:
mmx dryrun configure --output=summary --diff
mmx run configure
mmx results --diff=all
mmx results --node app01 --task app_config --diff=all
mmx results --json --diff=all
The template produces different contents for each node. Summary output keeps
the nodes' file changes separate. Matching outcomes appear once with their
count and node names. show values remain visible. --output=nodes lists
each node; the default auto uses that view through ten selected nodes and
summary above ten. The view is chosen once per command. A run whose node
selection depends on earlier results uses the inventory size as its initial
upper bound.
Bare --diff shows bounded previews. --diff=all reads complete retained
text differences from local history, including differences from previous
attempts. JSON always keeps individual results. --json --diff=all also
includes a full_differences object keyed by the SHA-256 references in the
individual JSON results. Saved results work after the controller restarts
and while the servers are unavailable. Saved results never compare today's
files or execute tasks.
Full differences are captured automatically for text inputs up to 1 MiB each, within an 8 MiB budget per node job. Identical differences share one copy. Larger files still install normally. Results explain any diagnostic omission. Directory copies retain differences for their first ten change examples. Secret-consuming tasks, private files, binary data, and deleted contents are excluded before artifacts are stored. Stored differences are for inspection, not file backups.
The existing run_history_retention setting owns the run's local
differences; the controller process downloads the differences when saving a
finished result. A difference that is not available locally (still running,
unconfirmed, never downloaded, missing, or corrupt) is shown as not
available locally, and JSON lists the unavailable difference in
full_differences_unavailable. Ordinary results and the saved task outcomes
remain available; nothing is rerun.
This page is examples/inspection/README.md in the MMX repository.