Using dashboards

Dashboards are customizable visual views into your asset inventory. You can create them for different use cases such as compliance, vulnerability remediation, or asset visibility.

Visualization widgets show operational information, trends, insights, goals, sources, and most and least seen graphs. You can also build your own custom widget from queries to show exactly the data you want, as a trend line or a latest count.

Filter the dashboard data by site and time bucket with the dropdown buttons at the top of the dashboard.

In Edit Mode you can customize the arrangement and size of each widget, and the widget library lets you add or remove widgets.

Dashboard selection

The dashboard selector button at the top of the dashboard shows the current dashboard’s name. Click it to open a menu of runZero-managed dashboards, any shared dashboards, and your personal customized dashboards, then click the name of the dashboard you want to view.

Creating dashboards

To create a personal dashboard, click the dashboard selector, then “Create new dashboard”. runZero creates the dashboard and takes you straight into Edit Mode, where you can add, resize, and arrange widgets.

Customizing dashboards

To customize a personal dashboard, click “Edit” in the dashboard header. The dashboard enters “Edit Mode”, where you can resize, rearrange, add, and remove widgets.

In Edit Mode, resize a widget by dragging its bottom right corner.

Rearrange widgets by dragging the widget heading area, where the mouse cursor turns into a “cross-hair” icon.

When the layout looks right, click “Save”. The dashboard keeps that layout, so the information you want is there every time you visit.

To revert instead, click “Cancel” to discard your changes. The visibility, arrangement, and size of every widget return to how they were before you started editing.

Sharing dashboards

Share a dashboard with any number of organizations by clicking “Share”. In the dialog, select the organizations to share with and click “Done”.

When another user shares a dashboard with your organization, it appears under “Shared with me” in the dashboard selector.

Dashboards you share still appear under “My dashboards”. Only you can modify them, but other organization users may duplicate them.

To share a read-only snapshot of a dashboard with someone outside runZero, use external reporting instead. On shareable dashboards, the Share button creates an email-gated public link, optionally on a recurring schedule.

Duplicating dashboards

A runZero-managed dashboard, or one shared with your organization, can’t be modified directly, but you can click “Duplicate” to make a copy you can customize.

You can also duplicate any dashboard from the menu button at the top of the dashboard by selecting “Duplicate dashboard”. A dialog opens where you can name the new dashboard to tell it apart from the original.

Sharing settings from the original dashboard are not copied to the new one.

Default dashboards

Set any dashboard as your preferred dashboard by clicking the dashboard menu button and selecting “Set as my preferred dashboard”.

An organization admin can set the default dashboard for every user of the selected organization with the “Set dashboard as organization default” option. In the dialog, the “Override user-preferred dashboard” checkbox makes the organization default win over each user’s preferred dashboard. With that override in place, users see their own preferred dashboard only if the organization has no default dashboard set to override it.

Deleting dashboards

To delete a custom dashboard, click the menu button at the top of the dashboard, select “Delete dashboard”, and confirm in the dialog. Deletion cannot be undone.

Widget library

Use the dashboard widget library to add and remove widgets. Open it with the “Widgets” button at the top right of the dashboard.

The library lists every available widget. You can also create your own custom widget from queries.

Widgets already on the dashboard carry a checkmark icon. Click one to deselect it, and it leaves the dashboard when you click “Save”.

Click a widget that isn’t on the dashboard to select it, then save to add it.

Widget types

Operational information

• Live assets: number of assets currently alive based on the latest scans
• Active scans: number of scans currently in progress
• Explorers online: number of Explorers reporting as healthy
• Accounts: number of users with access to your console

Trends

• Asset trends: timeline of asset counts broken out by live, recent, and a couple of other states
• Service trends: timeline of network services seen in your environment

Insights

• Latest insights: automated queries that ran after your latest scan, with result counts

Most and least seen graphs

Asset views by different asset properties. You can toggle each graph between most and least seen by count.

• Asset types
• Operating systems
• Hardware
• RRT latency
• MAC vendors
• Newest MAC age
• TCP ports
• UDP ports
• Products
• Protocols
• Address count
• Extra address count
• Risk
• Criticality
• Tags

Goals

• Goals overview: summary of every goal pinned to the dashboard

Asset count and trend tables

The latest count and historical timeline for your assets by ownership coverage, source type, and custom integration.

• Asset ownership: view of all ownership types, including assets missing owners
• Asset sources: view of all sources of asset data from supported integrations
• Custom integrations: view of all custom sources of asset data from API integrations

Bookmarks

A customizable list of frequently visited pages, favorite reports, or external links. After adding the widget to your dashboard, manage the list from the menu button at the top of the widget.

To edit a bookmark, select “Edit bookmarks”, pick the bookmark from the list in the dialog, update the name or URL below it, and save. To remove one, click the trash can icon in the list.

To add a bookmark, select “Add bookmark”, enter a name and URL, and save. Bookmarks to external sites open in a new window; internal console URLs open in the current window.

When viewing a report or browsing the list of reports, click the bookmark ribbon icon to add that report to your bookmarks. Click the ribbon again to open the editing dialog and remove it.

Custom widgets

Click “Create widget” in the widget library to build a custom widget of one of these types:

• Single match count shows the most recent match count for a given query.
• Single match trend charts the history of a given query.
• Multi-query match count shows the most recent match count for 2 or more queries, displayed like the Organization overview widget.
• Multi-query trend line charts the history of 2 or more queries.
• Custom text widget shows custom Markdown-formatted text, for extra context or information on the dashboard.
• Goal progress overview shows a summary and current progress toward completion for a single goal.

For a single-query widget, you choose a name, a query, and a color for the results. For a multi-query widget, you choose a name for the widget itself and a name and color for each query.

Any custom widget that displays as a trend chart can be exported to JPG, PNG, or SVG from the menu button at the top right of the widget on your dashboard.

After creation, manage custom widget templates in the widget library with the icons at the bottom of each widget’s preview image. When you update a custom widget, runZero asks whether to update the widget on the dashboard too. When you delete one, it asks whether to remove it from the dashboard too.

Drill down

Except in timeline-based charts, you can view any widget’s distinct data points in detail by clicking the relevant table row links or buttons, or individual segments of donut, bar, or column charts.

Printing and exporting

Chart-based widgets export to SVG, PNG, and JPEG, and table-based widgets export to CSV. Use the menu button at the top of the widget and pick the format.

Print the entire dashboard and all of its widgets with the printer icon at the top of the dashboard. For best results, use a Chromium-based browser or Firefox with the ‘Print backgrounds’ option enabled.

Recalculate metrics

Dashboard widgets, query results, and saved-query counts come from metrics that runZero recomputes after every scan, integration sync, and scheduled metrics task. If you just imported data, edited tags (including geo* location tags or manual category overrides), or changed asset criticality and want the dashboard, World Map, and saved-query counts to reflect it right away, click the dashboard menu button and select Recalculate metrics. runZero queues a one-shot metrics task and refreshes the dashboard when it completes.

Themes

The runZero console ships with three themes: Classic, Light, and Dark. Choose yours on the Account > Preferences page. Theme selection is per-user and applies to every dashboard, report, inventory view, and the Network and World Maps.

Display mode

Theater (or kiosk) mode hides the navigation menus and shows only the dashboard content. To enter it, click the menu button at the top of the dashboard and select “Enter theater mode”.

In theater mode, the Fullscreen button at the top of the page fills the screen with the dashboard. Press Escape or click Exit fullscreen to return to theater mode.

To leave theater mode, click the X icon.