Create health inclusion rule

Filter the CIs that are included in health calculations and that appear in CMDB health dashboards by defining health inclusion rules. Health inclusion rules can be specified per domain.

Before you begin

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

About this task

Evaluation for the required, orphan, recommended, duplicate and staleness health metrics, will apply only to CIs that satisfy health inclusion rules. For example, if you want scores of the duplicate metric to appear only for server and network CIs.

Note:

• Creating health inclusion rules at the level of the base cmdb_ci table can potentially filter out health results of all classes in CMDB health dashboards.
• Applying a health inclusion rule to the duplicate metric, is supported only in the global domain.
• Due to performance issues, dot-walking in health inclusion rules for the duplicate metric is not supported.

In addition to any health inclusion rules, identification inclusion rules also indirectly impact what appears in CMDB health dashboards for duplicate CIs. The dashboard itself uses the identification engine (IRE) to identify duplicate CIs and therefore identification inclusion rules are applied.

Inheritance of health inclusion rules:

• If there are no health inclusion rules specified for a child class, then rules specified on a parent class are applied to the child class.
• If health inclusion rules are specified for a child class, then those rules take precedence over rules specified on a parent class.

In the base system, there are no predefined health inclusion rules, in which case all CIs are included in the CMDB Health calculations.

Procedure

1. Navigate to All > Configuration > CI Class Manager.
2. Click Hierarchy to display the CI Classes list.
3. Select the class for which to create a health inclusion rule.
4. In the class navigation bar, expand Health and then click Health Inclusion Rules.
5. Click an existing rule to edit or click New and then fill out the Health Inclusion Rules form.

   Field	Description
   Applies to	Class this rules applies to.
   Active record condition	Criteria that CIs must meet to be included in the evaluation for the specified health metrics.
   Applies to metric	Metrics that the rule applies to.

6. Click Save or Update.

What to do next

You can delete a health inclusion rules that is no longer needed by selecting that rule, and then on the CMDB Health Configuration form, selecting Delete.