Skip to content

Dashboards and saved queries

Dashboards and saved queries keep useful OQL out of chat history and incident notes. Use saved queries for reusable shortcuts. Use dashboards for panels that refresh with the active scope.

Use Explore for scratch work. When a query is useful:

Dashboards screen showing saved dashboard cards and panel previews.

  1. Save reusable query shortcuts as saved queries.
  2. Pin dashboard panels for queries that refresh with dashboard scope.
  3. Edit dashboard panel queries as OQL.

Dashboard documents use the oriel.dashboard/v1 schema and are versioned in the metadata store. Dashboard versions keep previous specs for export and recovery.

Action Permission
View dashboards dashboards:read
Create or edit dashboards dashboards:manage
Create or delete saved queries queries:manage
Run underlying telemetry queries telemetry:query
  • Open a dashboard panel in Explore to refine it.
  • Pin a query from Explore to an existing dashboard.
  • Use dashboard panels as starting points for alert rules.
  • Keep dashboards scoped by the app hierarchy instead of embedding one-off environment filters in every query.