Workflow Runs
Each time a member enters a workflow, Allegro starts a run and records every step it takes: what the step saw, what it did, and why the run stopped. The runs page is where you check that a workflow is doing what you meant and find out why a member did or didn't get an email.
Open it with the Runs button above the canvas in the editor (it shows how many runs are active), or with Runs in a workflow's menu on the Workflows list.
Run statuses
| Status | Meaning |
|---|---|
| Running | The run is moving through its steps right now. |
| Waiting | The run is paused on a Delay or a Wait for event step. |
| Completed | The run reached the end of its path or an End step. |
| Exited | The workflow's exit event happened for the member, so the run stopped early. |
| Failed | A step couldn't run, for example because its email or segment was deleted. The run stopped at that step. |
| Canceled | Someone canceled the run, or the workflow was archived or unpublished with its runs canceled. |
A step can also be Skipped, for example an email to a member with no email address, or a marketing email to a member who opted out. A skipped step doesn't stop the run.
The runs page
The top of the page counts Active runs and the runs that Completed, Exited, and Failed in the last seven days.
Narrow the list with:
- The status tabs: All, Running, Waiting, Completed, Exited, and Failed.
- The search box, which matches the member's email.
- The step filter, which shows only runs currently at one step.
- The date filter: Any time, Last 24 hours, Last 7 days, or Last 30 days.
Each row shows the run's status, member, trigger event, current step, and when it started and ended. A waiting run's current step also says what it waits for: the event name, or when the delay wakes it.
Run details
Click a run to open its details in a side sheet. Use the arrow buttons at the top to move to the previous or next run in the list.
The header shows the member, the status, when the run started, and the workflow version it follows. Below it are the run's Status, Current step, when it next Wakes, and how many Steps it has taken out of the steps on its path. Runs that ended show the reason.
The Run timeline lists each step in order with its outcome and timing. Expand a step to see its Input (the step's settings and what it checked) and Output (what it did, such as the email's recipient and subject, or the segment it changed). A failed step also shows its error. Steps the run hasn't reached yet appear muted below.
Common end reasons:
| Reason | Meaning |
|---|---|
end_step | The run reached an End step. |
exit_event | The workflow's exit event happened for the member. |
canceled | The run was canceled. |
max_steps | The run hit the limit of 200 steps and was stopped. |
A failed run whose step threw an error shows the error's name as its reason.
Acting on runs
| Action | Where | What it does |
|---|---|---|
| Cancel run | Run details, on an active run | Stops the run where it is. A step already in progress finishes, but nothing after it runs. |
| Cancel all active runs | Top of the runs page | Stops every running and waiting run of the workflow. This can't be undone. |
| Retry from this step | The failed step in a failed run | Runs the failed step again and continues from there. Fix the cause first, for example by restoring the email or choosing a different segment. Not available once the workflow is archived. |
| Skip the wait | A run waiting on a Delay step | Ends the delay now, so the run continues within moments. Waits for an event can't be skipped. |
Runs follow the version that was live when they started, so publishing a fix doesn't change a run already in progress. To move members onto the fixed version, cancel their runs; whether they can enroll again depends on the workflow's enrollment mode.
How long runs are kept
Finished runs and their step history are deleted after 30 days by default. To change that, go to Organization Settings → Workflows and set Run retention to anywhere from 1 to 365 days. The runs page and the editor's settings panel both show the current period.
Runs still in progress are never removed. Removing old runs doesn't reset enrollment: a member who went through a Once per member workflow still can't enroll again after their run is deleted.
A member's runs
Every audience member has a Workflows tab listing every workflow run they've had, newest first. Use it to answer "what has Allegro sent this person?" without opening each workflow.