Skip to main content
Version: 0.10

Dashboards

Dashboards is the first entry in the sidebar and the screen a tenant opens on. It shows charts (widgets) over the tenant's assets: how many there are, what they run, who discovered them, how the inventory has grown.

Viewing dashboards needs the tenant permission Dashboards (read). See Roles and permissions.

Where dashboards come from​

Dashboards are provided by the platform. You do not build or edit them in the console:

  • Every new tenant gets a General dashboard: asset totals per type, assets created over time, host types, operating system vendors, assets discovered in the last seven days and how many have owners.
  • Some integrations add a dashboard of their own when you connect them, for example Nessus agents, Azure users and Atlassian users. Connecting another instance of the same integration updates that dashboard to the latest version instead of adding a second copy.

When a tenant has more than one dashboard, each is a tab above the widgets, and the active dashboard's description is shown beside the tabs. The tab is part of the address (?tab=general), so a link opens the same dashboard.

If the tenant has no dashboard at all, the screen says No dashboards yet.

note

Dashboards can be deleted through the API by a user with Dashboards (write). The console has no control for it, and there is no way to restore a deleted platform dashboard other than connecting an integration that provides it again.

Widgets​

Each widget counts assets of one type, grouped or filtered by the widget's own query. The widget kinds are:

KindShows
FigureA single number, such as total endpoints
GaugeA score on a 0 to 100 scale, coloured by band
Donut, pieShares of a total, with the smallest groups folded into Other
Horizontal bar, vertical bar, lineCounts per value of a field
Date histogramCounts over time

A widget of a kind this version of the console cannot draw shows a placeholder instead, and the rest of the dashboard still works.

Scope every widget​

The bar above the widgets narrows every widget on the dashboard at once:

  • Search (Scope every widget: search assets…) takes the same query syntax as the asset lists. See Assets.
  • Filter chips add conditions on fields. A chip can be edited, inverted (to exclude what it matches), switched off without removing it, or removed. A chip the dashboard cannot apply is shown switched off rather than ignored.

The search and filters are kept in the address, so a scoped dashboard can be shared as a link, survives a reload, and the browser's back button undoes the last change. They stay in place when you move to another dashboard tab, because every dashboard covers the same tenant's assets.

Drill down​

Click a bar, a slice, a point or a figure to open a menu for what it stands for:

OptionEffect
Filter to thisAdds the clicked value as a filter, so every widget shows only those assets
Filter this outAdds it as an excluding filter
Open in inventoryOpens the matching asset list in a new browser tab, with the dashboard's current search and filters applied

An Other group folds many small values together, so it cannot be drilled into.

Refresh​

Widgets load when you open the dashboard. Click Refresh to fetch every widget again. Refreshing also moves relative time windows, such as "the last 7 days", up to the current time.

Getting-started card​

While your tenant's setup is unfinished, a Getting started card at the top of the dashboard names the next step. See Getting-started guide.