Troubleshoot item level Server-Side Synchronization issues with Dynamics 365

Applies to: Dynamics 365

Introduction


A new Server-Side Synchronization dashboard has been introduced that enables you to view item level failures for incoming email, outgoing email, and ACT (Appointments, Contacts, and Tasks) sync. This can help you troubleshoot issues such as why a specific email was not tracked automatically by Server-Side Synchronization.

 

Enabling the Feature


This feature currently requires an OrgDBOrgSetting (EnableSssItemLevelMonitoring) to be enabled and this setting is documented here. The EnableSssItemLevelMonitoring setting can also be enabled easily using the OrganizationSettingsEditor tool.

This feature is available in version 8.2 and 9.x organizations of Dynamics 365 (online).

Usage


After following the required steps above to enable this feature, follow the steps below to locate and use the new dashboard:

  1. Open the Dynamics 365 web application and navigate to the Dashboards area.

    Example: Sales -> Dashboards or Service -> Dashboards.
     

     

  2. Locate and select the Server-Side Synchronization Failures dashboard from the dashboard list.

    Server-Side Synchronization Failures Dashboard selection
  3. If you locate a specific email or ACT item that did not sync as expected, you can view the reason in the Sync Error column. Clicking the link will direct you to a help article for that error if one exists.

    Server-Side Synchronization Dashboard

Additional Details


  • This data is stored in the ExchangeSyncIdMapping table which could potentially get large if this feature is enabled. That is why the ExchangeSyncIdMappingPersistenceTimeInDays setting was also introduced and has a default of 3 days.
  • ExchangeSyncIdMapping info is only visible to the owning user. That is why the owner of the mailbox needs to view the dashboard to see the details for their synchronization failures.
  • If synchronization for a mailbox is not working at all, see Troubleshooting Server-Side Synchronization.

Known Issues


This dashboard does not currently work when viewed using the new Unified Client interface. You will see the following error:

"Components added to dashboard are not supported to be shown in this client"