Widget reference¶
This page describes all widgets you can place on the dashboard page — in your own dashboards as well as in the customized overview. The catalogue in edit mode groups them into State, Problems, History, Devices & tenants, Metrics, Logs and Content.
Common settings¶
Clicking a widget in edit mode opens its settings. What a widget offers depends on its purpose; these are always operated the same way:
| Area | Content |
|---|---|
| Data selection | Tenants (always multiple selection, empty = all visible), folders (with subfolders), profiles, tags, check types, devices, individual checks and exclusions — each also via variables. Device and check selection searches on the server and shows checks with their device. |
| Time range | own time range or the dashboard's (only for widgets that show history) |
| Frame and header | title, frame, header on/off |
| Colours | every colour states its criterion; the widget's info button shows data selection, time range and colour meaning |
| Count, order, click target, columns | where available, in the same place and with "Reset" |
Data always follows the viewer's permissions. If a query fails, the widget shows the error with "Retry".
Time-weighted: metrics (mean, minimum, maximum, sum) take into account how long a value was valid — not the number of stored data points. Up to three days are computed exactly from raw data, beyond that from the hourly or daily aggregates; minimum, maximum and sum stay the same quantity.
Many series: graph and heatmap show the most important series when there are very many matches (default 200, configurable up to 1000 — worst status and highest value first) with the note "N of M shown — most important first".
State and problems¶
The built-in overview consists of the widgets of this and the next section; each can also be placed in your own dashboard. All can be narrowed to a subset via the data selection.
| Widget | Content | Settings include |
|---|---|---|
State (summary_state) |
Share of OK in (OK + problems), status bar, counters linking into the error overview. Downtime and Accepted do not count as problems. | orientation and scale of the bars, which status segments appear |
Open problems (summary_problems) |
Problem list as in the error overview, tabs Open · ACK · Accepted | several areas with their own filters (the same filter interface as the error overview), columns, areas side by side, count, order (newest or worst status first) |
The former status overview, the pie chart (status distribution) and the problems widget of older dashboards are converted into these two widgets when loaded.
History¶
| Widget | Content | Settings include |
|---|---|---|
Status changes (summary_activity) |
changes per hour; clicking a bar opens the changes of that hour | time window, counting mode |
Noisiest checks (summary_noisiest) |
checks with the most changes (default 7 days, top 5) | period 1 hour to 30 days, count 1–20 |
Timeline (status_timeline) |
status of selected checks over time — one strip per check | time slice (default 1 h), worst or last status per slice. With very many slices (time range / width x checks above 100,000) the server picks the next coarser step itself; the widget then shows "Resolution ...". |
Check History (check_history) |
stored results of selected checks, raw or per time slice | slice raw, 5 m, 15 m, 30 m, 1 h, 6 h, 12 h, 1 d (default), 7 d, 1 month; worst or last status; order; decimals |
Devices and tenants¶
| Widget | Content | Settings include |
|---|---|---|
Devices (summary_devices) |
devices with status bars; devices can be pinned to the top | count (default 60, at most 200), sorting (worst first), grouping by tenant or profile, only devices with problems, column width |
Tenants (summary_tenants) |
state per tenant; omitted with only one tenant | sorting, count, show device count |
Inventory (summary_inventory) |
hosts, agents, collectors, newly found devices — every number a link | additionally checks, running downtimes, active ACKs |
The former host overview (host tiles) of older dashboards is loaded as Devices.
Metrics¶
| Widget | Content | Settings include |
|---|---|---|
Number (stat) |
one value, large — from a check, several combined or as a status count | source (one check / group / status), aggregation (default "last value"), decimals (1), small history below (on), colour thresholds |
Gauge (gauge) |
one value on a scale with coloured bands | scale (0–100), unit, decimals, colour bands (default WARNING from 70, CRITICAL from 90) |
Graph (line_chart) |
measurements over the period as lines | aggregation (default mean), fill area, stacked, show gaps, percent axis (default fixed 0–100 %, optionally fit to the values), number of series, unit, decimals |
Bars (bar_chart) |
current values compared, sorted and capped | horizontal (on), count (10, up to 100), sort direction |
Ranking (top_n) |
highest or lowest current values as a list | count (10), sort direction |
Heatmap (heatmap) |
values as a colour grid — per check over time or per hour and weekday | layout (automatic / time / week), cell size, number of series (200), colours |
Table (table) |
current state of each check | choose, order and rename columns (default host, service, status, value, last check; additionally unit, check type, tenant), sorting, decimals |
Anomalies (anomaly_list) |
anomalies with normal range and duration | count (20), minimum deviation, show anomalies marked as normal |
Capacity Forecasts (prediction_list) |
disks and series that will soon reach their limit — most urgent first, remaining time as a range | horizon (0/7/14/30/90 days) |
Anomalies and Capacity forecasts only appear in the catalogue when Anomalies & forecasts are switched on (default).
Logs¶
| Widget | Content | Settings include |
|---|---|---|
Global Log (system_log) |
the latest messages of the Global Log | the same filters as in the Global Log, count (15, 5–100) |
Log Stream (log_stream) |
latest raw logs of selected devices (file, journald, event log) — see Logs | device and check selection, minimum severity, count (50, 10–200) |
Content¶
| Widget | Content | Settings include |
|---|---|---|
Text / Note (text) |
Markdown note or section heading | size (XS–XXL, default S), alignment, surface, icon, centre vertically |
Link (link_button) |
button to a page, device, check, folder, tenant, dashboard, map or address | target (devices, dashboards etc. by ID — survives renaming), label, description, style; clickable addresses only http(s), mailto or relative |
In public links¶
In a public link Tenants, Inventory, Status changes, Noisiest checks, Devices and Global Log are left out entirely; all other widgets show the same values there as when logged in. A visitor can only narrow a widget's selection via free variables, never widen it.