--- title: "Advanced Logging Options" slug: "advanced-logging-options" updated: 2023-11-08T00:46:39Z published: 2023-11-08T00:47:44Z canonical: "docs.retrospect.com/advanced-logging-options" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.retrospect.com/llms.txt > Use this file to discover all available pages before exploring further. # Advanced Logging Options Top Articles Retrospect has a number of built-in tools to help with tracking down problems. Our support team might ask you to send them configuration files, turn on debug logging or increase the log level, edit a retro.ini setting. These instructions walk through how to do both. Do not modify the files unless our support team instructs you to. **Support Diagnostic Tool**: [Download for Mac](https://www.retrospect.com/en/download_mac_support_tool) | Available Soon for Windows **Note** – These instructions apply to Retrospect for Mac 8.0 or higher and Retrospect for Windows 7.7 or higher. - [Configuration File](https://www.retrospect.com/en/support/kb/advanced_logging_options#configs) - [Logging - File](https://www.retrospect.com/en/support/kb/advanced_logging_options#logging-file) - [Logging - Mac Limit](https://www.retrospect.com/en/support/kb/advanced_logging_options#logging-mac-limit) - [Logging - Log Level](https://www.retrospect.com/en/support/kb/advanced_logging_options#logging-log-level) - [Logging - Size Limit](https://www.retrospect.com/en/support/kb/advanced_logging_options#logging-size-limit) - [retro.ini](https://www.retrospect.com/en/support/kb/advanced_logging_options#retro-ini) - [Instant Scan](https://www.retrospect.com/en/support/kb/advanced_logging_options#instant-scan) - [Grooming](https://www.retrospect.com/en/support/kb/advanced_logging_options#grooming) - [Proactive Backup](https://www.retrospect.com/en/support/kb/advanced_logging_options#proactive) ## Configuration File Retrospect keeps all of its information in a configuration file at the following locations: Windows – C:\ProgramData\Retrospect\Config77.dat Mac – /Library/Application Support/Retrospect/Config80.dat These config files are compatible with Retrospect for Mac 8.0 or higher and Retrospect for Windows 7.7 or higher. ## Logging - File Retrospect maintains a global operations log file for all of its activities. If you encounter a problem, be sure to check the log first. The log is available in the application at Reports > Operations Log on Windows and at View > Log on Mac. The file is at the following locations: Windows — C:\ProgramData\Retrospect\operations_log.utx Mac — /Library/Application Support/Retrospect/operations_log.utx In addition, the Retrospect Client logs to a file at the following locations: Windows (pre-Vista) — C:\Documents and Settings\All Users\Application Data\Retrospect Client\retroclient.log Windows (pre-Vista) — C:\Documents and Settings\All Users\Application Data\Retrospect Client\qtsystray.log Windows — C:\ProgramData\Retrospect Client\retroclient.log Windows — C:\ProgramData\Retrospect Client\qtsystray.log Mac — /var/log/retroclient.log Linux — /var/log/retroclient.log # Retrospect 10 for Windows Windows (pre-Vista) — C:\Documents and Settings\All Users\Application Data\Retrospect Client\qtcontrolpanel.log Windows — C:\ProgramData\Retrospect Client\qtcontrolpanel.log ## Logging - Mac Limit On the Mac, the Log window only shows the last 500 lines of the log by default, indicated at the top of the window. For instance, it might say [Showing 500 lines out of 21325]. To change this setting, open Settings > Console and change "Show up to __ lines in the operations log". ![](https://cdn.us.document360.io/6d1fe0c6-ccdb-4ee9-a621-0504cb91b4be/Images/Documentation/advanced-logging-options-image-ru489d57.png) ## Logging - Log Level To increase the logging level or turn on debug logging for the server, open Secret Settings with one of the key combination below. For the client, follow the instructions below. Our support team will give you instructions about what options to change. The changes will be effective immediately; you do not need to restart the application. **Mac** — Command-Option-Comma ![](https://cdn.us.document360.io/6d1fe0c6-ccdb-4ee9-a621-0504cb91b4be/Images/Documentation/advanced-logging-options-image-wxy19tqi.png) **Windows** — CTRL-ALT-P-P ![](https://cdn.us.document360.io/6d1fe0c6-ccdb-4ee9-a621-0504cb91b4be/Images/Documentation/advanced-logging-options-image-mzc45r0l.png) **Mac Client** — Open System Preferences. Hold down the command key and click on "Retrospect Client". Select "Advanced" tab. ![](https://cdn.us.document360.io/6d1fe0c6-ccdb-4ee9-a621-0504cb91b4be/Images/Documentation/advanced-logging-options-image-ebehnkfi.png) **Windows Client** — Hold down the control key for three seconds. The "Advanced" tab will appear. ![](https://cdn.us.document360.io/6d1fe0c6-ccdb-4ee9-a621-0504cb91b4be/Images/Documentation/advanced-logging-options-image-8wfdd4i8.png) ## Logging - Size Limit You can adjust the maximum file size of the log in Preferences. **Mac** — Settings > General ![](https://cdn.us.document360.io/6d1fe0c6-ccdb-4ee9-a621-0504cb91b4be/Images/Documentation/advanced-logging-options-image-bxrxzbrq.png) **Windows** — Configure > Preferences > Notifications > Logging ![](https://cdn.us.document360.io/6d1fe0c6-ccdb-4ee9-a621-0504cb91b4be/Images/Documentation/advanced-logging-options-image-4xl1q8st.png) ## retro.ini Retrospect provides an options file for fine-grained control of the server called retro.ini, at the following location: Windows — C:\ProgramData\Retrospect\retro.ini Mac — /Library/Application Support/Retrospect/retro.ini If you open the file, you will see the following options by default on Mac: [Options] SetUILogging=3 SetFoundationLogging=3 SetAppLogging=3 SetDevicesLogging=3 SetEngineLogging=3 SetVolumesLogging=3 SetBackupSetsLogging=3 SetNetworkingLogging=3 Our support team might ask you to change the log level here instead of through the application. Here are the steps: 1. Turn off the server by either quitting the Windows application or using System Preferences on the Mac. 2. Open retro.ini in Notepad or TextEdit. 3. If our support team suggests turning on "device logging to 6", change SetDevicesLogging=3 to SetDevicesLogging=6. 4. Save the changes to retro.ini. 5. Turn on the server by either launching the Windows application or starting it through System Preferences > Retrospect on Mac. 6. Be sure to change the setting back after you’ve reproduced the issue. ## Instant Scan Instant Scan has a separate set of files for configuration, logging, and options, at the following locations: # Configuration Files Windows — C:\ProgramData\RetroISA\ConfigISA.dat Mac — /Library/Application Support/Retrospect/ConfigISA.dat # Scan Files Windows — C:\ProgramData\RetroISA\RetroISAScans\ Mac — /Library/Application Support/Retrospect/RetroISAScans/ # Log Files Windows — C:\ProgramData\RetroISA\retroISA.utx Mac — /Library/Application Support/Retrospect/retroISA.utx # Option Files Windows — C:\ProgramData\RetroISA\retro_isa.ini Mac — /Library/Application Support/Retrospect/retro_isa.ini ## Grooming For grooming, messages are logged to the Operations Log and Execution Log. However, for detailed debugging information, you can enable a grooming log by creating a file with a specific name next to the catalog file for the set you’re grooming: "Media Set A.rbc.grm.log" if you are grooming "Media Set A". This log is limited to 1GB, and you do not need to shutdown the engine to create it. - On Windows, navigate to the catalog’s folder and right-click to create a text document. Name it Media Set A.rbc.grm.log. - On Mac, open Terminal, navigate to the catalog’s folder, and run touch "Media Set A.rbc.grm.log". ## Proactive Backup For diagnosing issues with proactive backup, you can enable a specific log for this feature to send to our support team. You will need to shutdown the engine before creating it. - On Windows, navigate to the application’s data folder in "C:/ProgramData/Retrospect/" and right-click to create a text document. Name it proactive_backup_log.utx. - On Mac, open Terminal, navigate to the catalog’s folder, and run touch "/Library/Application Support/Retrospect/proactive_backup_log.utx". Last Update: January 13, 2023