IBM Cloud Docs
Working with dashboards

Working with dashboards

Use dashboards to monitor your infrastructure, applications, and services. You can use pre-defined dashboards. You can also create custom dashboards through the Web UI or programmatically. You can backup and restore dashboards by using Python scripts.

A dashboard shows groups of metrics that report on the health, performance, and state of your infrastructure, applications, and services for a single host or a group of hosts. Dashboards offer a specialized insight into network data, application data, topology, services, hosts, and containers.

In the Dashboards section of the Web UI, dashboards are organized into groups:

  • Recently Viewed are dashboards that the user has recently used.
  • My Favorites are dashboards the user has flagged to be included in this view.
  • My Dashboards are dashboards that are created by the user who is currently logged in. An icon indicates if the dashboard is shared with other team members.
  • Shared By My Team are dashboards that are created by other users, and shared with the current user.

You can copy and share dashboards through the Web UI.

In the Explore section allows you to review specific metrics for your environment. This section also provides support for PromQL queries.

You can run scripts to complete any of the following actions programmatically:

  • Save existing dashboards to a local file.
  • Create new dashboards that are identical to the dashboards that you save.
  • Restore dashboards.

Pre-defined dashboards

Pre-defined dashboards are designed around various supported applications, network topologies, infrastructure layouts, and services.

Pre-defined dashboards include a series of panels that are already configured.

For more information on pre-defined dashboards, see Dashboard Library.

Creating custom dashboards in the Web UI

When you create a custom dashboard, you can start from a template such as a pre-defined dashboard, or choose a blank dashboard. A dashboard includes panels that are configured to display specific data in different formats. You also set how data is aggregated. The scope defines what data is used for aggregation and displayed. You can set the scope at a dashboard level, or override for individual panels within the dashboard.

Complete the following steps to create a custom dashboard:

  1. Navigate to the Dashboards section in the Web UI

  2. You can create a dashboard using a template or by creating a dashboard manually.

    • To create a dashboard using a template:

      1. Click Dashboard Manager.

      2. Click Dashboard Library.

      3. Click the template you want to use to create your dashboard.

      4. Click Copy to My Dashboards.

      5. Name your dashboard.

      6. Click Create and Open

    • To create a dashboard without a template:

      1. Click + New Dashboard. The New Dashboard page opens.

      2. Modify your dashboard as desired.

      3. Click Save.

      4. Click New Dashboard to rename your dashboard. Click the check mark to save your name change.

  3. Set the dashboard scope. Click the Pencil icon Pencil icon. The select the desired scope. By default, Entire infrastructure is selected.

    1. Select the scope.

    2. Click Save.

  4. Configure panels. Repeat this step for any of the panels in the dashboard that you want to modify.

    1. Identify the panel that you want to modify.

    2. Select Edit Panel. This is the Pencil icon Pencil icon.

    3. Change the visualization if needed.

    4. Change the query used to select the data.

    5. For Number and Gauge chart types you can set the panel color based on metric thresholds. Click Thresholds. Set values for the different thresholds.

      For Timechart set the axes and legend for the chart.

    6. For Panel specify the name of the panel and an optional description.

    7. Change the scope of the panel. Click the Pencil icon Pencil icon. Then, change the scope. If you need to restore the dashboard scope to the panel, delete the custom scope. Click Apply.

    8. Click Save.

Changing the scope

Instead of changing the scope of a pre-defined dashboard, copy the dashboard and change the scope in the copied dashboard.

Complete the following steps to change the scope of a dashboard:

  1. Navigate to the Dashboards section in the Web UI, and select a dashboard.

  2. Click the Pencil icon Pencil icon to Edit Dashboard Scope to change default scope.

  3. Select the scope.