Configuring Dashboard Scope

Dashboard and panel scope acts as a filter for the data that will be displayed on the dashboard.

The scope can be set at a dashboard-wide level, or overridden for individual panels, by any user type except for the users with View Only access.

For more information on how scopes work, refer to the Using Labels documentation.

Edit Scope

To configure the scope of an existing dashboard, click the Edit Scope link in the top right of the Dashboard page:

Scope editor restricts the scope of the selection for subsequent filters by rendering values that are specific to the selected labels. For example, if the value of the kube_namespace_name label is kube-system, the values of the subsequent label, container_name will be filtered by kube-system. This means the containers rendered for filtering are only those that are part of the kube-system namespace.

Edit Variables

Dashboard scope values can be defined as variables, allowing users to reuse them in PromQL queries.

Configure Panel Scope

To configure the scope of an existing dashboard panel:

  1. From the Dashboard module, select the relevant dashboard from the dashboard list.

  2. Click Edit (pencil) icon:

  3. From the query field associated with the metric, click Scope.

  4. Select the labels either by clicking the desired label, or searching for the label, then clicking it.

  1. Select one or more label values.

  2. Optionally, apply panel scope to all the queries.

  3. Click Save to confirm the changes.