sparkrun logs
sparkrun logs <target> [options]Show available workload logs, with docker logs / journalctl
semantics. TARGET can be a recipe name or a workload ID (from sparkrun status
output).
Called bare, it dumps the workload’s logs and exits. Use -f to stay attached
and stream new output — Ctrl+C detaches and never kills the inference job.
Options
Section titled “Options”| Option | Description |
|---|---|
--hosts / -H | Full workload host list; preserve original topology |
--hosts-file | File with hosts (one per line, # comments) |
--cluster | Use a saved cluster by name |
--tp / --tensor-parallel | Match host trimming from run |
--port | Override port (to match run-time override) |
--served-model-name | Override served model name (to match run-time override) |
-n / --lines / --tail | Number of log lines to show (default: all). With -f, sets the scrollback shown before following. |
-f / --follow | Stay attached and stream new lines |
-a / --all-sources | Read every worker/rank, not just the head |
Reading workers
Section titled “Reading workers”By default sparkrun logs reads the head. -a / --all-sources adds every
worker:
- Without
-f, each source is dumped in full — head first, then workers by rank. - With
-f, the streams interleave in arrival order.
# Dump everything the head has loggedsparkrun logs qwen3-1.7b-vllm --cluster mylab
# Last 200 lines, then followsparkrun logs qwen3-1.7b-vllm --cluster mylab -n 200 -f
# Follow head and all workers togethersparkrun logs e5f6a7b8 -f -aSource identity and read failures
Section titled “Source identity and read failures”Log reads never delete saved workload metadata or release model-cache claims. Workload stdout/stderr stays in the output; SSH, Docker-reader, or kubectl diagnostics are reported separately. Failed readers report an error, so a partial export must not be treated as complete. Ctrl+C stops readers, leaving the workload.
Saved native Kubernetes Job/JobSet workloads use local kubectl and their recorded
connection settings. Completed containers remain readable while their logs exist.
--all-sources includes regular containers and sidecars, not init containers or
previous instances. A replaced pod or restarted container requires a fresh read;
following does not automatically attach to replacements.
For interactive browsing, use
sparkrun cluster monitor.
Its log viewer supports regex search, runtime colorization, source scopes, older
history, and complete file exports.
Python and daemon clients additionally support host/container/source filters,
reusable targets, and cancellable readers. Python callers can page older history;
LogTarget.dump() exports complete logs with cancellation cleanup and atomic
publication. See Log Streaming API.