What Are Runner Diagnostic Logs?
Runner diagnostic logs are the runner's own internal logs, separate from step output, that record how it provisioned the workspace, resolved actions, and managed each step. They are enabled with a debug setting and uploaded alongside the run. They expose the machinery behind a job rather than the job's own output.
Why it matters
When a job fails in a way the step logs do not explain, the cause is often in how the runner set things up. Diagnostic logs reveal that layer, helping distinguish a workflow bug from a runner or environment problem. On managed runners, they help confirm whether an issue was provisioning-related.
Related guides
What Is CI Debug Logging?CI debug logging is a verbose mode, toggled by a setting, that makes the runner and actions emit extra diagno…
What Is Step Debug Logging?Step debug logging is the per-step verbose mode that prints extra diagnostic detail about how an individual s…
What Is a Job Timeout?A job timeout is the maximum time a CI job may run before the system cancels it, preventing a stuck or runawa…