# Issues dashboard

<figure><img src="https://2867423571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfJjIdV9cuW6K8asJjTPJ%2Fuploads%2FE6CV4IoZnZHpLbfA6Bcd%2F1%20(1).png?alt=media&#x26;token=162f5904-6056-43ae-9716-f0dbe37a343b" alt=""><figcaption><p>Issues Dashboard in the Stacksync app</p></figcaption></figure>

The issues dashboard helps you:

1. get alerted in real-time about syncing issues
2. identify syncing issues for any record
3. fix the issue with one-click action options

When any of your systems is down or is in maintenance, or when some data updated in one system and cannot be updated in the other system for example due to datatype issues, custom validation rules (e.g. invalid phone number in a CRM), etc., the record won't be able to sync. When a record cannot sync, it will be displayed in the record issues dashboard.

Unlike other solutions that let your pipelines silently fail or switch off entirely, Stacksync keeps your mission-critical services up and running all the time and flags you which records had syncing issues so you can investigate and fix the issue with a single click.

For each issue, a detailed report and recommendation on how to fix it is included in the *Issues details* panel.

<figure><img src="https://2867423571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfJjIdV9cuW6K8asJjTPJ%2Fuploads%2FmH2FGimOdLvx3KPL6DqL%2F2%20(1).png?alt=media&#x26;token=e21ed16b-5813-453a-b68b-a773e3588c80" alt=""><figcaption><p>Issues Dashboard in the Stacksync app, with the Issue Details panel open.</p></figcaption></figure>

{% hint style="info" %}
Consider the following situation to illustrate the following examples:\
System\_A and system\_B are in bidirectional sync. If a record in system\_A was updated with a value that cannot sync to system\_B (e.g. invalid phone number, or modification in system\_A of a read-only column in system\_B), the data update will not sync and will result in an issue in the Issues dashboard for that given record.
{% endhint %}

Issue resolution options are:

1. **Revert change**\
   **Reverts the erroneous value in system\_A with its previous value** still stored in system\_B (since the value update from system\_A did not sync properly and ended up in the Issues dashboard). Since Stacksync does not store any of your data, Stacksync will query system\_B for the exact record and fields concerned by the issue (cherry-pick the exact values) and sync it back to system\_A. The end result is that system\_A is reverted to its previous value, and system\_A and system\_B are again consistent.
2. **Retry to sync**\
   **Attempts to sync again the same value from system\_A to system\_B.** For instance, if the issue was caused by an "invalid phone number" error in your CRM (system\_B in our example), and that the validation rule was removed, then retrying to sync the same value again from system\_A to system\_B should now successfully write the value to system\_B. The end result is that system\_B is updated with the value from system\_A, system\_A and system\_B are again consistent.\
   Since Stacksync does not store any of your data, Stacksync will query system\_A again to get the record's latest values and sync these values to system\_B.
3. **Ignore issue**\
   **Ignores the issue and removes it from the Issues dashboard.** If your business use case requires system\_A and system\_B to have different states and tolerates inconsistencies between your systems, you can clean up your Issues dashboard by ignoring issues. The end result is that system\_A and system\_B will each contain different values for the given fields affected in the issue for that given record.\
   It is in general not recommended to ignore issues as the business use cases are limited. If you have any doubt, talk with the Stacksync support team to confirm before taking action. If you ignore Issues by mistake and would like to restore them, contact the Stacksync support team to restore the Issues in your Issues dashboard. Stacksync saves ignored Issues for a duration equal to the *log retention policy* associated with your pricing plan.

You can resolve issues with any of the 3 options above at scale with **bulk actions**. Select which records you want to resolve the issue for, and resolve them in bulk. Issue management and resolution can also be handled programmatically via API. Please contact the Stacksync support team to get access to the Stacksync management API.

When an Issue is resolved, it is removed from the Issues dashboard. When your Issues dashboard is empty, your systems are fully consistent and in sync!

<figure><img src="https://2867423571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfJjIdV9cuW6K8asJjTPJ%2Fuploads%2FAci7UfwjTSzWPlxRMuq9%2F3%20(2).png?alt=media&#x26;token=bc36c1bb-fa81-43cd-abe6-4e9a22c07f45" alt=""><figcaption><p>Issue Details panel</p></figcaption></figure>
