Create a Custom Dashboard

You can create a custom dashboard that meets your specific requirements.

  1. Go to the Dashboards page in the Observability & Management service in which you want to create a dashboard.
  2. Click Create dashboard.
    A blank, untitled dashboard is displayed. In the lower half of the blank dashboard, you can add or create a widget, and in the upper half, you can add filters to apply on each widget. On the right side, the About, Widgets, and Filters tabs are displayed. The Widgets and Filters tabs list the Oracle-defined widgets and filters that you can use in the custom dashboard. A widget or filter may be created in the service in which you're accessing Dashboards or another supported Oracle Cloud Infrastructure Observability & Management service. To indicate the provider service of the widgets and filters, an abbreviated version of the name of the service is displayed in the upper-right corner of each tile. Here's the list of the abbreviated names of the services:
    • Application Performance Monitoring – APM
    • Database Management – DBM
    • Logging Analytics – LOGAN
    • Management Agent – AGENT
    • Management Dashboard – DASHBD
    • Operations Insights – OPSI
  3. In the upper-right corner of the dashboard, select a time period for which you want to display data in the widgets in the dashboard.
  4. On the About tab, enter a name for the dashboard, select the compartment in which you want the dashboard to reside, and optionally add a description for the dashboard.
    If you want to make the dashboard available to other supported Observability & Management services, select the Enable for cross-service check box. For information, see Enable Cross-service for a New Dashboard.

    Optionally, click Show advanced options to add free-form or defined tags to the dashboard. If you have the permissions required to create a dashboard, then you also have permissions to add free-form tags. To add a defined tag, you must have permissions to use the tag namespace. For information on:

  5. On the Widgets tab, you can:
    • Select the compartment and add an Oracle-defined widget from the list of available widgets, to the new dashboard. You can search for a particular widget or all the widgets created in a particular service by adding the title of the widget or the abbreviated name of the provider service to the search field above the list. For example, enter APM in the search field to only view Application Performance Monitoring widgets.

      Click the Launch widgets table view icon (Launch widgets table view) to view the widget library in a tabular format. In the Widget library table view panel, select options in the drop-down lists above the list of widgets or enter text in the Search... field to filter the list of widgets and click Apply changes to the widget library to view the filtered list on the Widgets tab. For example, in the Widget library table view panel, select Application Performance Monitoring in the Created in drop-down list and Cross-service in the Widget type drop-down list to only view the widgets created in the Application Performance Monitoring service and for which the cross-service feature is enabled.

    • Click the Add widget group and widgets icon (Add widget group and widgets) to create a custom widget and add it to the new dashboard. Custom widgets are of two types, metric data explorer widgets and query-based widgets. For information on:

    As you click or drag and drop an Oracle-defined widget to add it to the new dashboard or click an option to create a custom widget, the required widget inputs such as compartment are automatically configured to use the corresponding filter. In addition, for certain Oracle-defined widgets that require input parameters that have internal dependencies, the widget inputs are automatically configured to use the corresponding filters. For example, when adding an Application Performance Monitoring widget, the APM domain input is dependent on the compartment input, and both are automatically configured to use the corresponding filters.

    The lower half of the dashboard displays the widget you've added and the upper half displays the filters added to specify the input for the widget. To make changes to the automatically configured widget inputs or to view the details of the widget, click Edit widgets on the Widgets tab and then click the name of the widget. The required inputs configured when adding the widget and optional inputs, if any, are listed in the Configured widget inputs section. The required inputs are denoted by an asterisk. Click the Edit icon (Edit) adjacent to each input to edit the input configuration for the widget, if required. On clicking the Edit icon (Edit), the Configure <name> input for <name of widget>... dialog box is displayed. Select from the options in this dialog box to edit or configure the input:

    • Link the input with an existing filter: Select to link the input to an existing filter in the dashboard. Note that this option is only displayed if a filter related to the input has already been added to the dashboard.
    • Add new filter: Select to link the input to a filter available in the filter library. When you use this option, the value specified in the selected filter can be shared with other widgets that might be linked to this filter, and any change to this value will impact all the linked widgets.
    • Specify the input: Select to specify a fixed value of the input, which will be used only in the context of this widget. If you use this option, a filter is not added to the dashboard as the fixed input value is only configured for a single widget.
  6. Optionally, on the Filters tab, click Edit filters to view the filters used to specify the input for the widget, and click the Edit icon (Edit) adjacent to each filter input to view and modify the configuration. For example, for the Compartment filter, edit the Include subcompartments input and select Yes to view the Subcompartments check box. Once you add a widget that can display data from subcompartments, for example, the Database top consumers widget created in Operations Insights, you can select the Subcompartments check box in the Compartment filter to view that data in the widget. If a widget does not support the option to display data from subcompartments, for example, metric widgets, a message is displayed notifying you of the same.
    You can click Add filters on the Filters tab and click or drag and drop additional Oracle-defined filters to the upper half of the dashboard. As you add filters to the dashboard, an additional input may be required and the additional input is automatically configured to use the corresponding filter. After adding filters to the dashboard, you can also select a different option in the drop-down list on the filter to view data within its context.
    Note

    • If you've linked the same filter to multiple widgets in a dashboard, then any change made to that filter impacts all the dependent widgets.
    • If your dashboard is using widgets from other Observability & Management services, then the data might be available in different compartments or associated with different entities. In such cases, it's helpful to define separate filters for those widgets.
  7. Optionally, click the Actions icon (Actions) on a widget or filter in the dashboard to perform tasks such as altering its size or placement or deleting the widget or filter from the dashboard.
  8. Click Save changes to save the new dashboard.
    The dashboard is now in view mode. In the view mode, click the Actions icon (Actions) on a widget and then click Export to CSV to export widget data to a CSV file. Note that the Export to CSV option is disabled if the widget does not support this feature.

    To go to the edit mode and make changes to the contents of the dashboard, click Actions in the upper-right corner and then click Edit. The Actions menu includes other options that allow you to duplicate the dashboard, print the dashboard, select a time range to automatically refresh the contents of the dashboard, or manually refresh the contents of the dashboard.

Note that you can create a dashboard in the console and using API. For API information, see Management Dashboard API.