Adding tiles from presets

Pick metrics whose per-DBMS query is already settled — live sessions, slowest queries, storage — from the built-in catalog.

Availability check

Many presets simply fail without the right permission, extension or setting. So when the gallery opens, each preset runs one light probe query, and only the ones you can use right away are shown as enabled.

The ‘n of m ready’ count in the header is that result. After fixing a permission or a setting, check again with [Re-check availability].

A greyed-out card says why it cannot be used. Common reasons:

  • The pg_stat_statements extension is required (CREATE EXTENSION).
  • performance_schema must be enabled — MariaDB has it off by default.
  • Access to Oracle’s v$ dynamic performance views or to DBA views is required (SELECT_CATALOG_ROLE).
  • The SQL Server VIEW SERVER STATE permission is required.

If there are no presets for that DBMS yet, the list says so.

A greyed-out preset card with the reason it cannot be used

Skipping the availability check and adding everything would leave half the dashboard as red error tiles. Greyed-out cards cannot be selected.

Sets — several tiles from one query

A card with the set badge feeds several tiles from the result of a single query. The Session set, for example, reads the session list once and fills the active count (a number), the blocked count (a number) and the list (a table) together.

Keeping the same metric in separate tiles sends that many queries every cycle. A set reads once and shares, so with the Storage set what used to be seven full aggregations becomes one.

The card lists the tiles it will add, and a member that cannot be used on that DBMS is marked <strong>not on this DBMS</strong>.

To edit the settings of a set member you have to [Detach from set] — the tile then owns its own query, and one more query goes out per cycle.

A detached tile keeps the calculation the set was using (row count, one value of the first row, sum, ratio and so on) as its Computed value. Clearing it uses the result as-is.

A set preset card showing that one query produces several tiles

Presets are copied

Adding a preset copies its definition into a tile of your own. No link to the original remains, so edits you make to the SQL are not overwritten when the app updates.

TIP

Using a preset as a starting point and adapting the query to your environment is the intended way to work — adding a WHERE to the table-size preset so that it aggregates one schema only, for instance.