View CI health

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

    • The CI dashboard is a central location displaying health report for an individual CI, history of changes to the CI in a timeline view, and the relation formatter. The CI dashboard also displays incidents, changes, and other tasks affecting the CI, and business services affected by the CI. You can access the CI dashboard from a CI form, or from the CMDB dashboard.

    Before you begin

    Role required: asset or itil

    About this task

    The health scores are based on settings of CMDB Health KPIs and metrics. The report is calculated in real-time from data stored in health-related tables which the CMDB Dashboard jobs update on a recurring schedule. The completeness and correctness KPIs are always up to date, but for other KPIs, it is possible that updates to the CMDB are not reflected because one of the dashboard jobs hasn’t run yet, as follows:
    • Compliance: Depends on audit cycles and on the 'CMDB Health Dashboard - Compliance Score Calculation' job.
    • Relationships: Depends on the 'CMDB Health Dashboard - Correctness Score Calculation' job.
    To ensure that the latest updates to these KPIs are reflected on the CI dashboard, navigate to the respective dashboard job, and click Execute Now.

    Procedure

    1. Go to a dashboard in one of the following ways:
      • On a CI form click Dashboard.
      • Use the class hierarchy:
        1. Navigate to CMDB Dashboard > CMDB Health.
        2. Click CMDB Dashboard - All to display the class hierarchy. Enter a search string.
        3. Select a CI from the Configuration Items group.

        The search results are grouped by Classes and Configuration Items that match the search string.


    Result

    Various widgets in the report display CI's health with the following color codes:

    • Green: The CI passed the health test (for example, it is not a duplicate).
    • Red: The CI failed the health test (for example, it is a duplicate)
    • Grey: The CI was not tested for this metric, because the threshold was not set for the CI (class) in the CI module.

    The report displays the change history for the CI in a timeline format, that you can zoom in or out to select a time period for which to display details for. Use the related lists tabs Change, Incident, Task, Business Services, and Alerts to further drill into additional details.

    Note:
    Missing rules or other class definitions can prevent some health scores from being evaluated for a CI. The results in the CI dashboard in these situations, are described below:
    Duplicate
    • If no identification rules ([cmdb_identifier]) are defined for the CI’s class or its ancestors: A notification to that effect appears.
    • If only dependent identification rules are defined: Not applicable notification appears.
    Orphan
    • If the CI is excluded by health inclusion rules: Not applicable notification appears.
    • If no orphan rules ([cmdb_health_orphan_rule]) are defined for the CI’s class or its ancestors: A notification about missing a rule appears.
    Staleness
    • If the CI is excluded by health inclusion rules: Not applicable notification appears.
    • If no staleness rules ([cmdb_health_staleness_rule]) are defined for the CI’s class or its ancestors: A notification about missing a rule appears.
    Audit
    • If no audits ([cert_audit]) are defined for the CI (CI dashboard checks only desired states and scripted audits): Not applicable notification appears.
    • If there are audits defined for the CI but the audits did not run: Not applicable notification appears.