# 09. Synctool Logging ## Introduction This section describes how to customize event logging, view recent logs and events or set up automated log digests by email. These functions are grouped under the **Logging** tab in the Synctool user interface. **Tip** **Some logs or events may be shown twice in the Synctool logs and events** The Zivver Synctool performs a mock synchronization before it does an actual synchronization. The mock synchronization could be causing log or event entries for a specific user to appear twice. ## Email Reporting At **Email Reporting** set up an automated email report, so that you receive updates in your mailbox from Synctool synchronizations. Zivver recommends setting up email reporting as this notifies the administrator of any synchronization errors without having to log in to the Synctool server to look for errors in the synchronization logs. You decide by checking the corresponding boxes if you only want to receive email reports in case of errors or every time the Synctool was run scheduled and unattended. By default no email report is sent, therefore the first step is to check the box at **Send sync results by email**. - **SMTP Relay Host** The **SMTP Relay Host** field specifies the host name or IP address of the SMTP relay, for example `smtp.example.org`, `smtp.office365.com`, or the relay host IP address. This field is mandatory. **Tip** **Use Microsoft 365 documentation for more in-depth information** [How to set up a multifunction device or application to send email using Microsoft 365 or Office 365](https://docs.microsoft.com/en-us/exchange/mail-flow-best-practices/how-to-set-up-a-multifunction-device-or-application-to-send-email-using-microsoft-365-or-office-365) - **Port** The **Port** field defines the port used for SMTP traffic. Enter `587` (recommended) or use port `25`. This field is mandatory. - **Use TLS** Check the box at if you want to use TLS. - **User name** If you need to authenticate towards the SMTP Relay Host, then fill in the username for authentication. This may not be necessary. - **Password** If you need to authenticate towards the SMTP Relay Host, then fill in the password associated with the username for authentication. This may not be necessary. - **From Address** The **From Address** field specifies the sender address for the email reports. This can be a fictional address, such as `synctool@your-organization-domain.com`. This field is mandatory. Recipients will receive the email reports from this (fictional) address. - **Recipients** The **Recipients** field specifies the email address that should receive the report. This can be a personal or shared mailbox. To add multiple addresses, separate them with a semicolon `;` or add each new address on a separate line. This field is mandatory. - **Send test mail** Send a test mail to test if you can send a message from the Synctool server to the recipients. **Note** **If the test email fails** If the test email failed, please consult your Exchange administrator or documentation on your mail server on how to relay SMTP messages. - **Mail only in case of errors** Check this box if you only want to be emailed when an error occurs during synchronization. Zivver recommends enabling this feature. - **Mail only when in Silent Mode** (recommended) Check this box if you want to be emailed when the Synctool was run scheduled and unattended. For example by the Windows Task Scheduler. ## Event Logging At **Event logging** you enable the options to write events to a file, Windows Events Log and create an Event summary. ### Write events to a file Enable **Write events to file** and specify a folder by clicking Browse. The log file will contain a status of how an account is processed during that synchronization. **Tip** **Write event files in the Synctool folder** Best practice is to store the event files where you have stored the Synctool. For example, if you have stored the Synctool at `C:\Program Files\Zivver.Synctool`, then create a folder called **Logs**. So that you can save the event logs in `C:\Program Files\Zivver.Synctool\Logs`. If you enable **Write events to file** but do not specify a folder, then event files will be written to the folder that contains the Synctool profile. If you do not enable **Write events to file**, then no event file will be saved after running a synchronization. ### Write events summary to a file Enable **Write events summary to file** and specify a folder by clicking Browse. The summary only contains the amount of mutations done, how many were successful and how many failed. **Tip** **Write event summary files in the Synctool folder** It is best practice to store the summaries of events in the same location as the event logs. For example, if the logs are stored at `C:\Program Files\Zivver.Synctool\Logs`, create a folder called **Summary**. This allows saving the summary event logs in `C:\Program Files\Zivver.Synctool\Logs\Summary`. If you enable **Write events summary to file** but do not specify a folder, then event files will be written to the folder that contains the Synctool profile. If you do not enable **Write events summary to file**, then no event file will be saved after running a synchronization. ### Write events to Windows Event Log Enable **Write events to the Windows Events Log** if you already monitor Windows Events in a third party application (e.g. Splunk) and want to monitor Synctool events in your third party application. ## Recent Logs At **Recent Logs** you can find in-depth logs about background Synctool processes. If you run into any synchronization issues, you can find the corresponding logs in this tab. The logs are sorted on six different levels: - Trace - Debug - Warning - Error - Fatal **Tip** **Logs are saved in your Roaming AppData** The Zivver Synctool application logs are stored in `%AppData%\Zivver\SyncTool\Logs`. The file name is called `zivver_synctool_app.log` and this file should not exceed 50 MB in size. If 50 MB is reached for `zivver_synctool_app.log`, then a new log file will be created and the current file will be renamed to `zivver_synctool_app.log.bck`. The `zivver_synctool_app.log.bck` file will be overwritten when `zivver_synctool_app.log` reaches 50 MB in size again. ## Recent Events At **Recent Events** you can see background Synctool processes for the last action executed, such as [manual synchronizations](https://docs.zivver.com/en/admin/synctool-v2/start-synchronization.html), [preview changes](https://docs.zivver.com/en/admin/synctool-v2/syncing.html#preview-changes) or [preview sources](https://docs.zivver.com/en/admin/synctool-v2/sources.html). The items shown in the Recent Events contain information about loading, parsing and sanitizing source data. The Recent Events can help you identify where in a process something could have gone wrong. Updated on 2026-07-03.