With our testing and debugging tools, you can see more information about why a particular submission failed. You can also learn more about how flows are constructed and use what you've learned to build and test your own flows with our Flows SDK.
Currently, you cannot view testing and debugging data for a flow outside of the context of a particular submission's execution. Therefore, all data shown is specific to a particular submission. You can use it to troubleshoot halted submissions and failed flows in your production or development environments, or you can view it in a development instance as part of your flow-testing process.
Viewing execution details for a submission’s flow
You can access the execution details for a particular submission’s flow in the following ways.
From the details page for a submission
- Click Submissions, and click on the name of the submission you'd like to view flow-execution details for.
- Click Actions, and then click View Flow Execution.
From the Flow Executions page
- Go to the Flow Executions page (Flows > Flow Executions).
- Find the submission’s record in the Flow Execution table, and click its Flow Execution ID.
Note that you need the View Flow Executions permission to access the Flow Executions page, which is given to users in the System Admin and Business Admin permission groups by default.
From the Jobs page
- Go to the Jobs page (Administration > Jobs).
- Make sure Flows is selected in the drop-down menu at the top of the page.
- Click on the ID of the flow execution that you want to view details for.
Note that you need the View Jobs permission to access the Jobs page, which is given to users in the System Admin permission group by default.
Navigating the Flow Run page
- If you access the Flow Run page from the Flow Executions or Jobs page, the flow’s identifier appears in the upper-left corner of the page. Clicking on it redirects you to the flow's settings in Flow Studio.
- If you access the Flow Run page from a submission’s details page, the submission’s ID appears in the upper-left corner of the page.
The Flow Run page has the following parts:
Debugging — The links in the top section of the left-hand sidebar show flow-level details that can help troubleshoot the flow’s execution:
- Flow Runtime Errors — Clicking View opens the Flow Runtime Errors tab in the Data panel at the bottom of the page.
- Flow Inputs/Outputs — Clicking View opens the Flow Input tab in the Data panel at the bottom of the page, which shows the data that was submitted to the flow in JSON format. You can click the Flow Output tab to see the JSON output of the flow.
Overview — The left-hand sidebar shows metadata for the submission or flow execution.
If you access the Flow Run page from either the Flow Executions page or Jobs page, the Overview section contains the following metadata:
- Status — The status of the submission’s flow execution:
- Failed — The flow execution was not completed successfully.
- Running — The flow execution is currently in progress.
- Completed — The flow execution was completed successfully.
- Timed Out — The execution of one of the flow's blocks timed out, preventing the flow from being completely executed.
- Terminated — The flow execution was deliberately stopped before it could be completed.
- Paused — The flow execution has been temporarily stopped and may be resumed in the future.
- Flow Run ID — The internal ID of the flow execution
- Flow Name — The name of the flow being executed
- Start Time — The date and time the flow’s execution began
- Complete Time — The date and time the flow’s execution ended (if applicable)
- Total Processing Time — The amount of time taken to execute the flow
If you access the Flow Run page from a submission’s details page, the Overview section contains the following metadata:
- Submission ID — The submission’s internal ID. Clicking on the ID redirects you to the details page for the submission.
- Submission Status — The current processing status of the submission
- External ID — The external ID of the submission
- Flow Name — The name of the flow used to process the submission. Clicking on the name redirects you to the flow's settings in Flow Studio.
- Flow Version — The version of the flow named in Flow Name used to process the submission
- Start Time — The date and time the submission’s processing began
- Complete Time — The date and time the submission’s processing ended (if applicable)
- Total Processing Time — The amount of time taken to process the submission
Flow Run diagram — The upper-right panel shows a diagram of the flow.
- The processing status for an individual block is shown under the block, along with the time the block completed or failed processing (if applicable).
- If the block has no status underneath it, it has not been executed yet.
- Clicking on a block reveals its metadata, input, output, and logs in the Data panel below.
Data — The Data panel can show either flow-level or block-level information.
Block-level data — By default, the Data panel shows details for the block currently selected in the Flow Run diagram. Click on a block in the diagram to see its details in the Data panel. The panel contains the following tabs when a block is selected:
- Details — The Details tab contains metadata for the block, including when the block’s task was created and when it began. It also shows the block’s reference name and type.
- To learn more about reference names and block types, see the Flows SDK documentation.
- Input — The Input tab shows the JSON that the block used for processing.
- Note that the input JSON for the first block in a completed submission is not the same as the JSON input for the entire submission. To view the submission’s JSON input, click View next to Flow Inputs/Outputs in the Overview section of the page.
- Output — Clicking on the Output tab shows the JSON that the block produced during processing (if applicable).
- Note that the output JSON for the final block in a completed submission is not the same as the JSON output for the entire submission. To view the submission’s JSON output, click View next to Flow Inputs/Outputs in the Overview section of the page, and then click the Flow Output tab in the Data panel.
- Logs: If the block failed to process the submission, the Logs tab shows error information for the block.
- If you’ve enabled logging for your Custom Code or Python Blocks in the Flows SDK, the Logs tab also shows any applicable info, debugging, warning, or error messages you created for the block. You can also find these messages in your Docker logs.
- Code: This tab is only available if a Custom Code Block or Python Block is selected. If the block was executed, clicking the Code tab reveals the Python code that was run by the block.
Flow-level data — If you click either of the View links in the Debugging section of the page, the Flow Runtime Errors, Flow Input, and Flow Output tabs appear in the Data panel. To learn more about these tabs, see the Debugging portion of this article.
You can copy any of the data shown in the Data panel by clicking Copy in the upper-right corner of the panel.
Retrying a submission
If you access the Flow Run page from a submission’s details page, you can retry the submission by clicking Resubmit submission in the upper-right corner of the page. This action will generate a new, separate submission using the same input as the submission you’re currently viewing flow-execution data for.