Manage Dashboards

The following is not supported in Tenable FedRAMP Moderate environments. For more information, see the Tenable FedRAMP Product Offering.

In Tenable Exposure Management, you can manage dashboards in the following ways:

Create a Dashboard

Required User Role: Administrator or Custom Role

In Tenable Exposure Management, you can create a dashboard to highlight key performance indicators (KPIs) for yourself and others within your organization.

To create a new dashboard:

  1. At the top of the Dashboards page, click the Create New Dashboard button.

    The create dashboard page appears.

  2. In the Dashboard Name text box, type a name for the dashboard.

  3. A text box appears.

    1. In the Dashboard Description text box, type a brief description of the dashboard.

    2. Click the button to save the description.

  4. From the date range drop-down, select the date range for which you want to view data on the dashboard.

    Tip: Choose a Quick pre-defined date range, or select your own date range on the Custom tab.

  5. (Optional) Click the Filters button to apply one or more filters to the dashboard.

    Note: This filter applies to all individual widget data on the dashboard.

  6. Add widgets to the dashboard:

    1. On the create dashboard page, click Add Widgets.

      The Widgets Library appears.

    2. Do one of the following:

        1. In the Widgets Library, for the widget you want to add to the dashboard, click the button.

          Tip: Use the search box to search for a specific widget in the library.

          The widget appears in the dashboard preview pane.

        2. Repeat for each widget you want to add from the Widgets Library.

        1. In the upper-right corner of the Widgets Library, click New Custom Widget.

          The Custom Widget pane appears.

        2. In the Widget Name text box, type a name for the custom widget.

        3. From the Widget Type drop-down, select the type of data graph you want to use on the widget, for example, Pie Chart or Table.

          The custom widget configuration options update depending on the type of data graph you select.

        4. Configure the data according to your preferences. For example, if you select Scatter Chart, you can configure the Values, X axis, Y axis, and Legend for the chart.

          The widget updates automatically within the dashboard preview.

          Important! For information on what values and fields you can configure based on your chart selection, see Valid Custom Widget Combinations.

        5. (Optional) In the Chart Filters section, to apply filters to the data within the custom widget, click Apply Widget Filters.

          Note: This filter only applies to the data within this custom widget.

        6. Click Save.

    3. Click Create.

      The Dashboard Details window appears.

    4. In the Private Dashboard section, enable or disable the toggle to set the dashboard as Public or Private.

      Note: Public dashboards can be seen by all users within your Tenable Exposure Management container.

Create a Copy of a Dashboard

Required User Role: Administrator or Custom Role

In Tenable Exposure Management, you can make a copy of any dashboard on the Dashboards page.

To copy a dashboard:

  1. Do one of the following:

    • On the Dashboards page, in the lower-right corner of the tile for the dashboard you want to copy, click the button.

    • On the dashboard details page, in the upper-right corner, expand the Actions drop-down.

    A menu appears.

  2. Click Create a Copy.

    The Create a copy window appears.

  3. In the Dashboard Name text box, type a name for the copied dashboard. By default, Tenable prepends "copy of" to the original dashboard name.

  4. (Optional) In the Description text box, edit the dashboard description.

  5. In the dashboard privacy section, select whether you want the dashboard to be Public or Private.

    Note: Public dashboards are visible to all users within your Tenable Exposure Management instance.

  6. Click Create.

    Tenable Exposure Management adds the copy of the dashboard to the Dashboards page.

Edit a Custom Dashboard

Required User Role: Administrator or Custom Role

Note: Only the dashboard owner can perform this action.

In Tenable Exposure Management, you can edit custom dashboards by either quick-editing their name and description, or accessing the Edit Dashboard page to fully edit the dashboard's configuration options.

Note: You cannot edit Tenable provided dashboards.

To edit a custom dashboard's name and/or description:

  1. On the Dashboards page, in the lower-right corner of the tile for the custom dashboard you want to edit, click the button.

    A menu appears.

  2. Click Edit Name or Description.

    The Dashboard Details window appears.

  3. Edit the Dashboard Name and/or Description.

  4. (Optional) Edit the dashboard's privacy (for example, Public or Private).

  5. Click Update.

    Tenable Exposure Management saves your changes to the dashboard.

Change the Privacy of a Custom Dashboard

Required User Role: Administrator or Custom Role

Note: Only the dashboard owner can perform this action.

You can set the privacy of custom dashboards to either Public or Private.

To change the privacy of a custom dashboard:

  1. Do one of the following:

    • On the Dashboards page, in the lower-right corner of the tile for the custom dashboard you want to copy, click the button.

    • On the dashboard details page for the custom dashboard, in the upper-right corner, expand the Actions drop-down.

    A menu appears.

  2. Do one of the following:

    • If the dashboard is currently private, click Set as Public.

    • If the dashboard is currently public, click Set as Private.

    A confirmation message appears.

  3. Click Set as Public/Private.

    Tenable Exposure Management updates the privacy of the selected dashboard.

Delete a Custom Dashboard

Required User Role: Administrator or Custom Role

Note: Only the dashboard owner can perform this action.

In Exposure Management, you can delete custom dashboards.

To delete a custom dashboard:

  1. Do one of the following:

    • On the Dashboards page, in the lower-right corner of the tile for the custom dashboard you want to delete, click the button.

    • On the dashboard details page for the custom dashboard, in the upper-right corner, expand the Actions drop-down.

    A menu appears.

  2. Click Delete Dashboard.

    A confirmation message appears.

  3. Click Delete Dashboard.

    Tenable Exposure Management removes the dashboard and its data from the user interface.

Edit a Widget

Required User Role: Administrator or Custom Role

In Exposure Management , you can edit both built-in and custom widgets on your dashboards. You can modify all widget configuration parameters, including Widget Type, Categories, Values, Data Labels, Stacking, and Filters.

Editing widgets allows you to quickly adjust visualizations without creating a new widget from scratch.

Before You Start

You can only create up to five instances of a particular widget per dashboard.

Once you save an instance, it permanently counts toward the five-instance limit, even if you later delete it. This limit applies per widget per dashboard.

TIP: Only save widget instances you plan to keep; deleting one does not free up a slot.

To edit a widget on a dashboard:

  1. On the Dashboards page, open the dashboard you own that contains the widget you want to edit.

  2. Click Edit Dashboard.

  3. Hover over the widget you want to edit.

    Options appear.

  4. Click the More Options button.

    A menu appears.

  5. Click Edit.

    The Custom Widget panel opens on the left side of the page.

  6. Edit the widget attributes as needed. For example, change the visualization type, adjust the data categories and values, or update filters.

  7. Click Update Widget.

    Tenable Exposure Management saves the changes to the selected widget instance.

  8. Click Update to save the Dashboard.

    A confirmation message appears.

  9. Click Update Dashboard.

    Note: Keep the following caveats in mind:

    • You can only edit widgets on dashboards that you own.

    • Changes apply only to the selected widget instance on the current dashboard.

    • Editing a widget does not modify the original widget in the Widgets Library.
    • You cannot save an edited widget as a new widget in the Widgets Library.

    • You can add up to five instances of the same widget to a single dashboard. You can edit each instance independently to match specific requirements.

    • The Edit Widget feature is supported only on dashboards saved after this feature is released. Older dashboards and copies of older dashboards do not support widget editing. This feature is not backward compatible.

Remove a Custom Widget

Required User Role: Administrator or Custom Role

Note: Only the dashboard owner can perform this action.
TIP: Each widget is limited to five instances per dashboard. You can edit an existing widget to change its configuration without using another slot. Only remove a widget if you no longer need it.

To remove a custom widget from a custom dashboard:

  1. On the Dashboards page, open the custom dashboard you own that contains the widget you want to remove

  2. Click Edit Dashboard.

  3. Hover over the widget you want to edit.

    Options appear.

  4. click the More Options button.

    A menu appears.

  5. Click Remove.