--- title: Manage dashboards description: Starting with IDM 8.1, the legacy admin UI is deprecated and is no longer bundled with IDM. New deployments should use the Platform admin UI, which is the replacement for the legacy admin UI. component: pingidm version: 8.1 page_id: pingidm:setup-guide:managing-dashboards canonical_url: https://docs.pingidentity.com/pingidm/8.1/setup-guide/managing-dashboards.html keywords: ["Setup & Configuration", "Dashboards"] section_ids: default_dashboards: Default dashboards quick_start_dashboard: Quick start dashboard system_monitoring_dashboard: System monitoring dashboard resource_report: Resource report business_report: Business report custom_dashboards: Custom dashboards to-create-a-dashboard: Create a new dashboard to-add-widgets: Add and move widgets default-widgets: Admin UI widgets widget-reporting: admin UI reporting widgets widget-system: System status widgets widget-utilities: Utility widgets --- # Manage dashboards | | | | - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Widgets are deprecated and will be removed in a future release of IDM. For more information, refer to [Deprecation](../release-notes/deprecated-functionality.html#deprecation-widgets). | | | | | - | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Starting with IDM 8.1, the [legacy admin UI is deprecated](../release-notes/deprecated-functionality.html#legacy-admin-ui-deprecated) and is no longer bundled with IDM. New deployments should use the [Platform admin UI](platform-admin-ui.html), which is the replacement for the legacy admin UI.Both UIs are available as separate downloads from the [Backstage download site](https://backstage.forgerock.com/downloads):- To install the Platform admin UI, follow the steps in [Install the Platform admin UI for standalone IDM](platform-admin-ui.html). - To continue using the legacy admin UI, follow the steps in [Install the legacy admin UI](legacy-admin-ui.html). | Dashboards let you make shortcuts to frequently-required tasks. The Quick Start dashboard displays by default when you log in to the admin UI. You can create additional dashboards, or add and remove widgets from the existing dashboards. ## Default dashboards To display all configured dashboards, select Dashboards > Manage Dashboards. The following dashboards are provided by default. ### Quick start dashboard Quick Start cards support one-click access to common administrative tasks: [icon: database, set=fad, size=3x] #### [Add Connector](link:https://docs.pingidentity.com/openicf/connector-reference/configure-connector.html) Configure connections to external resources. [icon: map-marker-alt, set=fad, size=3x] #### [Create Mapping](../synchronization-guide/mappings.html) Configure mappings to synchronize objects between resources. [icon: check-square, set=fad, size=3x] #### [Manage Roles](../objects-guide/managed-roles.html) Set up provisioning or authorization roles. [icon: tablet-alt, set=fad, size=3x] #### [Add Device](../objects-guide/creating-modifying-managed-objects.html) Configure managed objects, including users, groups, roles, and devices. [icon: user, set=fad, size=3x] #### [Manage Users](../objects-guide/users.html) Manage users in the repository. [icon: user, set=fad, size=3x] #### [Configure System Preferences](../workflow-guide/preface.html) Configure server settings for Audit, Workflow, and more. ### System monitoring dashboard The System Monitoring Dashboard includes information about: Audit Events Includes information on [audit](../audit-guide/audit.html) data, organized by date. ![Audit Event Widget](_images/auditEventWidget.png) Cluster Node Status Includes information on cluster nodes. ![Cluster Node Status Widget](_images/clusterNodeWidget.png) System Health Includes information on system resource usage. ![System Health Widget](_images/systemHealthWidget.png) Last Reconciliation Includes data from the most recent data reconciliation. ![Last Recon Widget](_images/lastReconWidget.png) ### Resource report Show Me ![Resource Report Dashboard](_images/resourceReportDashboard.png) * The Resource Report includes widgets that show the number of active users, configured roles, and active connectors. * The Resources widget shows all configured connectors, mappings, and managed object types. ### Business report Show Me ![Business Report Dashboard](_images/businessReportDash.png) The Business Report includes widgets related to login and registration activity. ## Custom dashboards You can set up additional dashboards for customized views of the admin UI. ### Create a new dashboard To create a new dashboard, select Dashboards > New Dashboard. Enter a dashboard name and select whether this dashboard should be the default board that is displayed when you load the admin UI. For a customized view of the admin UI, select Widgets as the Dashboard Type, click Create Dashboard, and add the widgets that you want exposed in that view. You can also customize the view by starting with an existing dashboard. In the upper-right corner of the UI, next to the Add Widget button, click the overflow menu [icon: ellipsis-v, set=fas]> widget, and select Rename or Duplicate. ## Add and move widgets To add a widget to a dashboard, click Add Widget and select the widget type. Widgets are grouped in categories. Scroll down to the category of the widget you want to add. To change the position of a widget on a dashboard, click and drag the move button [icon: arrows-alt, set=fas]. To add a new Quick Start widget, select the overflow menu [icon: ellipsis-v, set=fas]> widget in the upper right corner of the widget, and click Settings. To embed an admin UI sub-widget in the Quick Start widget, specify the destination URL. If you are linking to a specific page in the admin UI, the destination URL can be the part of admin UI address. For example, to create a quick start link to the Audit Configuration tab, at `{secureHostname}/admin/#settings/audit/`, enter `#settings/audit` in the destination URL text box. Any changes to the dashboards are persisted in your project's `conf/ui-dashboard.json` file, which has the following properties: **admin UI Widget Properties in ui-dashboard.json** | Property | Values | Description | | ----------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | String | Dashboard name. | | `isDefault` | `true` or `false` | Default dashboard. You can only set one default. | | `widgets` | Different attributes based on `type` | Attributes that define the widget. | | `type` | `lastRecon`, `resourceList`, `quickStart`, `userRelationship` | Widget type. | | `size` | `x-small`, `small`, `medium`, or `large` | Width of widget, based on a 12-column grid system, where x-small=4, small=6, medium=8, and large=12. For more information, refer to [Bootstrap CSS](https://getbootstrap.com/css/). | | `barchart` | `true` or `false` | Reconciliation bar chart; applies only to the Last Reconciliation widget. | ## Admin UI widgets The following tables list the available widgets: ### admin UI reporting widgets | Name | Description | | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | Audit Events | Graphical display of [audit events](../audit-guide/audit-admin-ui.html). | | Count Widget | A *count* widget that provides an instant count of specific objects; for example, active managed users. | | Dropwizard Table With Graph | Does not appear in the list of widgets unless [metrics](../monitoring-guide/monitoring.html) are active. | | Graph Widget | Provides a graphical view of a specific managed resource; for example, managed users, based on some metric. | | Last Reconciliation | Shows statistics from the most recent [reconciliation](../synchronization-guide/manage-recon.html#recon-details), shown on the System Monitoring dashboard. | | Resources | Connectors, mappings, managed objects; shown in Administration dashboard. | | Sign-Ins | The number of managed users that have signed in to the service that week. | ### System status widgets | Name | Description | | -------------------------- | -------------------------------------------------------------------------------------------------------------------- | | Memory Usage (JVM Heap) | Displays the JVM memory usage. Refer to [API metrics](../monitoring-guide/api-metrics.html). | | Memory Usage (JVM NonHeap) | Displays the JVM non-heap memory usage. Refer to [API metrics](../monitoring-guide/api-metrics.html). | | System Health | Includes information on system resource usage. | | CPU Usage | Displays the system CPU usage. | | System Health | Includes information on system resource usage. | | Cluster Node Status | Lists the instances in a [cluster](../install-guide/manage-cluster-nodes.html#managing-nodes-ui), with their status. | ### Utility widgets | Name | Description | | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Quick Start | Links to common tasks; shown in the Administration dashboard. | | Identity Relationships | Graphical display of [relationships](../objects-guide/view-relationships-ui.html#viewing-relationships-ui) between identities. | | Managed Objects Relationship Diagram | Graphical diagram with connections between managed object properties; also refer to [View the Relationship Configuration in the UI](../objects-guide/ui-relationships.html#relationship-objects-widget). |