Create or edit a CMDB Health orphan rule

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 1 minute to read

    • Create an orphan rule to determine the percentage of orphan CIs in the CMDB. This sum is then aggregated into the correctness CMDB Health KPI, and weighed into the overall CMDB health report. Orphan rules are defined per class, and only a single orphan rule can be defined per class.

    Before you begin

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

    About this task

    Specify the conditions that CIs must meet to be considered an orphan CI. Specify attributes that a CI must have, relationships that a CI should not have, or both. In the relationship conditions, you can either specify that the CI has no relationships, or a set of specific relationships that the CI doesn't have.
    Note:
    If there is a health inclusion rule for the orphan metric, then the conditions in the health inclusion rule and the conditions in the health orphan rule, shouldn't be identical.

    A health orphan rule can for example, identify a CI of the cmdb_ci_computer class as an orphan CI if the CI is not set with an owner or an asset.

    Procedure

    1. Navigate to All > Configuration > CI Class Manager.
    2. Select Hierarchy to show the CI Classes list and then select the class for which to create an orphan rule.
    3. In the class navigation bar, expand Health, select Correctness, and then select the Orphan Rule tab.
    4. Select a rule to edit, if one exists, or select New, and then fill out the form.
      Field Description
      Class The class for which the orphan rule applies.
      Attributes Attribute conditions that a CI must satisfy to be considered an orphan CI. For example, the filter conditions in which both the Assigned to and the Owned by fields are empty, will identify the matching CIs as orphans.
      Condition And/Or operation between the Attributes conditions and the Relationship conditions.
      Relationship

      The relationship conditions that a CI must fail,based on records in the CI Relationship [cmdb_rel_ci] table, in order to be considered an orphan CI.

      To specify that a CI must have no relationships, choose Any Relation and Any Class respectively.
    5. Select Submit or Update to save the rule.