Skip to main content

Create Explore Dashboards

In Rill, Explore dashboards are used to visually understand your data with real-time filtering, based on the dimensions and measures defined in your metrics view. In the Explore dashboard YAML, you can define which measures and dimensions are visible, as well as the default view when a user sees your dashboard.

tip

Starting in version 0.50, metrics views have been separated from Explore dashboards. This allows for a cleaner, more accessible metrics layer and the ability to build various dashboards and components on top of a single metrics view. For more information on what a metrics view is, please see: What is a Metrics View?

For migration steps, see Migrations.

  • metrics_view - A metrics view that powers the dashboard
  • measures - * Which measures to include or exclude from the metrics view; using a wildcard will include all.
  • dimensions - * Which dimensions to include or exclude from the metrics view; using a wildcard will include all.

When including dimensions and measures, only the named resources will be included. Rill also supports the ability to exclude a set of named dimensions and measures.

type: explore

title: Title of your Explore Dashboard
description: a description for your explore dashboard
metrics_view: my_metricsview

dimensions: '*' # can use expressions
measures: '*' # can use expressions

defaults: # define all the defaults within here, was default_* in previous dashboard YAML
    dimensions: 
    measures:
    ...

Define Dashboard Access​

Along with metrics views security policies, you can set access on the dashboard level. Access policies will be combined with metrics view policies using a logical AND, so if a user doesn’t pass both, they won’t get access to the dashboard. For more information, see Data Access for more information.

Dashboard Properties

For more details about available configurations and properties, check our Dashboard YAML reference page.

Preview a Dashboard in Rill Developer​

Once a dashboard is ready to preview, before deploying to Rill Cloud, you can preview the dashboard in Rill Developer. Especially if you are setting up dashboard policies, it is recommended to preview and test the dashboard before deploying.