Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Enable and configure a CMDB Health Dashboard job

Enable and configure the CMDB Health Dashboard jobs that process CMDB Health tests, to start calculating CMDB Health scores for the completeness, compliance, correctness KPIs, associated metrics, and relationships.

Before you begin

Role required: sn_cmdb_admin or admin

About this task

In the base system, CMDB Health Dashboard jobs are disabled by default. Enable and configure the respective job for the CMDB health KPI that you want data collected and aggregated for. You can schedule a job to run on a recurring schedule, or run it once at any time.

For more information about how CMDB Health Dashboard jobs work, see the Understanding the CMDB HealthDashboard Numbers blog post in the ServiceNow Community.

Procedure

  1. Navigate to All > Configuration > Health Preference.

  2. Select Scheduled Jobs on the left-side bar and then select the job that you want to enable or configure.

    CMDB Health Dashboard jobDescription
    CMDB Health Dashboard - Completeness Score CalculationScript for calculating the completeness KPI of CMDB health.
    CMDB Health Dashboard - Compliance Score CalculationScript for calculating the compliance KPI of CMDB health.
    CMDB Health Dashboard - Correctness Score CalculationScript for calculating the correctness KPI of CMDB health.
    CMDB Health Dashboard - Relationship Score CalculationScript for calculating the CI relationships KPI of CMDB health.
    CMDB Health Dashboard - Relationship Compliance ProcessorScript for calculating compliance of relationships with suggested relationships, and with hosting and containment rules.
  3. Review the default configuration, and update as necessary.

FieldDescription
NameJob name. Leave this field with the pre-populated name.
ActiveSelect to activate the job.
ConditionalIf selected, the scripted condition must evaluate to true before the job can run.
Run

Configure the schedule for job execution, or select On Demand to run the job manually when needed.

If Active is selected, then additional fields appear according to your choice. For example, Repeat Interval (when Run is set to Periodically), and Time for various settings of Run. Fill in the details to set precise running times.

Time zoneLocal time zone.
Run this scriptThe job's script. Note: Changes to the script might result in unexpected behavior.
  1. Select Execute Now to immediately run the job once.

Result

After you enable a CMDB Health Dashboard job, the results for the KPI are aggregated and appear in the CMDB Health dashboard and CI Health widget on CI forms, at the CMDB, class, and CI levels.