One of Remote Buddy's diagnostic features is debug logging. If you turn on debug logging, Remote Buddy writes events and diagnostic information into a log file, which you can then follow live in the Terminal or send to us. Here's how.
Turning on Debug Logging
Open Diagnostics
Either click on Remote Buddy's icon in the menu bar or right-click on Remote Buddy's icon in the dock, then select Diagnostics… from the menu that opens.
Navigate to the logging options
In the Diagnostics window, click the Tools button on the right side of the window's titlebar.
Then, in the window, click on Diagnostic Export.
Turn on debug logging
Finally, in the window, under Log settings, turn on Debug logging. Remote Buddy now writes a log file at ~/Library/Application Support/Remote Buddy/Logs/com.iospirit.RemoteBuddy.log.
Live view of the log
If you have turned on Debug Logging, you can follow it live by opening Terminal.app and entering the following line:
tail -f ~/Library/Application\ Support/Remote\ Buddy/Logs/com.iospirit.RemoteBuddy.log
If you want to see just the button presses, you can chain this command with grep to show only log entries containing the term event button:
tail -f ~/Library/Application\ Support/Remote\ Buddy/Logs/com.iospirit.RemoteBuddy.log | grep "event button"
In both cases, once you're done viewing the log file, press Ctrl + C in the Terminal window to end the command.
Diagnostic Export
Sometimes, we will need more than a textual description of a problem to help you or locate and fix a bug you've reported. In that case, we may ask you for a Diagnostic Export, which you can collect as follows:
Turn on Debug Logging
Please follow the steps for Turn on Debug Logging at the beginning of this article to turn on Debug Logging.
Reproduce the issue
Reproduce the issue while Debug Logging is turned on - or follow the steps we asked you to perform to learn more about the problem.
Navigate to Diagnostic Export
Use the steps from Turn on Debug Logging to return to the Diagnostic Export interface (Remote Buddy menu > Diagnostics… > Tools > Diagnostic Export).
Select the information to export
In the Diagnostic Export interface, you can now select which files you want to include in the diagnostic export. The files selected by default capture Remote Buddy's internal state and the log output it generated. Where needed, you can easily include additional information like a dump of the macOS IOKit driver registry - or your Remote Buddy settings.
Performing Export
To perform export, scroll down to the end of the Diagnostic Export UI and click on Export Diagnostic Files. Remote Buddy will then put the selected information together, create a ZIP file out of it and reveal that file to you in the Finder.
From there, you can drag and drop the Diagnostic Export ZIP file into f.ex. a mail.