Oracle Cloud Infrastructure Documentation

Getting Started with Console Dashboards

Learn how to start using the Console Dashboards service.

You can use dashboards to view:

  • Infrastructure overviews
  • Usage summaries for resources in a particular 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 create a new dashboard. For more detailed instructions, see Managing Console Dashboards and Configuring Widgets.

After a 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's 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 isn't recommended.

Using the Console

To access dashboards in the Console:

  • Open the navigation menu. Under Home, select Dashboards.

To access dashboard groups in the Console:

  1. Open the navigation menu. Under Home, select Dashboards.
  2. In the dashboard banner, select Manage dashboards. Then select Dashboard groups.

To create a dashboard from the overview page using a template:

  1. Open the navigation menu. Under Home, select Dashboards.
  2. In the dashboard banner, select Manage dashboards.
  3. Select the name of a template to learn more about the dashboard. To create a new dashboard from the template, select Create new dashboard. For more information, see Creating a Dashboard and Configuring Widgets.

To view recently updated dashboards:

  1. Open the navigation menu. Under Home, select Dashboards.
  2. In the dashboard banner, select Manage dashboards and view the list under Recently updated dashboards.

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.dashboard-group.id='ocid1.consoledashboardgroup.oc1..<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.dashboard-group.id='ocid1.consoledashboardgroup.oc1..<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.dashboard-group.id='ocid1.consoledashboardgroup.oc1..<uniqueID>'