1
0
Fork 0
toolkit/docs/action-debugging.md

1.9 KiB

Debugging

If the build logs do not provide enough detail on why a build may be failing, some other options exist to assist with troubleshooting.

Runner Diagnostic Logs

Runner Diagnostic Logs provide additional log files detailing how the Runner is executing an action.

Each file contains different logging information that corresponds to that process:

  • The Runner process coordinates setting up workers to execute jobs.
  • The Worker process executes the job.

These files contain the prefix Runner_ or Worker_ to indicate the log source.

How to Access Runner Diagnostic Logs

These log files are enabled by setting the secret ACTIONS_RUNNER_DEBUG to true.

All actions ran while this secret is enabled contain additional diagnostic log files in the runner-diagnostic-logs folder of the log archive.

Step Debug Logs

Step debug logs increase the verbosity of a job's logs during and after a job's execution to assist with troubleshooting.

Additional log events with the prefix ::debug:: will now also appear in the job's logs.

How to Access Step Debug Logs

This flag can be enabled by setting the secret ACTIONS_STEP_DEBUG to true.

All actions ran while this secret is enabled will show debug events in the Downloaded Logs and Web Logs.