Flow Runs and logs
The Runs section in ZBrain Flows provides a consolidated view of your Flow execution history, including status, duration, token usage, and cost. This enables you to monitor resource consumption, troubleshoot failures, and rerun specific executions as needed.
Accessing Flow Runs details
Navigate to the Flows tab from the top menu.
Select Runs from the left-hand sidebar.
The interface will display a list of recent executions for all Flows in your workspace.
Apply preset time filters—15 minutes, 30 minutes, 1 hour, 6 hours, 1 day, or 3 days—by clicking ‘Pick a date range’ in the Runs view. The table will instantly refresh to display executions that match the chosen timeframe.
Last 15 Minutes
Last 30 Minutes
Last 1 Hour
Last 6 Hours
Last 1 Day
Last 3 Days
How to use
Navigate to Flows → Runs.
Click ‘Pick a date range’ at the top of the Runs view.
Select a preset option from the list.
The Runs table will instantly refresh to display executions that match the chosen timeframe.
If you want to see the Flow execution details for a particular Flow, select the particular Flow from the Flows tab and click Logs from the left panel.
Runs table overview
The Runs table contains the following key columns:
Flow – Name of the executed Flow.
Status – Execution result, shown with a visual indicator:
Succeeded – Flow completed successfully.
Failed – Flow encountered an error during execution.
Paused – Flow execution was paused manually or by a system trigger.
Started – Date and time when execution began.
Finished – Date and time when execution ended.
Token Used - Per-activity token usage
Cost ($) - Cost per activity
Execution Time – Total time taken to complete the run.
Identifier - A unique value linking parent and child flow executions for easier tracing and debugging. You can pass an identifier when triggering a parent Flow (via Postman or HTTP), which automatically propagates to child Flows, making it easy to trace, debug, and monitor complex executions with full visibility.
The Filter by Status option allows users to view flows based on their execution status. You can select from different statuses to refine the list of runs, as shown in the image below:
The Filter by Flow Name option allows users to refine the displayed list of runs by selecting one or more flow names. This feature supports multi-select, enabling precise control over which flows are shown in the Runs view. You can select multiple flows and deselect a selected flow name by clicking on it again. The Flow run names in the Runs view sync with the latest Flow names, eliminating confusion when flows are renamed.
Retrying a Flow Run
ZBrain Builder provides flexible retry options to help you recover from failed or incomplete executions without needing to restart the entire workflow manually. Retry actions are available from the (⋯) on the corresponding row in the table. Click (⋯) and select from the below available options -
Retry on latest version – Executes the flow again with the most recently published version, ensuring all updates and fixes are applied.
Retry from failed step (for failed runs) – Restarts the flow from the point of failure, preserving prior completed steps to save time and resources.
Opening Flow Run details in a new tab
You can open Flow Run details in a separate browser tab, giving you more flexibility when reviewing or comparing multiple runs.
How to use
Go to Flows → Runs.
Locate the Flow Run you want to inspect.
To open the Run details in a new tab, use one of the standard browser actions:
Ctrl + Click (Windows/Linux) or Cmd + Click (Mac)
Right-click on the run and select ‘Open link in new tab’
The Run details will open in a separate browser tab, while your Runs list remains available in the original tab.
Last updated