Review health
Purpose
This article guides you through the Review Health step in Analytics Product Setup. Review Health is a diagnostic tool that audits your Analytics configuration against actual recruitment data to surface setup issues before they affect dashboard accuracy. It identifies configuration gaps, data ingestion issues, and rule failures so you can resolve them proactively.
Audience
New users, administrators (admins), solution architects, partners, and Eightfold employees.
Getting Started
- Navigate to Admin Console > Home > Product Setup.
- Under Analytics, click Set up.
- Click Manage Rules under the Review Health section, or complete the Configure stages and Configure metrics steps first and proceed to step 3/3.
The Review Health page shows:
- A pass/fail rule count (for example, 5/6 rules passed)
- Health score cards for overall and category-level health
- A dashboard health table listing quality scores per dashboard
Health score cards
| Score | What it measures |
| Overall health | Average health score across all active rules |
| Config health | Health of your Analytics configuration settings |
| Data health | Health of the data being ingested (shown as NA if no data is available) |
| Operational health | Health of ongoing operational metrics (shown as NA if no data is available) |
Dashboard health table
The table lists dashboards with their product line and quality score. Expand a dashboard row to see the individual rules associated with it and their pass/fail status.
Use the Dashboards and Product Line filters to narrow the view.
Understanding rule statuses
| Status | Meaning | Action |
| Pass (green) | Configuration is complete and matches the data in the system | No action needed |
| Fail (red) | A critical mismatch or missing configuration has been detected | Follow the remediation steps shown in the rule detail |
| NA / grey | The rule is descoped or no data is available to run the check | No action needed unless the feature should be active |
Scoping and descoping rules
Not every customer uses every feature. You can descope a rule to prevent it from affecting the overall health score when a feature is not in use. For example, if a customer does not use Candidate Rediscovery, descoping that rule prevents it from lowering the health percentage unfairly.
Troubleshooting failed rules
- Expand the failed dashboard row in the health table.
- Locate the failing rule. The rule detail shows:
- Metric % — the percentage of data records affected by the failure.
- What it means — a plain-language explanation of the error.
- Possible next steps — a direct link to the setup page that needs fixing.
- Navigate to the linked setup page and resolve the issue.
- Return to Review Health and click Reload to re-run the health checks.
Warning: The reload takes approximately 5 minutes. Do not import any data during this window, as it may cause quality scores to fail or result in data corruption.
Reloading health scores
After fixing a configuration, click the Reload button to trigger a re-scan and update the health scores. This reflects your latest configuration changes in the health table.
Setting up automated notifications
You can configure automated alerts to be notified when a rule fails, without having to check the dashboard manually.
- Click Manage notifications.
- In the Manage notifications dialog, fill in the following fields:
- Notification Name — a unique label for this alert (for example, "Weekly Analytics Health Check").
- Subscriber emails — email addresses of the people who should receive the alert.
- Cadence — how often the alert is sent (Daily, Weekly, Monthly, or Every 30 minutes).
- Health Type — the type of health score to monitor (for example, Overall Health).
- Product Areas — the product areas to include in the alert.
- Click Save.
Note: Notifications are only sent when at least one rule fails. If all rules pass, no email is sent.
Troubleshooting persistent failures
If a configuration looks correct but the health rule is still failing, check these two root causes:
- Data ingestion issue: Data may be delayed or stuck during transfer from the ATS to Eightfold. Verify your ingestion pipeline is running correctly.
- Source system issue: The client may not be updating candidate or position statuses in their own ATS. Confirm that the ATS is pushing the latest data.
Usage
Required/Optional: Required
Key benefits
- Proactive alerts: Get notified the moment a configuration gap is detected, rather than waiting for customers to report broken numbers.
- Root cause identification: Quickly distinguish between a configuration error in Eightfold setup and a data ingestion issue from the client's ATS.
- Trust architecture: Ensures that Hired and Offer stages are correctly mapped so that Time to Fill and conversion metrics are valid.