Diagnose Failed Plan Runs
This section provides information and references on how to identify and repair issues that have led to failures in a plan run.
Identify Plan Run Failures
Definition
A plan execution has failed if any individual task in the plan run fails. If so, the plan run is marked as failed in the application.
After a task has failed, plan execution could still continue if the plan logic includes On failure
tasks from the task that did fail.
Failure messages
When a plan run fails to complete, a failure message appears in following locations:
Plans Page: Listing for the plan.
Plan Runs Page: Listing of individual plan runs.
The following is an example from the Plan Runs page:
![DiagnoseFailedPlanRuns.png](../../../image/uuid-103d7dea-b81f-2815-88b5-187b19696366.png)
Figure: Plan run failed
Retry Failed Plan Runs
When a plan run fails, you can rerun the plan You can retry failed plan runs by clicking the Retry from failed button. For more information, see Plan Run Details Page.
Logs
Logs for plan runs are available in orchestration-service.log
file in the support bundle. From the Resources menu, select Download logs. For more information, see Support Bundle Contents.
By Task Type
Note
A plan run is essentially a sequence of tasks tha
t are executed based on the outcome(s) of previous tasks. Failures are likely to be the result of failures to execute individual tasks. Please use the links below to explore information for specific tasks.
The following types of tasks can be executed as part of a plan in the Designer Cloud Powered by Trifacta platform:
Flow task: An ad-hoc or scheduled execution of the transformations required to produce one or more selected outputs from a flow.
Snapshot: An image of the flows, recipes, and datasets of the flow tasks in a plan, taken at the time of plan execution.
Trigger: A trigger is a scheduling object that launches a plan run at a user-defined time.
HTTP task: A request submitted to a third-party server as part of a plan run.
Slack task: A specialized version of HTTP task, a Slack task can be configured to delete a message to a specified Slack channel.
Delete task: You can specify a task to delete one or more files on backend storage. This task type is useful for removing intermediate files that are generated as part of job or plan execution.
For more information, see Plan View Page.
For more information on plans in general, see Overview of Orchestration.
Contact Support
If you are unable to diagnose your plan run failure, please contact Alteryx Support.
Note
When you contact support about a plan run failure, please be sure to download and include the support bundle. See Download Logs Dialog.