Troubleshooting your workflows
Using workflow run logs
Each workflow run generates activity logs that you can view, search, and download. For more information, see "Using workflow run logs."
Enabling debug logging
If the workflow logs do not provide enough detail to diagnose why a workflow, job, or step is not working as expected, you can enable additional debug logging. For more information, see "Enabling debug logging."
Canceling a workflow
If you attempt to cancel a workflow and the cancellation doesn't succeed, make sure you aren't using the always
expression. The always
expression causes a workflow step to run even when the workflow is canceled, which results in a hanging cancellation. For more information, see "Evaluate expressions in workflows and actions".
Troubleshooting GitHub Actions inefficiencies
To analyze the inefficiencies and reliability of your workflows using metrics, see "Viewing GitHub Actions metrics".
Monitoring self-hosted runners
Troubleshooting self-hosted runners
If you use self-hosted runners, you can view their activity and diagnose common issues.
For more information, see "Monitoring and troubleshooting self-hosted runners."