CMDB Health Inclusion Rules – Detailed Troubleshooting GuideSummary<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: #000000; } span { font-size: 12pt; font-family: Lato; color: #000000; } h2 { font-size: 24pt; font-family: Lato; color: black; } h3 { font-size: 18pt; font-family: Lato; color: black; } h4 { font-size: 14pt; font-family: Lato; color: black; } a { font-size: 12pt; font-family: Lato; color: #00718F; } a:hover { font-size: 12pt; color: #024F69; } a:target { font-size: 12pt; color: #032D42; } a:visited { font-size: 12pt; color: #00718f; } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } Purpose CMDB Health Inclusion Rules define which Configuration Items (CIs) are evaluated for CMDB Health metrics (Completeness, Correctness, Compliance) and displayed on the CMDB Health Dashboard. Misconfiguration can cause: Metrics not running for expected CI classes.Dashboard showing empty or incorrect scores.Performance issues due to overly broad scope. What Are Inclusion Rules? Inclusion Rules filter CIs for health calculations and dashboard display.They apply to metrics like Required, Recommended, Duplicate, Orphan, and Staleness.Stored in cmdb_health_config table. UI Path to Configure Navigate to: CI Class Manager → Health → Health Inclusion Rules Common Misconfiguration Symptoms Dashboard shows no data for key classes Inclusion rules exclude critical CI classes (e.g., Servers, VMs). Metrics applied to wrong classes Metric configured for Un-necessary classes. Performance degradation Inclusion rules too broad (e.g., include all cmdb_ci records). Jobs stuck or timeout Overly large scope causes Daily Time Out Pause or Max Failures status. Troubleshooting Flow Step 1: Verify Inclusion Rules Open CI Class Manager → Health → Health Inclusion Rules.Check: Classes included (e.g., cmdb_ci_server, cmdb_ci_vm_instance).Conditions applied (e.g., Operational status = Operational, exclude retired). Confirm rules exist in cmdb_health_config table. Step 2: Validate Metric Scope Inclusion rules apply per metric: Completeness → Required/Recommended fields.Correctness → Duplicate, Orphan, Staleness. Step 3: Check Job Status Navigate to CMDB Health Dashboard Jobs.Verify job status in cmdb_health_metric_status: States: Complete, Max Failures, Daily Time Out Pause. For processing depth by class, review cmdb_health_processor_status. Step 4: Reduce Scope if Needed If jobs fail or timeout: Narrow inclusion rules to principal CI classes (Servers, VMs, Network Gear).Apply lifecycle filters: Install status or Operational Status.Exclude retired or decommissioned CIs. Avoid “include all classes” as it impacts performance. Step 5: Re-run Jobs After rule changes, re-execute CMDB Health jobs.Validate dashboard data after job completion. Tables Involved cmdb_health_config – Stores inclusion rules.cmdb_health_metric – Metric definitions.cmdb_health_metric_status – Job run status.cmdb_health_result – Health evaluation results. Best Practices Include only principal CI classes: Servers, Virtual Machines, Network Gear, Applications. Apply lifecycle filters: Operational status = Operational.Exclude retired or decommissioned CIs. Review rules periodically to avoid scope creep. Performance & Failure Threshold If Max Failures occurs: Check Failure Threshold in Health Preferences (stored in cmdb_health_metric_pref).Default documented as 50,000 failures; can be increased if necessary.Do not raise excessively—prefer refining rules to reduce systemic failures. (Source: CMDB Health Dashboard Workshop & Troubleshooting Guide) Validation Checklist Inclusion rules include correct classes and conditions.Jobs active and executed successfully.Metric status shows Complete.Dashboard reflects expected CI classes. Related Links<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: #000000; } span { font-size: 12pt; font-family: Lato; color: #000000; } h2 { font-size: 24pt; font-family: Lato; color: black; } h3 { font-size: 18pt; font-family: Lato; color: black; } h4 { font-size: 14pt; font-family: Lato; color: black; } a { font-size: 12pt; font-family: Lato; color: #00718F; } a:hover { font-size: 12pt; color: #024F69; } a:target { font-size: 12pt; color: #032D42; } a:visited { font-size: 12pt; color: #00718f; } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } Create health inclusion rule