How To Monitor User Sync For Failures

Problem

User Sync can't run another synchronization because it is falsely reporting that another sync is still running.

Cause

Sometimes User Sync is not able to complete a sync because of unforeseen events which cannot be catched in our app's code directly,
an intermittent database outage for instance.

Solution

Until we've implemented a notification for that directly, you can monitor the log file after changing the logging as per the these instructions:

Add a new package to the log for your Atlassian host product and make sure it's persistent across instance restarts.
See the instructions on how to do that for Jira, Confluence, Bitbucket, Bamboo and Fisheye/ Crucible.

Starting from SAML SSO v6.7.0 / User Sync v2.10.0, the below package needs to be logged with INFO level.

Whenever a sync starts/ends, a new record in the log file will be created. Based on this, you can set up and alert / automation to get notified. 

Here are some examples of the different states and their records in the log file:

Sync has started

Sync has partially failed

Sync has failed