Custom Dashboard Component Options

Use the following options to configure custom dashboard components. For more information about dashboard component types, see Dashboard and Component Templates.

Tenable Security Center supports the following custom dashboard components:

Table, bar chart, pie chart, matrix, and line and area chart components can also use asset and finding data from Explore instead of the analysis tools. For more information, see Explore Data Source Options.

General Options

Configure the following options for all custom dashboard component types.

Option

Description

Default

Name

(Required) A name for the dashboard component.

--

Description

A description for the dashboard component. The description appears on the Dashboards page when you hover over a dashboard component.

--

Schedule

(Required for all except Matrix components) Specifies how often the component polls the data source to obtain updates:

  • Never — The component never polls the data source.

  • Minutely — Polls every 15, 20, or 30 minutes.

  • Hourly — Polls every 1, 2, 4, 6, or 12 hours.

  • Daily — Polls daily or every specified number of days at the specified time.

  • Weekly — Polls weekly or every specified number of weeks at the specified time.

  • Monthly — Polls monthly or every specified number of months at the specified day and time.

Caution: Excessively frequent updates may cause the application to become less responsive due to the added processing load imposed on the host OS.

Daily

Explore Data Source Options

In addition to the analysis tools, you can configure a dashboard component to display asset or finding data from Explore. To use an Explore data source, select Explore - Assets or Explore - Findings as the Type (or Data Type) option.

Note: Explore - Findings is a preview feature. Some functionality may change before general availability.

Availability

The following table shows which components support each Explore data source.

Component

Field

Explore - Assets

Explore - Findings

Table

Type

Yes

Yes

Bar chart

Type

Yes

Yes

Pie chart

Type

Yes

Yes

Matrix (each cell)

Data Type

Yes

Yes

Line and area chart (each series)

Data Type

--

Yes (Severity grouping only)

Component Options

When you select an Explore data source, the component form changes:

  • The Query, Source, and Tool options do not appear.

  • A Group By option and the Filters query builder appear below the Type option.

For information about the remaining options, see the options table for each component type.

Group By

The Group By option determines how the component groups the data. The available options depend on the data source.

Group By

Explore - Assets

Explore - Findings

Notes

None

Yes

Yes

No grouping. The data source returns one row per asset or finding. Available in table and matrix components only, where it is the default.

ACR Severity

Yes

--

(Requires Tenable Security Center+ license)

Asset

--

Yes

Asset Tag

Yes

Yes

CVE

Yes

Yes

IAVM

Yes

Yes

Microsoft ID

Yes

--

Network

Yes

--

When you select Network, a second drop-down box appears next to Group By where you select the network class: Class A (default), Class B, or Class C.

Operating System

Yes

Yes

Severity

--

Yes

The only option for line and area chart series.

System Type

Yes

--

Vulnerability

Yes

Yes

Groups the data by plugin (plugin ID and plugin name).

The default Group By option depends on the component:

  • Table and matrix components: None.

  • Bar chart and pie chart components: the first option in the list, because these charts require a grouping. For Explore - Assets, this is ACR Severity (or Asset Tag if you do not have a Tenable Security Center+ license). For Explore - Findings, this is Asset.

  • Line and area chart series: Severity.

For more information about the groupings, see Explore Assets and Using Group By Options on the Findings Page.

Filters

The Filters option is the same query builder that you use on the Explore pages. It supports the same operators (including NOT groups and wildcard operators such as contains, starts with, and ends with) and the same license requirements. For information about the available filters, see Asset Filters and Findings Filters.

  • The Asset Tag and Repository filters are not available in dashboard components for either data source. The Plugin Family filter is also not available for Explore - Findings.

  • If you do not define any filters, the component uses all of the data from the data source.

  • If a filter is incomplete or invalid, Tenable Security Center highlights it and you cannot save the component until you correct it.

  • If you change the Type between Explore - Assets and Explore - Findings, Tenable Security Center clears the filters.

Limitations

  • Explore - Findings components always use cumulative findings. You cannot chart mitigated findings from Explore.

  • Explore data sources are available in dashboard components only. They are not available in report elements, on the Add Query page, or in alerts, tickets, or Assurance Report Cards. You cannot send a dashboard that contains an Explore component to a report. For more information, see View a Dashboard.

  • Matrix cells that use an Explore data source do not open Explore when you click them.

Table Component Options

Option

Description

Default

Data

Type

The type of data: Vulnerability, Event, Mobile, User, Ticket, Alert, Explore - Assets, or Explore - Findings. For more information about Explore data sources, see Explore Data Source Options.

Vulnerability

Query

(Not available if Type is Explore - Assets or Explore - Findings.)

Predefined query used to further narrow down the data source options. If a query does not exist or is not desired, it may be left unselected. The query may be used as is or as a template on which to base the Filters option.

--

Source

(If Type is Vulnerability or Event) Specifies the data source.

For vulnerability data, select Cumulative or Mitigated.

For event data, the data source is Active. Tenable Security Center can use only active event data for event-based components.

Cumulative

Tool

(Not available if Type is Explore - Assets or Explore - Findings.)

The analysis tool to use for creating the chart. For more information, see Vulnerability Analysis Tools and Event Analysis Tools.

Vulnerability Summary

Group By

(If Type is Explore - Assets or Explore - Findings) How the data is grouped.

  • Explore - Assets: None, ACR Severity, Asset Tag, CVE, IAVM, Microsoft ID, Network, Operating System, System Type, or Vulnerability

  • Explore - Findings: None, Asset, Asset Tag, CVE, IAVM, Operating System, Severity, or Vulnerability

For more information, see Explore Data Source Options.

None

Filters

Additional filters to use on the data source. For more information, see Filters.

(If Type is Explore - Assets or Explore - Findings) Use the Explore query builder to define the filters that select the data to display. For more information, see Explore Data Source Options.

--

Display

Results Displayed

The number of displayed results. You can choose to display up to 999 results.

If the Viewport Size setting is smaller than this setting, the results display is limited to the Viewport Size setting with a scrollbar to display the additional results.

10

Viewport Size

The number of records (maximum: 50) to display along with a scrollbar to handle additional records. For example, if Results Displayed is set to 100 and Viewport Size is 15, 15 records are displayed with a scrollbar to view the additional 85 records.

10

Sort Column

(Not available if Type is Event) The column Tenable Security Center uses to sort the results.

Plugin ID

(If Type is Explore - Assets or Explore - Findings) The first column for the selected Group By.

Sort Direction

(Not available if Type is Event) The sort direction: Descending or Ascending.

Descending

Display Columns

The columns to display in the component output.

(If Type is Explore - Assets or Explore - Findings) The available columns depend on the selected Group By. All columns for the selected Group By are selected by default.

--

Bar Chart Component Options

Option

Description

Default

Data

Type

The type of data: Vulnerability, Event, Mobile, Ticket, Explore - Assets, or Explore - Findings. For more information about Explore data sources, see Explore Data Source Options.

Vulnerability

Query

(Not available if Type is Explore - Assets or Explore - Findings.)

Predefined query used to further narrow down the data source options. If a query does not exist or is not desired, it may be left unselected. The query may be used as is or as a template on which to base the Filters option.

--

Source

(If Type is Vulnerability or Event) Specifies the data source.

For vulnerability data, select Cumulative or Mitigated.

For event data, the data source is Active. Tenable Security Center can use only active event data for event-based components.

Cumulative

Tool

(Not available if Type is Explore - Assets or Explore - Findings.)

The analysis tool to use for creating the chart. For more information, see Vulnerability Analysis Tools and Event Analysis Tools.

Vulnerability Summary

Group By

(If Type is Explore - Assets or Explore - Findings) How the data is grouped.

  • Explore - Assets: ACR Severity, Asset Tag, CVE, IAVM, Microsoft ID, Network, Operating System, System Type, or Vulnerability

  • Explore - Findings: Asset, Asset Tag, CVE, IAVM, Operating System, Severity, or Vulnerability

For more information, see Explore Data Source Options.

The default is the first option in the list for the selected Type.

First option in list

Filters

Additional filters to use on the data source. For more information, see Filters.

(If Type is Explore - Assets or Explore - Findings) Use the Explore query builder to define the filters that select the data to display. For more information, see Explore Data Source Options.

--

Display

Results Displayed

The number of displayed results. You can choose to display up to 100 results.

10

Sort Column

(If Type is Vulnerability, Ticket, Explore - Assets, or Explore - Findings) The column Tenable Security Center uses to sort the results.

Plugin ID

(If Type is Explore - Assets or Explore - Findings) The first column for the selected Group By, which is usually the group name rather than a count.

Sort Direction

(If Type is Vulnerability, Ticket, Explore - Assets, or Explore - Findings) The sort direction: Descending or Ascending.

Descending

Display Column

The columns to display in the component output.

(If Type is Explore - Assets or Explore - Findings) Only numeric columns are available. By default, all of them are selected, and each selected column appears as its own set of bars. For example, if you group by CVE, the chart plots VPR, EPSS, CVSSv4, CVSSv3, CVSSv2, and the total count as separate series.

--

Tip: To create a bar chart that shows the top results by count for an Explore data source, set Sort Column to Total (Explore - Assets) or Vuln Count (Explore - Findings), set Sort Direction to Descending, and select only that column in Display Column.

Pie Chart Component Options

Option

Description

Default

Data

Type

The type of data: Vulnerability, Event, Mobile, Ticket, Explore - Assets, or Explore - Findings. For more information about Explore data sources, see Explore Data Source Options.

Vulnerability

Query

(Not available if Type is Explore - Assets or Explore - Findings.)

Predefined query used to further narrow down the data source options. If a query does not exist or is not desired, it may be left unselected. The query may be used as is or as a template on which to base the Filters option.

--

Source

(If Type is Vulnerability or Event) Specifies the data source.

For vulnerability data, select Cumulative or Mitigated.

For event data, the data source is Active. Tenable Security Center can use only active event data for event-based components.

Cumulative

Tool

(Not available if Type is Explore - Assets or Explore - Findings.)

The analysis tool to use for creating the chart. For more information, see Vulnerability Analysis Tools and Event Analysis Tools.

Vulnerability Summary

Group By

(If Type is Explore - Assets or Explore - Findings) How the data is grouped.

  • Explore - Assets: ACR Severity, Asset Tag, CVE, IAVM, Microsoft ID, Network, Operating System, System Type, or Vulnerability

  • Explore - Findings: Asset, Asset Tag, CVE, IAVM, Operating System, Severity, or Vulnerability

For more information, see Explore Data Source Options.

The default is the first option in the list for the selected Type.

First option in list

Filters

Additional filters to use on the data source. For more information, see Filters.

(If Type is Explore - Assets or Explore - Findings) Use the Explore query builder to define the filters that select the data to display. For more information, see Explore Data Source Options.

--

Display

Results Displayed

The number of displayed results.

10

Sort Column

The column Tenable Security Center uses to sort the results.

Plugin ID

(If Type is Explore - Assets or Explore - Findings) The first column for the selected Group By.

Sort Direction

The sort direction: Descending or Ascending.

Descending

Display Column

The columns to display in the component output.

(If Type is Explore - Assets or Explore - Findings) A single count column. The default is Total for Explore - Assets and Vuln Count for Explore - Findings. For some groupings, the chart includes an Other slice.

--

Matrix Component Options

For information about configuring matrix components and to download samples, visit the Tenable Security Center Dashboards blog. For an example matrix component, see Configure a Simple Matrix Dashboard Component.

When you create a matrix component, you define rules to determine what displays in each cell in a table of customizable columns and rows.

  • Use columns to define a group of vulnerability, mobile, event, ticket, user, alert, asset, or finding data. For example, you could create columns for critical, high, medium, low, and informational vulnerabilities.

  • Use rows to define the operations performed against each column element for that row. For example, if each column determines the vulnerability type (critical, high, medium, low, and informational), you can create a row to calculate the ratio of the particular vulnerability type count against the total vulnerability count.

By default, each cell definition includes a single customizable rule that defines what appears in the cell if no other conditions have been defined or triggered.

Tenable Security Center reviews each rule in a cell from top to bottom and triggers the display rule on the first rule match. Once a rule triggers, Tenable Security Center stops reviewing rules for the cell. If none of the added rules match, Tenable Security Center performs the default rule.

Option

Action

Cells

Size

Use the drop-down menus to select the number of columns and rows for the matrix. Tenable Security Center supports matrices from 1x1 to 10x10.

Click Generate Cells create a blank matrix with customizable cells.

icon

Click the icon in a row or column header cell to manage the column or row.

  • To edit the header name or refresh frequency, click Edit Header.

    Tip: You can choose to refresh the data more often to see the most current view. However, frequent refreshes can cause slow system performance.

  • To delete the row or column, click Delete Cells.

    Tenable Security Center deletes the row or column.

  • To copy the row or column, click Copy.

    Tenable Security Center copies the row or column.

edit icon

Click the edit icon inside a cell to configure rules for the cell. For more information, see Matrix Component Query Options.

Matrix Component Query Options

Option

Description

Default

Data

Data Type

The type of data: Vulnerability, Mobile, Event, User, Alert, Ticket, Explore - Assets, or Explore - Findings. For more information about Explore data sources, see Explore Data Source Options.

The Data Type determines which query values are available in the Condition option.

Vulnerability

Type

The matrix component display type: Count or Ratio

Count

Source

(If Data Type is Vulnerability or Event) Specifies the data source.

For vulnerability data, select Cumulative or Mitigated.

For event data, the data source is Active. Tenable Security Center can use only active event data for event-based components.

Cumulative

Group By

(If Type is Count and Data Type is Explore - Assets or Explore - Findings) How the data is grouped. For the available options, see Explore Data Source Options.

None

Numerator Group By

(If Type is Ratio and Data Type is Explore - Assets or Explore - Findings) How the numerator data is grouped. For the available options, see Explore Data Source Options.

None

Denominator Group By

(If Type is Ratio and Data Type is Explore - Assets or Explore - Findings) How the denominator data is grouped. For the available options, see Explore Data Source Options.

None

Filters

(If Type is Count) Additional filters to use on the data source. For more information, see Filters.

If Data Type is Explore - Assets or Explore - Findings, use the Explore query builder to define the filters. For more information, see Explore Data Source Options.

--

Numerator Filters

(If Type is Ratio) The filters to apply to the ratio numerator. For more information, see Filters.

If Data Type is Explore - Assets or Explore - Findings, use the Explore query builder to define the filters. For more information, see Explore Data Source Options.

--

Denominator Filters

(If Type is Ratio) The filters to apply to the ratio denominator. For more information, see Filters.

If Data Type is Explore - Assets or Explore - Findings, use the Explore query builder to define the filters. For more information, see Explore Data Source Options.

--

Rules

Condition

Specifies the conditions for the matrix component. Use the drop-down menus to define the quantity and query value to use for the rule.

Quantities: Less than or equal to, Greater than or equal to, Exactly, or Not Equal to.

Query values: Events, Hosts, Vulnerabilities, Ports, Devices, Users, Alerts, Tickets, Assets, or Findings.

Note: The available query values depend on the Data Type.

If Data Type is Explore - Assets, the only query value is Assets. If Data Type is Explore - Findings, the only query value is Findings.

If Group By is None (the default), the cell counts assets or findings. If you select any other Group By option, the cell counts groups instead. For example, if you set Group By to Operating System, the cell counts the distinct operating systems that match the filters.

--

Display

Specifies the appears of the matrix component when the rule Condition is met.

  • Text — Displays the Query Value or custom User-Defined text.

  • Icon — Displays the selected indicator icon.

  • (If Type is Ratio) Indicator — Displays a percentage.

Text

Text Color

(If Display is Text) The matrix component text color.

#1a1a40

Background

(If Display is Text) The matrix component background color.

#333333 or #ffffff

Line and Area Chart Component Options

Option Description Default

Data

Date Type

The date type:

  • Relative — A date relative to the current time when the chart is loaded.

  • Absolute — An absolute time frame that is the same on each page visit.

Relative

Date Range

The date range for the line or area chart.

If Date Type is Relative, select from the following options:

  • Within x Minutes — Display data within the last 15, 20, or 30 minutes.

  • Within x Hours — Display data within the last 1, 2, 4, 6, 12, 24, 48, or 72 hours.

  • Within x Days — Display data within the last 5, 7, 25, or 50 days.

  • Within x Months — Display data within the last 3 or 6 months.

  • Within 1 Year — Display data within the last year.

If Date Type is Absolute, select a date and time for the beginning and end of the range.

Within 24 Hours

Series

Click to add a series to the line or area chart. For more information, see Line and Area Chart Series Options.

--

Line and Area Chart Series Options

Option

Description

Default

Name

The name of the series.

--

Data

Data Type

The type of data: Vulnerability or Explore - Findings. Explore - Assets is not available for line and area chart series. For more information about Explore data sources, see Explore Data Source Options.

Note: For line/area charts, vulnerability data analysis often requires that the underlying repository be a trending repository. If the selected repository is not a trending repository, no historical analysis is available.

Vulnerability

Source

(If Data Type is Vulnerability) Specifies the data source: Cumulative or Mitigated.

Explore - Findings series always use cumulative data and do not have a Source option.

Cumulative

Query

(Not available if Data Type is Explore - Findings.)

Predefined query used to further narrow down the data source options. If a query does not exist or is not desired, it may be left unselected. The query may be used as is or as a template on which to base the Filters option.

--

Group By

(If Data Type is Explore - Findings) How the data is grouped. Severity is the only option for line and area chart series.

Severity

Filters

Additional filters to use on the data source. For more information, see Filters.

(If Data Type is Explore - Findings) Use the Explore query builder to define the filters that select the data to display. For more information, see Explore Data Source Options.

--

Display

Series Data

Data to display in the chart: Total, Info, Low, Medium, High, or Critical.

All