Skip to content

Flow Runs

The Flow Runs page provides high-level visibility into the status of your flow and task runs. From the dashboard, you can filter results to explore specific run states, scheduled runs, and more. You can drill down into details about:

  • Flows
  • Deployments
  • Flow runs

When a Prefect API server is running, you can access the UI at http://127.0.0.1:4200. If you're running a local server or accessing a server running in a container or cluster, the default initial view is the dashboard.

Prefect UI dashboard.

The following sections discuss each section of the dashboard view.

Filters

The Filters area at the top of the page provides controls that enable you to display selected details of flow runs on the dashboard. Filters include date intervals, flow run state, flow name, deployment name, and tags.

Highlighting the filters section of the dashboard.

Flow run history

The run history area of the page provides an overview of recent flow runs by time and duration of run. Filters control the detail of what's shown in the Run history.

Highlighting the run history section of the dashboard.

Flow run details

The flow run details area of the page provides a listing of flow runs that are scheduled or have attempted to execute.

You can select any flow name or flow run name on the list to display further details. See the Flows and Tasks documentation for more information.

Highlighting the details section of the flow runs page.

The default view shows all flow runs observed by the Prefect API and scheduled flow runs for deployments. You can use filters to display only the flow runs that meet your filter criteria, such as status or tags.

Each row in the flow run details shows information about a specific completed, in progress, or scheduled flow run.

Information displayed for a flow run in the UI

For each flow run listed, you'll see:

  • Flow name
  • Flow run name
  • Tags on the deployment, flow, or tasks within the flow
  • State of the flow run
  • Scheduled or actual start time for the flow run
  • Elapsed run time for completed flow runs
  • Number of completed task runs for the flow

You can see additional details about the flow by selecting the flow name. You can see detail about the flow run by selecting the flow run name.

Inspect a flow

If you select the name of a flow in the dashboard, the UI displays details about the flow.

Details for a flow in the Prefect UI

If deployments have been created for the flow, you'll see them here. Select the deployment name to see further details about the deployment.

On this page you can also:

  • Copy the ID of the flow or delete the flow from the API by using the command button to the right of the flow name. Note that this does not delete your flow code. It only removes any record of the flow from the Prefect API.
  • Pause a schedule for a deployment by using the toggle control.
  • Copy the ID of the deployment or delete the deployment by using the command button to the right of the deployment.

Inspect a flow run

If you select the name of a flow run in the dashboard, the UI displays details about that specific flow run.

Display details for a specific flow run.

You can see details about the flow run including:

  • Flow and flow run names
  • State
  • Elapsed run time
  • Flow and flow run IDs
  • Timestamp of flow run creation (time of flow run for ad-hoc flow runs, or time when the deployment was created or updated for scheduled deployments)
  • Flow version
  • Run count
  • Infrastructure used by the flow run
  • Tags
  • Logs
  • Task runs
  • Subflow runs
  • Radar view of the flow run

Logs displays all log messages for the flow run. See Logging for more information about configuring and customizing log messages. Logs are the default view for a flow run.

Task Runs displays a listing of task runs executed within the flow run. Task runs are listed by flow name, flow run name, and task run name.

Display all task runs.

Sub Flow Runs displays any subflows for the flow run.

Display any subflow runs for the parent flow run.

Radar view

When viewing flow run details, the Radar shows a simple visualization of the task runs executed within the flow run. Click on the Radar area to see a detailed, hierarchical visualization of the task execution paths for the flow run.

Zoom out to see the entire flow hierarchy, and zoom in and drag the radar around to see details and connections between tasks. Select any task to focus the view on that task.

Radar view of flow and task relationships.

Troubleshooting flows

If you're having issues with a flow run, Prefect provides multiple tools to help you identify issues, re-run flows, and even delete a flow or flow run.

Flows may end up in states other than Completed. This is where Prefect really helps you out. If a flow ends up in a state such as Pending, Failed, or Cancelled, you can:

  • Check the logs for the flow run for errors.
  • Check the task runs to see where the error occurred.
  • Check work queues to make sure there's a queue that can service the flow run based on tags, deployment, or flow runner.
  • Make sure an agent is running in your execution environment and is configured to pull work from an appropriate work queue.

If you need to delete a flow or flow run:

In the Prefect UI or Prefect Cloud, go the the page for flow or flow run and the select the Delete command from the button to the right of the flow or flow run name.

From the command line in your execution environment, you can delete a flow run by using the prefect flow-run delete CLI command, passing the ID of the flow run.

$ prefect flow-run delete 'a55a4804-9e3c-4042-8b59-b3b6b7618736'

To get the flow run ID, see Inspect a flow run.