Skip to content

Why did this job fail?

Open the job: from the overview’s latest jobs, the Jobs page (?outcome=failure lists the failed ones), the link in a notification, or runnerctl jobs --failed. A failed job’s page opens on what failed: the step, its exit code, its last lines and, while its record is kept, the runnerctl shell command.

A failed job's page: the failing step and its exit code, the last lines of its log, its wait and steps on one time axis, then the log folded by step with the failed step open.A failed job's page: the failing step and its exit code, the last lines of its log, its wait and steps on one time axis, then the log folded by step with the failed step open.

The log is folded by step, the failed step open and scrolled to; nested groups fold too. Each line has a link (#L120), so a line can be sent to someone. The search finds text in the lines’ messages, not their timestamps or ##[…] commands. Colours come through as the job printed them. While the job runs, Follow keeps the newest lines in view.

From a terminal, the TUI’s job view shows the same: enter folds or opens a step, / searches, n and N go to the next and previous match. runnerctl logs <id> prints the plain log; -f follows it to the end.

The job’s page sets it beside the latest earlier success of the same job on its branch: whole-job figures and each step’s time, paired by name. In the TUI, c does the same.

The page also shows its wait, split at when runnerd first saw the job queued (Seen by runnerd, missing for a job a waiting runner took before runnerd listed it) and when its runner started, its steps on one time axis, memory and CPU against the container’s caps (with what admission reserved when that was less), how often the CPU cap held it back, and its latest 30 runs. Cancel and re-run sit at its top.

A job that failed reads runner fault, not failure, when its failed step’s log shows Sysbox losing the runner’s seccomp listener: function not implemented on a mount, umount or openat2, or unsafe procfs detected … invalid argument. Its code did not fail, and a re-run on a new runner is the answer, which runnerd can ask GitHub for itself. It still counts as a failure in the stats and notifications.

The Sysbox probe is off by default. To collect verdicts on one profile, set sysbox_probe_profile under [host] to that profile’s name. After a normal runner exit, its image tries a few mounts and an openat2 under /proc. A failed job’s page shows the verdict under its outcome, as does any job whose probe found a call failing. A failed job without a stored verdict reads no probe verdict recorded. For a successful canary job, check runnerctl job <id> --json for probe: "clean". This means the sampled calls succeeded, not that every call worked during the job. The verdict does not change outcomes or trigger reruns.

Frames set in JetBrains Mono (OFL).