Troubleshoot failed workflow runs

Symptom

A workflow run shows a failed status.

Resolution

1. Open the failed execution from the Workflow Runs page or from the builder run history.
2. Look for the step with a failed status indicator on the canvas. Failed steps are visually distinct from successful steps.
3. Check the activity list on the left side of the execution detail view. The list shows every step with its status and timing. Look for steps with a Failed status.

   If the workflow has On failure set to Continue on failure on some steps, multiple steps might show a failed status while the overall execution shows Completed with errors.

4. Click the failed step on the canvas or in the activity list.
5. Open the Output pane. The error details typically include:
   • An error message describing what went wrong.
   • For HTTP request steps, the response status code and response body from the external service.
   • For Ansible Automation Platform steps, the job status and a link to the job output in automation controller.
   • For script steps, the error output from the script execution.
6. Check the Parameters pane to verify the step received the expected input. A common cause of step failure is unexpected or missing data from an upstream step.
7. Review the step's Settings tab to check timeout and retry configuration:
   • If the step timed out, consider increasing the timeout value.
   • If retries are configured, the activity list shows the step with its current retry count.