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 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.


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 Prefect 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
  • An interactive graph of your flow
  • 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

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.

Flow Run Graph

When viewing flow run details, the Flow Run Graph shows a simple visualization of the task runs and sub flow runs executed within the flow run. Each item on the graph displays the length of time that item took to run. Select items to see more details about them and to highlight the dependency path preceding and fallowing the selection.

Zoom and pan to explore the flow run in more detail. Controls in the bottom right allow you to recenter or view the graph in full screen mode, as well as control some options for how the graph is displayed.

Graph 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 pools 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 pool.

If you need to delete a flow or flow run:

In the Prefect UI or Prefect Cloud, go 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.

Flow run retention policy

Prefect Cloud feature

The Flow Run Retention Policy setting is only applicable in Prefect Cloud.

Flow runs in Prefect Cloud are retained according to the Flow Run Retention Policy setting in your personal account or organization profile. The policy setting applies to all workspaces owned by the personal account or organization respectively.

The flow run retention policy represents the number of days each flow run is available in the Prefect Cloud UI, and via the Prefect CLI and API after it ends. Once a flow run reaches a terminal state (detailed in the chart here), it will be retained until the end of the flow run retention period.

Flow Run Retention Policy keys on terminal state

Note that, because Flow Run Retention Policy keys on terminal state, if two flows start at the same time, but reach a terminal state at different times, they will be removed at different times according to when they each reached their respective terminal states.

This retention policy applies to all details about a flow run, including its task runs. Subflow runs follow the retention policy independently from their parent flow runs, and are removed based on the time each subflow run reaches a terminal state.

If you or your organization have needs that require a tailored retention period, contact our Sales team.