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:
Caution: Excessively frequent updates may cause the application to become less responsive due to the added processing load imposed on the host OS. |
Daily |
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. |
-- |
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. |
-- |
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. |
-- |
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.
|
icon |
Click the 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 |
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 |
Date Range |
The date range for the line or area chart. If Date Type is Relative, select from the following options:
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 |