Create a CMDB Health orphan rule

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture

    • 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. Orphan rules are defined per class, and only a single orphan rule can be defined per class.

    Avant de commencer

    Role required: sn_cmdb_editor and itil have read access, sn_cmdb_admin and itil_admin (on top) have full access

    Pourquoi et quand exécuter cette tâche

    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.
    Remarque :
    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. Or, for example, you can create an orphan rule for a CI in the Disk [cmdb_ci_disk] class. If that CI doesn't have a Contains::Contained by or Contained by::Contains relationship with a Computer CI, then it is an orphan CI.

    Procédure

    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.