How to fix synchronization failures with the Health Monitor

The Health Monitor gives you real-time visibility on the health of your product data catalog synchronizations. It helps you detect issues early, understand what went wrong, and take action quickly.

Use the Health Monitor to:

• Check the status of Catalog, Recommendations, Merchandising, Analytics and Search

• View recent sync and deployment operations

• Understand errors with human-readable explanations

• Retry a failed synchronization

• Monitor the number of imported products

• Enable email notifications when issues occur

Where to find the Health Monitor ?

In App2 > Setting > Recommendations & Merchandising → Health Monitor

What to find in the overview Health Monitor ?

The Overview displays everything you need to know at a glance.

Alert Banner

If a recent issue occurred (e.g., failed sync), an alert banner will appear at the top of the page with a quick summary and a link to investigate.

Operation History

The history lists all recent operations:

• Catalog synchronizations

• Deployments

• Imports

• Updates

Each operation shows whether it was a success or a failure, the date and time, the duration of the synchronization, and hover buttons to access to the viewing operations details details and relaunch this specific synchronization in case it's failure.

Use this history to track what happened and when.

Available soon : service Status Indicators

Meaning of badge colors :

Color	Meaning
🟢 Green	Everything works normally
🟡 Yellow	Something unusual detected
🔴 Red	A sync or deployment has failed

What to find in the viewing operation details?

The operation details modal shows what happened during the sync:

• the type of operation,

• timestamps,

• duration,

• and whether it succeeded or failed.

If something went wrong ?

You’ll see the root cause, a clear explanation, the impacted services, and options to retry the sync or confirm that you fixed the issue.

How to setup catalog volume guard to protect your catalog?

To avoid publishing an incomplete catalog, you can choose the percentage threshold that will trigger a blocked sync. Go to Settings → Recommendations & Merchandising and select the % of product count deviation you want to allow. If the deviation exceeds this threshold, the sync is automatically blocked.

How to setup email notifications to stay informed ?

Regarding the notifications mail, you can receive alerts when:

• A sync fails

• A deployment fails

• A sync succeeds

To enable notifications go to User Settings → Notifications → Health Monitor

Emails include:

• A summary of the issue

• What it means

• What you can do

• A link to open the Health Monitor

Still stuck?

Contact your CSM or Support with:

• The operation ID

• The sync timestamp

• The error displayed