Inspecting inflight workflows

Dreamlit provides two easy ways to view, debug, and manage your inflight (i.e., currently running or recently completed) workflows:

1. Global Activity Log: A single dashboard containing all notifications and workflow runs across every workflow in your project.
2. Per-workflow Activity Log: A focused view that shows only the runs and notifications for a specific workflow.

In each of these views, you’ll find two main tabs:

• Notifications: Inspect the emails (or other messages) sent (or pending) from your workflows.
• Workflow Runs: Track each run’s status, see where in the workflow it is, and view error details (if any).

​

Releasing notifications

If your workflow is sandboxed, any notifications it generates will be held in a pending state until you manually release them. This is a great way to test your workflow in a more “production-like” environment without accidentally sending real messages to users. You can:

1. Go to the Notifications tab of the Activity Log (global or per-workflow).
2. Check the notifications you want to release.
3. Click Release.
4. Dreamlit will immediately attempt to send them out.

Of course, for workflows not sandboxed, notifications are automatically delivered as soon as the workflow step is reached. You can use this mechanism to effectively canary release your workflow. Start the workflow in sandboxed mode. Once you’re confident that your workflow is working as expected, you can flip the workflow from sandboxed to not sandboxed.

​

Handling failed notifications

• Errored and pending email rows are selectable; disabled checkboxes stay grey with a tooltip for ineligible rows.
• Use the action bar to Retry release or Cancel send for the selected emails.
• Cancelled sends are timestamped (cancelled_at) and appear when filtering by the Canceled status.

​

Canceling pending releases

If a workflow is sandboxed, pending emails can be canceled directly from the Activity Log. Select pending rows in the Notifications tab, choose Cancel send, and they will be marked canceled immediately so they won’t be released later.

​

How do I cancel an active workflow run?

Unpublishing a workflow stops new runs from starting, but runs already in progress continue. Cancel an active run if you need to stop its remaining steps and notifications that haven’t been released.

1. Open Workflows.
2. Find the workflow. Click the number of running runs, or open the     menu and select View runs.
3. Select the run you want to stop.
4. Click Cancel run in the upper-right corner. For a queued run that hasn’t started, click Cancel upcoming run.
5. Repeat these steps for each unwanted run.

​

Workflow errors

If a step fails for any reason, you can quickly see:

• Which run encountered the error
• Which step failed
• Error message (if available)

From there, you can investigate deeper or modify the workflow steps to fix the issue.