Synchronization Logging

Overview

After you've configured and activated an integration, you can check the progress and results of synchronizations between the systems in the Synchronisation Logging section.

To navigate to the section, in the administration area, select Sync Logging in the sidebar.

You can view synchronization logs to ensure that the integration works as expected. If you see errors or warnings, adjust the configuration of the integration. To learn more, see Best Practices.

Synchronization Runs

The Synchronisation Logging page shows synchronization runs for all active integrations configured within a workspace.

During a synchronization run, the system checks if data is synchronized between the source and the target. If there is a mismatch in data, the corresponding operation to create, update, or delete a resource is performed.

Full synchronization runs are automatically initiated by the integration. In most cases, synchronizations are initiated at least once per day. You can also initiate a synchronization run manually.

The following table lists parameters of a synchronization run that appear on the Synchronisation Logging page.

Logging Details

To view logs for a specific synchronization run, on the Synchronisation Logging page, click the link in the Date column.

The Logging details page contains a list of actions for a synchronization run.

Parameters of a synchronization action:

• Date: The date and time when the synchronization action started.
• Source and Target: The source and target of the synchronization action and their identifiers. The source and target depend on the data flows configured in the integration.
• Action: The action of the operation:
  • If there is a mismatch in data between the systems, the action reflects the corresponding operation: CREATE, UPDATE, or DELETE.
  • If there is no mismatch in data, the action is NONE.
• Status: The status of the action: OK, ERROR, WARNING, or INFO. Learn more about why synchronizations fail.
• Message: The details of the synchronization action.
  • To view full details of the operation, click the message. You can copy the message to your clipboard to initiate troubleshooting.

Why Synchronizations Fail

A synchronization action may result in an error in the following cases:

• The integration is improperly configured.
• Some permissions in the integration are improperly configured or insufficient. For example, "read" access is set instead of "write."
• There is duplicate or missing data between the systems.
• A programming error has occurred.

Initiating a Synchronization Run Manually

You can initiate a synchronization run manually. This may be required when you have updated the configuration of your integration and want to verify if specific issues were fixed.

📘

Note

The procedure for manually initiating a synchronization run may differ for some integration types. The names of UI elements may vary.

To initiate a synchronization run manually, follow these steps:

1. In the administration area, navigate to the Integrations section.
2. Select the integration that you need. The integration status must be Active.
3. To go to the configuration page, click Configure.
4. Click Run Sync (Trigger Synchronization).

A new synchronization run starts. You can check the progress in the Synchronisation Logging section.

To cancel a synchronization run in progress, on the Synchronisation Logging page, click Cancel Sync under Actions. For some integration types, this option is not available.

Best Practices

Follow these steps:

1. In the Synchronisation Logging section, filter synchronization runs for the desired integration. Pay attention to runs with the ERROR and WARNING statuses.
2. To view actions for a specific synchronization run, navigate to the Logging details page. You can filter items with the ERROR and WARNING statuses.
3. Identify the root causes of the problem using log messages.
   You can use the search field to find a specific Fact Sheet. If needed, update data in that Fact Sheet to fix the problem.
   
4. Once you have fixed issues in your integration, check the results of the next synchronization run. You can also initiate a synchronization run manually. If the problem persists, contact SAP LeanIX for assistance.