Build a Custom Report

Built-in Analytics reports cover the most common questions, but your organization has its own. Custom reports let you compose exactly the pages and visualizations you need, from the same live data that powers the built-in reports.

Start a report

There are two ways to start:

• Duplicate a built-in report. Open any built-in report and select Duplicate to Edit. Mondoo creates a copy of the report and opens it in the editor. This is the fastest path: keep the pages you want, remove the rest, and add your own. You can also duplicate one of your custom reports from its card on the Analytics page.
• Start from scratch. On the Analytics page, select New Report. Give the report a title and an optional description, then select Create.

Your custom reports appear alongside the built-in reports on the Analytics page, with the date they were last updated.

How a report is structured

A report is a deck of pages. Each page has a layout that divides it into tiles, and each tile holds one visualization: a chart, a metric, or a table. The editor shows the whole deck in one scrolling view, with these controls:

• Save stores your changes.
• History shows the report's version history.
• Deck preview shows each page framed as a presentation slide.

To rename the report or edit its description, select the report title.

Add and arrange pages

Select Add Page at the bottom of the editor and choose a layout: a single tile, column and stacked arrangements of two or three tiles, or grids up to 3×3 tiles. The new page appears at the end of the deck with an empty tile for each spot in the layout.

To change an existing page, open the Page actions menu on that page:

• Edit Title & Description renames the page and sets the text shown under its title.
• Move Up and Move Down reorder the page within the deck.
• Change Layout switches the page to a different tile arrangement.
• Remove Page deletes the page and its visualizations.

Add a visualization

Select Add Visualization in any empty tile to open the visualization editor. Building a visualization has two parts:

• Query Builder defines the data. Open the Schema Browser and select the measures and dimensions to include. Add filters to narrow the results, set a row limit, then select Run Query to preview the data. You can work visually or switch to the JSON view of the query.
• Chart Settings defines the presentation: the visualization type (such as a bar chart) and its display options.

Select Save Changes to place the visualization in the tile. To revise or remove one later, use the Visualization actions menu on the tile and select Edit or Remove.

Example: build a donut of open CVEs by severity

To see how the Query Builder and Chart Settings work together, build a donut that breaks your open CVEs down by severity:

1. On a report page, select Add Visualization in an empty tile.
2. In the Query Builder, open the Schema Browser. Under Vulnerability Scores, select Count as the measure and CVSS Severity as the dimension. Each row is now one severity with its CVE count.
3. Select Run Query to preview the results.
4. Open Chart Settings and set the visualization type to Donut. Each slice is one severity, sized by its share of the total.
5. Select Save Changes to place the donut in the tile.

To answer a different question, swap the dimension or add a filter and run the query again. The same few steps build any chart in a report.

Export a custom report

Custom reports export exactly like built-in reports: Copy PNG copies a page to your clipboard as an image, PPT downloads the report as a PowerPoint deck with one slide per page, and Export on any table downloads its data. To learn more, read the Analytics overview.

Delete a report

To delete a custom report, hover over its card on the Analytics page and select the Delete button, then confirm. Deleting a report is permanent; it can't be undone. Built-in reports can't be deleted.