How can I view or extract CloudStor app logs?

If you experience an error syncing files or folders between your local CloudStor sync location and the CloudStor server, CloudStor’s log might help you find information about the error or provide important details to the AARNet support team for analysis.

The CloudStor desktop app writes log information to file and displays it in-app.

View error information in the CloudStor app

The CloudStor app displays summarised error information. This information can help you decide whether to refer an error to the AARNet support team or try a re-sync.

1. Click Activity in the top navigation menu of the CloudStor app.
2. Click the Not Synced tab in the sub menu.
3. Right click on the issue you want to copy error information for, and click Copy to clipboard.
   
   Resize error columns by clicking and dragging the border between each column heading.
   
   To try syncing the folder again, click Retry sync.

View the complete log file

To extract the full log file – for example, to assist the AARNet support team to diagnose an error:

Windows

1. Ensure the CloudStor app is the focused application (the currently selected window) and press F12 on your keyboard. This will open the Log Output menu.
   
   Enable logging to temporary folder: Leave enabled if you want to see log output.
   Log Http traffic: Will help to diagnose if the error is caused by your network.
   Delete logs older than 4 hours: untick if you are experiencing issues so that the logs are not automatically deleted while you diagnose the problem. Note: leaving this disabled will take up additional space on your hard drive, because the CloudStor app will not be automatically deleting the log files.
2. Click Open folder to open your log’s location on your local machine. By default, this will be C:\Users\<localuser>\AppData\Local\Temp\cloudstor-logdir.
   View or copy the log files as needed.

Mac

These steps may differ depending on the macOS version you are running. 

Contact the AARNet support team with your operating system details and they can assist you in extracting these logs.

macOS version 10.15.5 'Catalina' or later

1. Close the CloudStor app.
2. Open the Terminal application via the Applications Folder (under Utilities).
3. Enter this command:
   /Applications/cloudstor.app/Contents/MacOS/cloudstor --logwindow
   Untick Delete logs older than 4 hours if you need more than four hours of log files to diagnose.
   Note: leaving this disabled will take up additional space on your hard drive, because the CloudStor app will not be automatically deleting log files.
   Leave Enable logging to temporary folder enabled if you want to see log output.
4. Click Open folder to open your log’s location on your local machine.
5. View or copy the log files as needed.

Linux

See the ownCloud Linux app Troubleshooting documentation for instructions on viewing and saving log files from the app.

If you need more help, contact the AARNet support team with your operating system details.