Skip to main content

Monitored Dashboards

Plan Restriction

Dashboard monitoring is available on the Pro plan and above (see Plans Comparison).

Per-dashboard monitoring tracks query performance, detects errors and slow queries, and sends email alerts, so you can maintain a great experience for your dashboard users.

Dashboard monitoring builds on top of the Datasource Performance & Insights feature by scoping metrics to the specific queries used by a dashboard, including both report queries and filter queries.

The same tab also carries the dashboard's usage — who has been opening it, and how often — which needs no monitoring to be enabled.

Enabling Monitoring​

To enable monitoring for a dashboard, open the dashboard settings and navigate to the Monitoring tab.

image-500 image-500

The Monitoring tab has three settings:

  • Dashboard Monitoring — The main toggle that enables collection of execution activity data (success/error/timeout counts, query durations) for the dashboard's queries. This data powers the Performance & Insights charts.

  • Trigger Email Alerts — When enabled, query errors and slow queries trigger email notifications. For published dashboards, all admins and analysts in the organization receive the alerts. For draft dashboards, only the dashboard owner receives them. Alerts are automatically resolved when no errors or slow queries are detected for 30 minutes and at least one successful query execution has occurred.

  • Slow Query Monitoring — When enabled, queries that exceed the configured threshold (in seconds) are flagged as slow queries. The default threshold is 30 seconds and can be adjusted between 10 and 1200 seconds (20 minutes).

tip

Each organization can monitor up to 2 dashboards on the Pro plan and up to 10 dashboards on the Business plan. Enterprise plans have no limit.

Performance & Insights​

The Performance & Insights tab on the dashboard card shows activity charts and query metrics scoped to the dashboard's queries.

Performance & Insights Performance & Insights

You can access Performance & Insights from:

  • The Manage Sharing page for a dashboard (Settings > Dashboards & Sharing Links > select a dashboard)
  • The Performance & Insights link in the dashboard dropdown menu
  • The dashboard list in Settings, by clicking on a monitoring status badge

Activity Tab​

The Activity tab shows three charts:

  • Dashboard Access — Shows how many unique users, API keys, and sharing link tabs accessed the dashboard over time, along with scheduled refresh and prewarm events.

image-500 image-500

  • SQL Completed — Shows the number of completed query executions, color-coded by result: success (green), error (red), and timeout (orange).

  • SQL Duration — Shows minimum, average, and maximum SQL query durations, color-coded by speed.

Use the time range selector to switch between predefined ranges (30 minutes to 30 days) or click and drag on a chart to zoom into a specific time period. The 30-minute and 1-hour ranges update automatically as new data arrives.

Slow Queries Tab​

When slow query monitoring is enabled, the Slow Queries tab shows all queries that exceeded the configured duration threshold in the selected time range.

The tab works identically to the Datasource Slow Queries view, but filtered to only the queries belonging to this dashboard. Click on a query to see its details, or use Group Same SQL & Filters to identify recurring slow query patterns.

Query Errors Tab​

The Query Errors tab shows all query failures in the selected time range. Like slow queries, this view is filtered to the dashboard's own queries.

Click on an error to see the full details including the executed SQL, parameters, and other affected objects. Use Group Same Error Message to identify the most frequent errors.

Email Alerts​

When email alerts are enabled, a query error or slow query on the dashboard triggers a notification.

image-400 image-400

Notification Schedule​

Alert emails follow an escalating backoff schedule to avoid flooding your inbox:

NotificationsInterval
1-3Every 5 minutes
4-7Every 1 hour
8+Every 24 hours

Each alert email includes:

  • A summary of the errors and/or slow queries detected
  • The affected reports and filters
  • An Investigate button that opens Performance & Insights with the alert time range pre-selected
  • An Acknowledge button to silence further notifications

Alert Lifecycle​

Alerts go through the following states:

  1. Active — An alert is created when the first error or slow query is detected. The first notification email is sent immediately.

  2. Acknowledged — Click Acknowledge to silence email notifications while you investigate. The alert stays active but no further emails are sent. You can Unacknowledge at any time to resume notifications.

  3. Auto-resolved — When no errors or slow queries are detected for 30 minutes and at least one successful query execution has occurred, the alert is automatically resolved. A resolved notification email is sent.

  4. Manually resolved — Click Resolve to clear the alert manually. This also clears the notification history and resets the backoff schedule.

  5. Reopened — If an auto-resolved alert recurs within 2 hours, the same alert is reopened rather than creating a new one. A reopened notification email is sent, and the backoff schedule continues from where it left off.

image-400 image-400

note

Disabling email alerts or monitoring on a dashboard automatically resolves any active alert.

Alert Badge​

When a dashboard has an active alert, an Alert badge appears in the dashboard's header on its monitoring card, next to the Published / Draft badge.

image-500 image-500

  • A red badge indicates an active, unacknowledged alert
  • A yellow badge indicates an acknowledged alert

Click the badge to open the dashboard's Alert tab, where you can review the affected reports and acknowledge or resolve the alert.

The badge updates automatically as the dashboard's monitoring status is polled, and disappears when the alert is resolved.

Alert Tabs​

The dashboard card shows a monitored dashboard's alerts on two tabs: Alert, which shows its current alert state and any alert that is open, and Resolved Alerts, for those that have closed in the last 30 days.

Alert​

The tab's label says the dashboard's alert state:

  • Alert (Active) — an alert is open and emails are being sent
  • Alert (Acknowledged) — an alert is open, and emails are silenced
  • Alert (Datasource) — the dashboard is failing because its datasource is unreachable, and the datasource's alert covers it
  • Alert (OK) — email alerts are on and nothing is failing
  • Alerting — email alerts are off

An open alert shows when it started and how many emails it has sent, and the reports and filters it affects, each with its issue and details. Its buttons are Investigate, which opens Performance & Insights for the alert's time range, Acknowledge… (or Unacknowledge…) and Resolve….

Resolved Alerts​

The tab appears once one of the dashboard's alerts has closed, labelled with how many, for example Resolved Alerts (3). Each alert shows when it Started, when it was Resolved and by whom (or that it was auto-resolved), its Duration and Details, which summarize what failed, such as "1 report with errors". Click an alert to expand it and see the reports and filters it affected. From there, Investigate opens Performance & Insights for the alert's time range, and Show Query Errors and Show Slow Queries open those tabs for it.

Resolved Alerts Resolved Alerts

Dashboards List​

The Settings > Dashboards & Sharing Links page provides an overview of all dashboards with their monitoring status.

Dashboards List Dashboards List

The Status column shows:

  • Alert (red) — Active unacknowledged alert
  • Alert (yellow) — Acknowledged alert
  • OK (green) — Monitoring enabled, no issues

Click on a status badge to navigate directly to that dashboard's Performance & Insights view. Sort by the Status column to quickly find dashboards with active alerts.

Alert Periods on Charts​

When viewing the Activity charts, alert periods are shown as semi-transparent red overlays on the Completed and SQL Duration charts. This helps you correlate query performance with alert incidents.

Use the Select alert time range link in the alert banner to zoom the charts to the current alert's time range.