How To - Enable detailed CI Sync Agent Logs

Aim

Enabling detailed CI Sync Agent logs will assist in diagnosing issues with Synchronization jobs.

This KB applies to:

Applies to Versions

All

Applies to Source Connectors

All

Applies to Destination Connectors

All

Process

Enable detailed logging

To generate detailed logging complete the following steps:

  1. On the CI Sync agent machine:

    1. Stop the CISynchronizerAgent service.

    2. Open the appSettings.json file in Notepad. The file should be at: C:\Program Files\Syncfish\CISynchronizerAgent\service

    3. Take note of the current settings for the below as you will want to revert back to them later:

    4. Change the "FileLogLevel" to "Verbose" (record the previous value first)

    5. Change the "WorkflowLogLevel" to "Task" (record the previous value first)

    6. Save the changes to the appsettings.json file.

      image-20261014-034027.png

      g. Start the CISynchronizerAgent service.

  2. In the CI Sync UI:

    1. Re-run the job in question but only sync the record set of concern to minimize the size of the log output file. CI Sync will also pre-select any dependant record sets that may also be required.

    2. For example, to diagnose VMware relationships you would make the following selections in the Run UI.

      image-20261027-071545.png
      image-20261027-071630.png
  3. On the CI Sync agent machine:

    1. Revert the Agent "FileLogLevel" and "WorkflowLogLevel" values back to their previous configuration.

    2. Navigate to the logs directory.
      It should be at: C:\Program Files\Syncfish\CISynchronizerAgent\service\logs

    3. Zip up the contents of the logs directory, including the ExecutionLogs and Instances sub folders

    4. Attach the zip file to the SUP ticket for analysis.

More information

N/A

There are currently no related articles.

Control Information

Created

Reviewed


Data Classification

PUBLIC
Classified in accordance with the Syncfish Data Classification Framework