Enable and configure a CMDB Health Dashboard job

task brazil Updated Sep 10, 2026 1 min read t_EnableCMDBHealthDashboardJob.md
Raw file servicenow.com

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 job Description
    CMDB Health Dashboard - Completeness Score Calculation Script for calculating the completeness KPI of CMDB health.
    CMDB Health Dashboard - Compliance Score Calculation Script for calculating the compliance KPI of CMDB health.
    CMDB Health Dashboard - Correctness Score Calculation Script for calculating the correctness KPI of CMDB health.
    CMDB Health Dashboard - Relationship Score Calculation Script for calculating the CI relationships KPI of CMDB health.
    CMDB Health Dashboard - Relationship Compliance Processor Script for calculating compliance of relationships with suggested relationships, and with hosting and containment rules.
  3. Review the default configuration, and update as necessary.

Field

Description

Name

Job name. Leave this field with the pre-populated name.

Active

Select to activate the job.

Conditional

If 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 zone

Local time zone.

Run this script

The job's script. Note: Changes to the script might result in unexpected behavior.

4. 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.

Search documentation
Search document titles and file paths on the brazil branch