Skip to content

Prefect UI & Prefect Cloud Overview

The Prefect UI provides an overview of all of your flows. It was designed around a simple question: what's the health of my system?

Prefect UI

There are two ways to access the UI:

  • Prefect Cloud is a hosted service that gives you observability over your flows, flow runs, and deployments, plus the ability to configure personal accounts, workspaces, and collaborators.
  • The Prefect Orion UI is also available as an open source, locally hosted orchestration engine, API server, and UI, giving you insight into the flows running with any local Prefect Orion instance.

The Prefect UI displays many useful insights about your flow runs, including:

  • Flow run summaries
  • Deployed flow details
  • Scheduled flow runs
  • Warnings for late or failed runs
  • Task run details
  • Radar flow and task dependency visualizer
  • Logs

You can filter the information displayed in the UI by time, flow state, and tags.

Using the Prefect UI

The Prefect UI is available via Prefect Cloud by logging into your account at https://app.prefect.cloud/.

The Prefect UI is also available in any environment where a Prefect Orion server is running with prefect orion start.

$ prefect orion start
Starting...

 ___ ___ ___ ___ ___ ___ _____    ___  ___ ___ ___  _  _
| _ \ _ \ __| __| __/ __|_   _|  / _ \| _ \_ _/ _ \| \| |
|  _/   / _|| _|| _| (__  | |   | (_) |   /| | (_) | .` |
|_| |_|_\___|_| |___\___| |_|    \___/|_|_\___\___/|_|\_|

Configure Prefect to communicate with the server with:

    prefect config set PREFECT_API_URL=http://127.0.0.1:4200/api

Check out the dashboard at http://127.0.0.1:4200

When the Prefect Orion server is running, you can access the Prefect UI at http://127.0.0.1:4200.

Prefect UI

The following sections provide details about Prefect UI pages and visualizations:

  • Flow Runs page provides a high-level overview of your flow runs.
  • Flows provides an overview of specific flows tracked by by the API.
  • Deployments provides an overview of flow deployments that you've created on the API.
  • Work Queues enable you to create and manage work queues that distribute flow runs to agents.
  • Blocks enable you to create and manage configuration for blocks such as storage.
  • Notifications enable you to create and manage alerts based on flow run states and tags.

Use the left side of the Prefect UI to navigate between pages.

Page Description
Flow Runs Displays the Flow Runs dashboard displaying flow run status for the current API server or Prefect Cloud workspace. From this dashboard you can create filters to display only certain flow runs, or click into details about specific flows or flow runs.
Flows Displays a searchable list of flows tracked by the API.
Deployments Displays flow deployments created on the API.
Work Queues Displays configured work queues and enables creating new work queues.
Blocks Displays a list of blocks configured on the API and enables configuring new blocks.
Notifications Displays a list of configured flow run state notifications and enables configuring new notifications.

In Prefect Cloud, the Prefect icon returns you to the workspaces list. Currently, you can create only one workspace per personal account, but you may have access to other workspaces as a collaborator. See the Prefect Cloud Workspaces documentation for details.

Prefect Cloud

Prefect Cloud provides a hosted server and UI instance for running and monitoring deployed flows. Prefect Cloud includes:

  • All of the features of the local Prefect UI.
  • A personal account and workspace.
  • API keys to sync deployments and flow runs with the Prefect Cloud API.
  • A hosted Prefect database that stores flow and task run history.

See the Prefect Cloud documentation for details about setting up accounts, workspaces, and API keys.