You are viewing an outdated version of the documentation.

This documentation is for an older version (1.4.7) of Dagster. You can view the version of this page from our latest release below.

Dagster UI#

The Dagster UI is a web-based interface for viewing and interacting with Dagster objects.

You can inspect op, job, and graph definitions, launch runs, view launched runs, and view assets produced by those runs.


Launching the UI#

The easiest way to launch the UI from the command line during local development is to run:

dagster dev

This command launches both the Dagster webserver (which serves the UI) and the Dagster daemon, allowing you to start a full local deployment of Dagster from the command line.

The command will print out the URL you can access the UI from in the browser, usually on port 3000.

When invoked, the UI will fetch definitions - such as assets, jobs, schedules, sensors, and resources - from a Definitions object in a Python module or package or the code locations configured in an open source deployment's workspace files. Refer to the Code location documentation for more info.

You can also launch the webserver by itself from the command line by running:

dagster-webserver

Note that several Dagster features, like schedules and sensors, require the Dagster daemon to be running in order to function.


These are the main pages inside the UI:

Jobs#

The Job page offers tools to explore a job definition and launch runs for that job.

Overview tab#

The Overview tab shows the graph of ops that make up a job.

Job definition#

In this tab, you can view the definition of a job:

UI Job Definition
Op definition#

To view detailed information about an op in the job, click an op to open a panel on the right side of the page:

UI Op Definition

Runs#

All runs#

The Runs page lists all job runs, which can be filtered by job name, run ID, execution status, or tag. Click a run ID to open the Run details page and view details for that run:

UI Runs page

Assets#

Asset catalog#

The Asset catalog page lists all assets, which can be filtered by asset key. Click an asset to open the Asset details page:

UI Asset Catalog

Schedules and sensors#

Schedules#

The Schedules page lists all schedules defined in your workspace, as well as information about upcoming ticks for anticipated scheduled runs.

Click a schedule to view details about the schedule, including its recent tick history and recent runs.

UI Schedules page

Deployment overview#

The Deployment overview page includes information about the status of the code locations in your deployment, daemon (Open Source) or agent (Cloud) health, schedules, sensors, and configuration details:

UI Deployment overview page