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:

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

Table Component Options

Option

Description

Default

Data

Type

The type of data: Vulnerability, Event, Mobile, User, Ticket, or Alert.

Vulnerability

Query

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

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

Vulnerability Summary

Filters

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

--

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

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.

--

Bar Chart Component Options

Option

Description

Default

Data

Type

The type of data: Vulnerability, Event, Mobile, or Ticket.

Vulnerability

Query

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

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

Vulnerability Summary

Filters

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

--

Display

Results Displayed

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

10

Sort Column

(If Type is Vulnerability or Ticket) The column Tenable Security Center uses to sort the results.

Plugin ID

Sort Direction

(If Type is Vulnerability or Ticket) The sort direction: Descending or Ascending.

Descending

Display Column

The columns to display in the component output.

--

Pie Chart Component Options

Option

Description

Default

Data

Type

The type of data: Vulnerability, Event, Mobile, or Ticket.

Vulnerability

Query

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

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

Vulnerability Summary

Filters

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

--

Display

Results Displayed

The number of displayed results.

10

Sort Column

The column Tenable Security Center uses to sort the results.

Plugin ID

Sort Direction

The sort direction: Descending or Ascending.

Descending

Display Column

The columns to display in the component output.

--

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, or alert 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, or Ticket.

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

Filters

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

--

Numerator Filters

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

--

Denominator Filters

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

--

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, or Tickets.

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

--

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 Event.

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

Query

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.

--

Filters

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

--

Display

Series Data

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

All