Thank you for your feedback.
Form temporarily unavailable. Please try again or contact to submit your comments.

Configure KPI and metrics aggregation preferences

Log in to subscribe to topics and get notified when content changes.

Configure KPI and metrics aggregation preferences

Metrics health scorecards are aggregated into their respective KPI, which in return are aggregated into the overall CMDB Health report. Set aggregation preferences for KPIs, and for each of their respective metrics, deactivate KPIs and metrics that you are not interested in reporting, and adjust weighted averages of aggregation.

Before you begin

To start collecting and reporting CMDB health KPIs and metrics, you must first enable and configure the CMDB health dashboard jobs.

Role required: itil_admin (on top of itil)

About this task

The completeness KPI for example, consists of the metrics required fields and recommended fields, each contributing a different weight to the sum. You can configure the proportional weight of required fields and recommended fields within completeness to be 25 and 75 respectively. You can also configure the proportional weight of completeness, compliance and correctness within the aggregated sum of the overall CMDB health.

Note: Non-active KPI or metrics are displayed on the CMDB dashboard in faded coloring, displaying the most recent aggregations that were calculated when the KPI or metric was active.

If Domain Support - Domain Extensions is activated, then you can configure aggregation preferences per domain.

In the ServiceNow base system, the weights of KPIs have default settings, and metrics are globally set.


  1. Navigate to Configuration > Health Preferences.
  2. Select Health Metrics on the right-hand side navigator.
  3. From the Select Metric list select one of the KPIs such as Completeness, or a metric.
    For Completeness, Compliance and Correctness:
    Field Description
    Active Activate the KPI so it is included in the aggregated CMDB health report.
    Weighted Averages Specify the weight of each metric in the aggregated KPI health report. The sum of weighted averages of all metrics should be 100.
    For a metric:
    Field Description
    Active Activate the metric so it is included in the aggregated health report for the respective KPI.
    Create Task If a record fails the metric test, create a task with details about the failure. You can then view the task on the CI dashboard, and configure remediation for the task.
    Failure Threshold When the threshold number of CIs that fail the health metric test is reached, health processing stops for the metric for this cycle.
    Task Assignee Group An assignment group for the task.
  4. Click Save.