Getting Started with Console Dashboards

This topic explains how to start using the Console Dashboards service. You can use dashboards to view:

  • Infrastructure overviews
  • Usage summaries for resources in a given region or compartment
  • System health
  • Resource monitoring
  • Billing information

The first time you visit the Dashboard tab, you're presented with a default dashboard and sample widgets that contain instructions for getting started with widgets. You can personalize the dashboard by editing its layout or adding more widgets. Or, you can build a new dashboard. For more detailed instructions, see Managing Console Dashboards and Configuring Widgets.

After your tenancy has a saved dashboard, your most recently viewed dashboard becomes the default dashboard. The initial default dashboard with sample widgets is inaccessible unless all other dashboards have been deleted.

Important

Resources for the Console Dashboards service are created in the tenancy's home region. Although it is possible to create dashboard and dashboard group resources in regions other than the home region, you can't view those resources in the Console. Therefore, creating resources outside of the home region is not recommended.

Required IAM Policies

To use Oracle Cloud Infrastructure, you must be granted security access in a policy  by an administrator. This access is required whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you get a message that you don’t have permission or are unauthorized, verify with your administrator what type of access you have and which compartment  to work in.

To get started with the Console Dashboards service, an administrator needs to grant user access through an IAM policy. Each service in Oracle Cloud Infrastructure integrates with IAM for authentication and authorization, for all interfaces (the Console, SDK or CLI, and REST API).

The resource name for the Console Dashboards service is dashboards-family. The following is an example policy to grant users access to the Console Dashboards service resources:

Allow group TenancyUsers to manage dashboards-family in tenancy

The following is an example policy to grant users access to a dashboard group:

Allow group GroupA to manage dashboard-groups in tenancy where target.dashboardgroup.id='ocid1.dashboardgroup.oc1.phx.<uniqueID>'

If you're new to policies, see Getting Started with Policies and Common Policies. For more information about Console Dashboards policies, see Policy Details for Console Dashboards.

To share dashboards

Use IAM policies to control access to dashboards.

The following policy gives users in the specified group manage permissions for this dashboard group at the compartment level:

Allow group CompartmentUsers to manage dashboard-groups in compartment <compartment_name> where target.dashboardgroup.id='ocid1.dashboardgroup.oc1.phx.<uniqueID>'

The following policy gives users in the specified group manage permissions for this dashboard group at the tenancy level:

Allow group TenancyUsers to manage dashboard-groups in tenancy where target.dashboardgroup.id='ocid1.dashboardgroup.oc1.phx.<uniqueID>'

Using the Console

To access your dashboards in the Console:

  • On the Console home page, click the Dashboard tab.

To access your dashboard groups in the Console:

  1. On the Console home page, click the Dashboard tab.
  2. In the dashboard banner, click the Manage groups button.