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
- Export and Dry Run Logs
- Export Log Actions
- Correlation Logs
- System Logs
- Logging Level
- Log Retention
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.
Export Log Actions
A handy feature for Export and Dry Run logs is the ability to launch an export to a user directly from a specific log. Also there are two tabs in the Export logs and Dry Run logs windows. The first tab is the User Details tab, which includes all of the exported user’s info. The second new tab is the Export History tab or Export History (Dry) tab. Here, all of the Exports/Dry run logs can be viewed and filtered through for your convenience.
To view and use these features, navigate to Export Logs or Dry Run Logs and from there choose a user you want to view and there will be two buttons at the bottom right. There is also two tabs on the top of the slide over: User Details and Export History.
User Details will show a preview of the fields mapped during the export:
Export History will show the export history of only the selected user for all destinations this user has been exported to:
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 -> Log Settings. Then select the logging level desired: Default (Blue), Verbose (Yellow), Debug (Red).
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: Nov 2019