Dashboard & Widgets

UI overview for the Databand application.

Dashboard

The Dashboard tab in the Databand web UI allows you to see the general aggregated information about the Pipelines, Runs, Tasks, Errors, etc. within the environment in one place at the same time with the help of our ever-growing collection of widgets.

You can control and filter the information in the Dashboard tab using Projects, Source, Pipeline, and Time range drop-down filters.

The Time range filter allows you to select the data period to view. You can use the available time-range presets or specify any custom range in the Custome view of the Date picker.
It’s possible to view the stats for up to infinite number of days into the past.

Widgets

The widgets are being constantly improved and frequently updated, and we also add new widgets often so the UI of the following widgets might differ slightly.

The sum total of the stats displayed in the widgets is for the failed, successful, and running, and other states of Tasks and Pipelines combined.

Remember that all the charts you see in the Dashboard tab and its widgets are cumulative and display the combined quantity of all the possible states, for example failed, success, and running states for Runs in the Runs by Start Time widget.

Task Runs State

This widget consists of two smaller widgets - Runs in Total and Task Runs.

This widget displays the overall counters and stats for Pipelines - how many Runs have been successful and how many have failed, how many Pipelines and Tasks are running at the moment, etc.

Runs have the following possible states:

  • RUNNING - "running"
  • SUCCESS - "success"
  • FAILED - "failed"
  • SHUTDOWN - "shutdown"
  • CANCELLED - "cancelled"

Tasks have the following supported states:

  • SUCCESS - "success"
  • REUSED - "reused"
  • RUNNING - "running"
  • FAILED - "failed"
  • SHUTDOWN - "shutdown"
  • CANCELLED - "cancelled"
  • REMOVED - "removed"
  • QUEUED - "queued"
  • UP_FOR_RETRY - "up_for_retry"
  • UPSTREAM_FAILED - "upstream_failed"
  • SCHEDULED - "scheduled"
  • UNKNOWN - "unknown"

Runs and Tasks by Start Time

These two widgets display what the runtime states look like at a given moment.

When you select a time range, the charts display shows how many failed, successful, or running Runs took place during the selected time period.

Runs have the following possible states:

  • RUNNING - "running"
  • SUCCESS - "success"
  • FAILED - "failed"
  • SHUTDOWN - "shutdown"
  • CANCELLED - "cancelled"

Tasks have the following supported states:

  • SUCCESS - "success"
  • REUSED - "reused"
  • RUNNING - "running"
  • FAILED - "failed"
  • SHUTDOWN - "shutdown"
  • CANCELLED - "cancelled"
  • REMOVED - "removed"
  • QUEUED - "queued"
  • UP_FOR_RETRY - "up_for_retry"
  • UPSTREAM_FAILED - "upstream_failed"
  • SCHEDULED - "scheduled"
  • UNKNOWN - "unknown"

Top Errors

This widget displays the 5 Error Types that have been encountered most frequently in the recent Runs. The widget also displays where and when did such Error Types took place.

Pipeline Stats

This widget displays DAGs that contain the longest Runs (by duration).

Favorite Metric

In this widget, you can select the metrics that you have favorited in Runs > Trends and have them displayed in the Dashboard as the most relevant Favorite Metrics at the moment.

The widget “remembers” the previous selected Favorite Metric in the DAG. So if you select a Favorite Metric for display, then switch to a different DAG, and then return to the original DAG, it will display the same Favorite Metric it displayed before.

In the future releases, you’ll be able to add several metrics to the Favorite Metric widget. 


Last Active

This widget displays the last 10 Runs and Tasks that have recently ended, alongside with their Status, Run name, Pipeline, Source, Duration, Progress, and Scheduled Date.

If you click “All runs” in this widget, you will be taken to the lists of all runs that took place during the selected time period.


What’s Next
Did this page help you?