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

{% hint style="info" %}
**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
  {% endhint %}

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

<figure><img src="https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2Ff6livF1BN4VsEtBr2eJi%2Fimage.png?alt=media&#x26;token=7de8f298-7389-4b4e-bb6d-04a4fbbbfa01" alt=""><figcaption></figcaption></figure>

#### 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](#what-to-fin-in-the-viewing-operation-details) details and relaunch this specific synchronization in case it's failure.

Use this history to track what happened and when.

<figure><img src="https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2FXv27kwBGR8AdFhwybGYW%2Fimage.png?alt=media&#x26;token=d51edfc7-770e-4434-a89d-5acfc9876b59" alt=""><figcaption></figcaption></figure>

#### Available soon : service Status Indicators

<figure><img src="https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2F1A5eXZnqgPeUgIEFnfrr%2Fimage.png?alt=media&#x26;token=41e6ef1f-563f-46d8-a7eb-bb6663164f36" alt=""><figcaption></figcaption></figure>

**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?

{% columns %}
{% column %}
The operation details modal shows what happened during the sync:&#x20;

* the type of operation,&#x20;
* timestamps,&#x20;
* duration,&#x20;
* 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.
{% endcolumn %}

{% column %}
![](https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2FxNyOd5SoOySJpHl3XWA1%2Fimage.png?alt=media\&token=bec2244e-6689-42bf-ae3f-74cb1f9f3e11)
{% endcolumn %}
{% endcolumns %}

#### 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 ?&#x20;

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

<figure><img src="https://2350286830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6Yw9IRJ6KbbucQPwZUCZ%2Fuploads%2FXc8XvBuXRKDvWTP0QCy5%2Fimage.png?alt=media&#x26;token=cf79877b-1210-429c-943d-27a74bf79dc6" alt=""><figcaption></figcaption></figure>

#### Still stuck?

Contact your CSM or Support with:

* The operation ID
* The sync timestamp
* The error displayed
