---
sourceDocument: Xanadu ServiceNow AI Platform Capabilities
sourceDocumentLink: https://www.servicenow.com/docs/r/xanadu/servicenow-platform

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu ServiceNow AI Platform Capabilities

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Overview of CMDB Health

# Overview of CMDB Health {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 6, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes to read

Learn about the benefits, configuration, and usage of the CMDB Health feature.
The health of the CMDB data is monitored and reported for the following KPIs, each further consisting of sub-metrics:

Completeness
:   CIs are tested for required and recommended fields that are not populated.

Correctness
:   CIs are tested against predefined data integrity rules such as identification rules (to detect duplicate CIs), orphan CI rules, and stale CI rules.

Compliance
:   The CMDB data is audited for adherence to predefined certificates.

Relationships
:   The health of CI relationships is tested for indicators such as orphan and duplicate relationships, and for compliance with suggested relationships, hosting and containment rules.

After CIs are tested for various health indicators (metrics), the results are aggregated at the class, health group, service, and relationship level, and appear on CMDB Health dashboards. For most metrics, you can configure the health
tests themselves to determine how compliance and non-compliance of CIs are evaluated.

For more details about the KPIs and their associated metrics, see [CMDB Health KPIs and metrics](https://www.servicenow.com/docs/UsDeDzb6GGieHtty3VV1dw "CMDB Health calculates an aggregated score for three Key Performance Indicators (KPIs) which are correctness, compliance, and completeness, each further consisting of sub-metrics.").  
Note:  
CMDB Health doesn't support non-CMDB tables.

## CMDB Health dashboards and reports {#overview-cmdb-health__section_x1g_ktn_xz}

You can view CMDB Health dashboards and reports in [CMDB Workspace](https://www.servicenow.com/docs/I__NBWRpmKjGtpFABIzs7w "The CMDB Workspace is an efficient, central, and modernized way for you to work. Use CMDB Workspace to search and explore the CMDB, examine health and recent activities, and access CMDB dashboards and tools to support tasks in your organization."). Those dashboards show CMDB Health aggregated results for compliant and non-compliant CIs for CMDB Health KPIs and their metrics.  
{#overview-cmdb-health__table_dlz_mff_s5__entry__2}

| Dashboard/Report | Use |
|-|-|
| CMDB Health Dashboard 1. Navigate to WorkspacesCMDB Workspace. 2. Select Home in the CMDB Workspace menu bar. 3. In the Quick links section select the CMDB Health Dashboard link. {#overview-cmdb-health__ol_l4v_n4m_kgc}or: <!-- --> 1. Navigate to AllConfigurationCMDB Health Dashboard. 2. Select one of the views. {#overview-cmdb-health__ol_zwv_44m_kgc} | Main CMDB Health dashboard with the following views: Class View * Shows CIs and classes health reports with aggregations for metrics, KPIs, and class branches. * Access to remediation tasks that were generated for CIs that failed a health test. {#overview-cmdb-health__ul_fdh_tff_s5} Service View * Shows service health reports. * Detailed health for CIs per service with aggregations for metrics and services. * Access to remediation tasks that were generated for CIs in a service that failed a health test. {#overview-cmdb-health__ul_mzd_nvj_3w} Health Group View * Shows health reports for CMDB groups of type Health. * Detailed health for CIs in the group, with aggregations for KPIs, metrics, and health groups. {#overview-cmdb-health__ul_awb_w53_4z} In either dashboard view you can select CMDB Health settings to manage the CMDB Health Dashboard jobs and configure other CMDB Health settings. For more information, see [Set up and configure CMDB Health](https://www.servicenow.com/docs/PCrj6gR8KpqLaoRaaovxlQ "Data collection for CMDB Health is highly configurable to reflect data health requirements and standards in your organization. Most importantly, the CMDB Health Dashboard jobs are disabled by default and health data isn't collected until you enable those jobs."). |
| Relationship Health dashboard 1. Navigate to WorkspacesCMDB Workspace. 2. Select Home in the CMDB Workspace menu bar. 3. In the Quick links section select the Relationship Health Dashboard link. {#overview-cmdb-health__ol_o2p_pwq_fbc} | Shows various charts for relationships health, such as duplicate, orphan, and stale relationships. For more information, see [View relationships health](https://www.servicenow.com/docs/a67QLdbJuhe9r9h5xMqQCw "View health scores for relationship health such as orphan, stale, and duplicate relationships, in the Relationship Health dashboard."). |
| CI health report * On a CI form that isn't in CMDB Workspace, select Open in CMDB Workspace. * In CMDB Workspace, select a CI in a list view to open the CI's form. For example, on the CMDB Health dashboard, drill down a KPI tile and then select a CI in the tile's list view. {#overview-cmdb-health__t_ViewCIHealth_ul_x23_3q2_gbc} | On a CI form, the CI Health tile contains widgets that show CIs health reports. Select the right (\>) or left (\<) handles in the CI Health tile to scroll through the widgets. |
[ ]

{#overview-cmdb-health__table_dlz_mff_s5}

## Setup and configuration {#overview-cmdb-health__section_hk2_s4c_fbc}

To start gathering and aggregating health data, you must enable the CMDB Health-related jobs (CMDB Health Dashboard jobs) which are initially disabled. You also need to configure CMDB Health related system properties and health KPIs
and metric test rules, to reflect health standards in your organization.

For details about setting up and configuring CMDB Health, see [Set up and configure CMDB Health](https://www.servicenow.com/docs/PCrj6gR8KpqLaoRaaovxlQ "Data collection for CMDB Health is highly configurable to reflect data health requirements and standards in your organization. Most importantly, the CMDB Health Dashboard jobs are disabled by default and health data isn't collected until you enable those jobs.").  
{#overview-cmdb-health__table_jhf_14q_fbc__entry__2}

| Location | Configuration |
|-|-|
| [CI Class Manager](https://www.servicenow.com/docs/~M~iU7~lO_HaKYxVWfDkag "Use the CI Class Manager to centrally view, create, or edit basic class definitions, and class settings for identification, reconciliation, and CMDB Health. To access the CI Class Manager, navigate to All > Configuration > CI Class Manager .") ConfigurationCI Class Manager | Central location to manage CI classes and to configure CMDB health settings. Use the CI Class Manager to Manage rules and definitions that are used for health tests, such as orphan rules, audit certificates, and recommended fields rule. For information about configuring KPI and metric tests, see [CMDB Health KPIs and metrics](https://www.servicenow.com/docs/UsDeDzb6GGieHtty3VV1dw "CMDB Health calculates an aggregated score for three Key Performance Indicators (KPIs) which are correctness, compliance, and completeness, each further consisting of sub-metrics."). |
| CMDB Health Preferences Navigate to ConfigurationHealth Preferences, or perform the following steps: 1. Navigate to AllConfigurationCMDB Health Dashboard. 2. Select a view. 3. On the CMDB Health dashboard, select CMDB Health settings. {#overview-cmdb-health__ol_lsb_xzs_rbc} | Central location for configuring CMDB Health settings: * Configure CMDB Health system properties. * Enable and manage the CMDB Health Dashboard jobs. * Activate or deactivate KPIs and metrics. * Set the maximum failure threshold for the KPIs and metrics. * Configure creation of tasks for failed CIs. {#overview-cmdb-health__ul_xy4_rty_dv} |
[ ]

{#overview-cmdb-health__table_jhf_14q_fbc}

## CI remediation {#overview-cmdb-health__section_vhs_l4h_g1b}

CMDB Health provides a framework for configuring [CI remediation](https://www.servicenow.com/docs/rqVym~imyxZGemaCicqqCQ "A CMDB remediation rule is associated with a task that was created for a failed CMDB health test. A CMDB remediation rule is applied automatically or manually to execute a remediation workflow that can, for example, delete stale CIs."). Remediation lets you proactively apply corrective actions to unhealthy CIs in a managed and standardized fashion.

## Domain separation {#overview-cmdb-health__section_rtp_rmc_dtb}

CMDB Health is domain aware. If the domain separation plugin has been activated, then the CMDB Health dashboard shows health based on data, rules, and settings from the logged-on user domain. If rules and settings aren't defined for a
child domain, then the parent's settings are applied, recursively.

For more information, see [Domain separation in CMDB Health](https://www.servicenow.com/docs/bqEuNKSfO1E7yYIFFR_juQ "This is an overview of domain separation as it pertains to CMDB Health. Domain separation enables you to separate data, processes, and administrative tasks into logical groupings called domains. You can control several aspects of this separation, including which users can see and access data.").

*[\>]: and then


