Create or edit a CMDB Health staleness rule

If the CMDB Health sub-metric staleness is in effect, then staleness rules are used to determine the percentage of stale CIs in the CMDB. This sum is then aggregated into the correctness metric, and weighs into the overall CMDB health calculation. Staleness rules are defined per class per data source.

Before you begin

Role required: itil_admin (on top of itil)

About this task

A staleness rule that is defined for a specific class is used in conjunction with a reconciliation rule for the same class to determine the staleness status of CIs from that class.

If the fields specified in the reconciliation rule for the CI's class were not updated by the specified data source within a certain time period - the CI is determined to be stale. The time period is determined by the glide.cmdb.health.staleness property or by the Effective Duration field in the staleness rule. If a staleness rule exist for a CI's class, then if a CI passes the rule's test, the CI is further tested using the glide.cmdb.health.staleness property value. A CI then, might initially pass the staleness test and then fail the subsequent staleness test that uses the glide.cmdb.health.staleness property.

Procedure

  1. Navigate to Configuration > CI Class Manager.
  2. Select a class from the Class Hierarchy.
  3. On the right-hand side navigation pane, check Advanced, expand the Correctness strip, and click Staleness Rule.
    If a staleness rule exists for the class, then double-click it to edit.
  4. Complete or edit the Data Source Staleness Rule form.
    Control Description
    Applies to The class for which the rule applies.
    Data source The data source for which the rule applies.

    This data source correlates to the Discovery source field on a CI. These two must match for the staleness rule to be applied to a CI. Ensure that the Discovery source field is properly populated either by Identification and Reconciliation processes, or manually.

    Effective Duration The time period that is used for the initial CI staleness test.

    If you enter a value with a prefix that is valid and a suffix that is not, such as 15 x - the valid portion of the value is used ('15'). If the entire value is invalid - the default value of 0 is used.

    Active Select to activate the rule.
  5. Click Submit or Update to save the rule.