View CI relationships health

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

    • View aggregated orphan, stale, and duplicate CI relationships in the CMDB dashboard. You can configure the relationship scorecards, but you cannot configure the underlying relationship KPI health tests.

    Before you begin

    The CMDB Health Dashboard - Relationship Compliance Processor dashboard job must run to generate data for these reports.

    Role required: itil or asset

    About this task

    CMDB Health measures CI relationship health using a separate KPI and metrics.

    Orphan relationship
    A relationship that is missing parent, child, or relationship type.
    Duplicate relationship
    Relationships that have identical parent, child, and relationship type.
    Stale relationship
    A relationship in which one of the CIs is stale. For a stale CI — its associated relationships are also stale.
    In addition, the following relationship compliance reports are available:
    Relationships not compliant with all relationship rules
    Relationships that do not comply with any relationship governance rule, including suggested relationships and dependent relationship rules.
    Relationships not compliant with suggested relationships
    Suggested CI relationships are used as rules to test if relationships comply with specified suggested relationships.
    Relationships not compliant with containment rules
    Containment rules are used to test if relationships comply with specified containment relationships.
    Relationships not compliant with hosting rules
    Hosting rules are used to test if relationships comply with specified hosting relationships.
    For each of the compliance reports, testing a relationship requires a rule (suggested relationship, hosting rule, or containment rule) in which the parent and child CI classes match the parent and child CI classes in the tested relationship. If the relationship types in the rule and in the tested relationship do not match, then the relationship is not in compliance. If an applicable rule is not found, then the relationship is considered to be in compliance. Rules apply to the classes specified in the rule, and also to descendant classes. Therefore, when testing a relationship, rules that apply to ascendant parents of the CIs in the tested relationship are used. If there are multiple rules that match the parent and the child CI classes of the tested relationship, then the tested relationship needs to satisfy only one of these rules to be in compliance.

    Procedure

    1. Navigate to All > Configuration > CMDB Dashboard > CMDB View.
    2. Select the Relationship Health tab.
    3. Scroll to the bottom of the page to examine the relationship compliance reports.
      Report results are grouped by relationship type, and you can drill down for further details:
      • Point to a relationship type to display its label and the % of relationships that are not in compliance.
      • Click on a relationship type to drill down to a detailed list of all the relations of that type that are not compliant. Click on a specific relationship to display more details such as the failure description. The Failure Description field lists only a single rule that the relationship did not comply with, even if there are additional rules that the relationship fails to comply with.

    What to do next

    For troubleshooting information, see the How to identify and delete duplicate CMDB CI Relationship records, or ones that have orphan or missing parent/child relationships [KB0780988] knowledge base article.