Configure CMDB health scorecard thresholds

Configure the thresholds for best, at risk and critical state definitions for the KPIs and metrics scorecards. You can configure these settings globally for the entire CMDB, or individually per class.

Before you begin

Role required: itil has read access, itil_admin (on top of itil) has full access.

About this task

Scorecard thresholds are used to determine overall metric state, and are defined by upper and lower thresholds. For example, scorecards thresholds for completeness:
  • 0 - lower threshold: Best state
  • Lower threshold - upper threshold: At risk state
  • Upper threshold - 100: Critical state
In the base system, upper thresholds are set to 67 and lower thresholds are set to 33 for all KPIs and metrics. You can adjust scorecard thresholds to reflect the range of failures that should be used for each health state. Applying the change to a scorecard is based on the selected class in the CI class list:
  • If the top level Configuration Item class is selected in the CI class list, changes to metric scorecards apply to the entire hierarchy.
  • If any other class is selected in the CI class list, changes to metric scorecards apply to the selected class.

For CMDB groups, you can specify a separate set of scorecard thresholds, per CMDB group/KPI or metric. See Configure CMDB groups scorecard thresholds for more details.


  1. Navigate to Configuration > CI Class Manager.
  2. In the class navigation bar, expand Health.
  3. To configure the overall scorecard, select Other Scorecards and then select Overall Scorecard.
  4. To configure a scorecard for any of the KPIs (such as Compliance), or for relationship-related metrics (such as duplicate relations):
    1. Select the top level Configuration Item in the CI Classes list.
    2. Click a KPI item, Completeness, Compliance, or Correctness.
    3. Click the tab CMDB Completeness Scorecard, CMDB Compliance Scorecard, or CMDB Correctness Scorecard.
    When you select the top-level Configuration Item class, changes to threshold settings in any metric scorecard apply to the entire class hierarchy.
  5. To configure a scorecard for any metric:
    1. In the CI class list, select the class to which the updated scorecard should apply to. Select the top level Configuration Item to apply the change to the entire hierarchy.
    2. Click the KPI that contains the metric for which you want to configure scorecard. For example, click Completeness to configure the Required Fields scorecard.
    3. Select the scorecard tab of the metric to configure, such as Required Fields Scorecard. You might need to click New to edit the scorecards.
  6. Slide the threshold sliders, or enter specific numbers to increase or to decrease the threshold bars to fit your definitions for best, at risk, and critical levels for the scorecard.
  7. Click Save.