Product: OneSync
Audience: ClassLink Administrator
Activity logs record and detail actions for syncs, correlation, workflows, and the complete OneSync system. They include actions, timestamps, sync statuses, and error messages. You can filter these logs by date, status, action type, or specific location and use them to track successes and errors among individual syncs. To access these activity logs, navigate to the Logs tab in the navigation bar and choose the specific log type that you wish to view. You can also click the Activity button next to any individual user, source, or destination to view its specific log.
Note: You can download any log as a CSV. Simply click "Export as CSV" at the top-left of any log page.
Overview
Import Logs
Since imports are executed per source, each source has its own import log. An import log details the number of users imported, warnings, errors, and the total time (in milliseconds) that it took to complete the import. Status cards inform you of the number of users added, updated, disabled, or enabled per import.
Export and Dry Run Logs
Since exports and dry runs are executed per user, each user has its own export log. Export logs are typically filtered per destination, but you can click an individual user's outer log to view more details for that user's export actions. This will include the actions taken to set each individual property in the destination, as well as the total time (in milliseconds) that it took to complete the user's export.
Correlation Logs
Since correlations are executed per destination, each destination has its own correlation log. If you click on a destination's correlation log, you can view the inner logs which record the number of users staged from OneSync and the chosen destination, as well as the number of users matched during that correlation.
System Logs
System logs record every action taken in the OneSync system and organizes them by location, action, date, time, and system user. You can use these logs to track changes to sou rces and destinations.
Logging Level
Logging Level is a setting that can provide more or less detail in the logs based on three levels: Default, Verbose, and Debug. Default level logs contain the least detail, Verbose logs contain an intermediate amount, while Debug logs contains the most detail. Logging level applies to all log types. The default setting is Default. To change the setting, navigate to OS Settings > General Settings. Then click the dropdown to choose your logging level.
Log Retention
We've added a new feature to clean up your log tables. Log retention allows you to specify the number of days to keep your logs, after which the logs will be discarded. This setting can be applied to all log types including import, export, dry run, correlation, system, and workflows.
The default setting for each log type is "Forever".
To modify the settings for your logs:
1. Navigate to the OS Settings -> Log Settings.
2. Locate the desired log type.
3. From the drop-down, select the amount of time that you'd like to retain that log.
4. Click Save Settings.
Updated: June 2019