> ## Documentation Index > Fetch the complete documentation index at: https://docs.trymonte.ai/llms.txt > Use this file to discover all available pages before exploring further. # Observability > Runs, traces, and run comparison These commands read what runs recorded: rows, events, traces, and the difference between two runs. [Metrics](https://docs.trymonte.ai/observability/metrics.md) and [Traces](https://docs.trymonte.ai/observability/traces.md) explain the output. | Command | Description | | - | - | | [`monte run list`](#monte-run-list) | List the runs of an experiment | | [`monte run show`](#monte-run-show) | Show one run in full | | [`monte run logs`](#monte-run-logs) | Print or follow the events of a run | | [`monte run stop`](#monte-run-stop) | Stop a running run | | [`monte trace list`](#monte-trace-list) | List the traces of a run | | [`monte trace download`](#monte-trace-download) | Write the traces of a run to a file | | [`monte compare`](#monte-compare) | Compare two eval runs task by task | ## monte run list ```text theme={null} monte run list [--kind eval|train] [--status ] [--all] [--json] ``` List the runs of an experiment, oldest first, with the alias of each succeeded run (`eval@200`), its status, and its score as `=±`. | Flag | Type | Default | Description | | - | - | - | - | | `` | argument | required | The experiment | | `--kind` | string | both | `eval` or `train` | | `--status` | string | all | `running`, `succeeded`, `failed`, or `abandoned` | | `--all` | flag | off | Include smoke runs, marked `[not evidence]` | | `--json` | flag | off | Print JSON on stdout | ```bash theme={null} monte run list support-triage ``` ```text theme={null} RUN ALIAS STATUS DETAIL SCORE eval-01 eval@0 succeeded support-escalation-dev base support-escalation-dev=0.50±0.07 eval-02 eval@0 succeeded support-escalation base support-escalation=0.49±0.07 ... train-07 train@200 succeeded triage-sft support-replies from base eval-03 eval@200 succeeded support-escalation-dev train-07/200 support-escalation-dev=0.60±0.07 train-09 - running triage-sft support-replies from train-07/200 ``` ## monte run show ```text theme={null} monte run show / [--metrics ] [--json] ``` Show one run in full: status, target, settings, scores, eval checks, and provenance. A training run also shows its training config, training data version, and checkpoint. | Flag | Type | Default | Description | | - | - | - | - | | `/` | argument | required | The run, by ID or alias | | `--metrics` | string | all | With `--json`, include the per-step series for these comma-separated metric tags | | `--json` | flag | off | Print JSON on stdout | ```bash theme={null} monte run show support-triage/eval-03 ``` ```text theme={null} run support-triage/eval-03 (eval) succeeded target train-07/200 on Qwen/Qwen3-8B @ a09a3545 score 0.60 ± 0.07 vs baseline +0.10 ± 0.06 paired (30 fixed / 10 broken, eval-01) checks mean_output_tokens 142 parse_fail_rate 0.00 truncations 0.01 repetition 0.02 ``` ## monte run logs ```text theme={null} monte run logs / [-f] [--tail ] ``` Print the events of a run as JSON lines: `progress`, `checkpoint_saved`, and `score_recorded`, and a final `status` event. | Flag | Type | Default | Description | | - | - | - | - | | `/` | argument | required | The run | | `-f` | flag | off | Keep the output open and print new events until the run ends | | `--tail` | integer | all | Print only the last `n` events first | ```bash theme={null} monte run logs support-triage/train-07 -f --tail 2 ``` ```text theme={null} {"event": "progress", "step": 200, "loss": 0.407, "step_time_s": 4.0} {"event": "checkpoint_saved", "checkpoint": "train-07/200", "kind": "both"} {"event": "status", "status": "succeeded"} ``` ## monte run stop ```text theme={null} monte run stop / [--json] ``` Stop a running run. Its status becomes `abandoned`. Run history keeps what the run recorded, and a training run keeps the checkpoints it saved. | Flag | Type | Default | Description | | - | - | - | - | | `/` | argument | required | The run | | `--json` | flag | off | Print JSON on stdout | ```bash theme={null} monte run stop support-triage/train-09 ``` ```text theme={null} Stopped support-triage/train-09 at step 264 of 300. Status abandoned. Last checkpoint train-09/250. ``` | Error | Cause | | - | - | | `E_NOT_RUNNING` | The run is not running | ## monte trace list ```text theme={null} monte trace list / [--eval ] [--failed] [--step ] [--sort task|score] [--json] ``` List the traces of a run, one row for each task, with the score, the parsed and expected answers, the tokens, and the stop reason. A training run with a grader has one trace for each scored rollout. | Flag | Type | Default | Description | | - | - | - | - | | `/` | argument | required | The run | | `--eval` | string | the eval that the run scored | The eval, for a run with traces on more than one | | `--failed` | flag | off | Only the traces with a score below `1.0` | | `--step` | integer | all steps | For a training run, only the rollouts of one step | | `--sort` | string | `task` | `task` or `score` | | `--json` | flag | off | Print JSON on stdout | ```bash theme={null} monte trace list support-triage/eval-03 --failed --sort score ``` ```text theme={null} TASK SCORE EXTRACTED EXPECTED TOKENS STOP t-004 0.00 resolve escalate: money 412/96 - t-031 0.00 escalate: angry escalate: legal 388/41 - t-142 0.50 resolve resolve 520/400 length 79 failed of 200 ``` ## monte trace download ```text theme={null} monte trace download / [--eval ] [--step ] [-o ] [--json] ``` Write the traces of a run to a JSONL file, one trace on each line, with the fields that [Trace Contents](https://docs.trymonte.ai/observability/traces.md#trace-contents) lists. | Flag | Type | Default | Description | | - | - | - | - | | `/` | argument | required | The run | | `--eval` | string | the eval that the run scored | The eval | | `--step` | integer | all steps | For a training run, only the rollouts of one step | | `-o` | path | `./--traces.jsonl` | The output file. `-` writes to stdout. | | `--json` | flag | off | Print a JSON summary on stdout | ```bash theme={null} monte trace download support-triage/eval-03 -o eval-03-traces.jsonl ``` ```text theme={null} Wrote 200 traces (3.4 MB) to eval-03-traces.jsonl. ``` ## monte compare ```text theme={null} monte compare / / [--show fixed|broken|same] [--json] ``` Compare two eval runs on the same eval, task by task. The first run is the reference. [Compare Runs](https://docs.trymonte.ai/observability/metrics.md#compare-runs) explains the output. | Flag | Type | Default | Description | | - | - | - | - | | `/` | argument | required | The reference run | | `/` | argument | required | The compared run | | `--show` | string | none | Also list the task IDs of one group | | `--json` | flag | off | Print JSON on stdout | ```bash theme={null} monte compare support-triage/eval@0 support-triage/eval-03 --show broken ``` ```text theme={null} difference +0.10 ± 0.06 paired 30 fixed / 10 broken / 160 same broken t-004 t-019 t-031 t-052 t-077 t-090 t-128 t-144 t-171 t-199 ``` | Error | Cause | | - | - | | `E_NOT_COMPARABLE` | The runs scored other evals, belong to other experiments, have other base models, or one is a smoke run | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.