A sysdiagnose file is a full archive of system unified logs that Addigy Support may request when troubleshooting issues on iOS or iPadOS devices. Once generated, the file can be transferred to a Mac via AirDrop or USB for further analysis.
There are two ways to generate a sysdiagnose on an iOS or iPadOS device — using the physical buttons or using AssistiveTouch. Use whichever method is available on the device.
Method 1: AssistiveTouch (Recommended)
Use this method when physical button access is not available or practical.
- On the device, navigate to Settings > Accessibility > Touch > AssistiveTouch.
-
Enable AssistiveTouch, then tap Customize Top Level Menu.
- Tap the option to add a new function.
-
Select Analytics from the list and tap Done.
- Close Settings.
- Reproduce the issue or behavior you are trying to troubleshoot.
-
Tap the AssistiveTouch button and select Analytics from the menu.
-
The sysdiagnose will begin generating. A banner at the top of the screen will confirm when it starts ("Gathering analytics.") and when it finishes ("Successfully completed gathering analytics.").
Start:
Finish:The file should look like this when completed:
Method 2: Hard Button Combination
Use this method when you have physical access to the device.
- Press and hold both volume buttons and the side or top button simultaneously for 1 to 1.5 seconds.
- Release the buttons. The sysdiagnose will begin generating and the device will take a screenshot to confirm it started.
Note: On iPhone, you will feel a short vibration when the sysdiagnose starts. This does not occur on iPad. For more details, see the Apple documentation.
Finding the Sysdiagnose File
The sysdiagnose can take up to 10 minutes to finish generating. Once complete, locate the file at:
Settings > Privacy & Security > Analytics & Improvements > Analytics Data
This list contains all analytics data on the device. Search for "sysdiagnose" to filter the results, and use the timestamp on the file to confirm you have the most recently generated one. From here, you can save the file to local device storage and transfer it to a Mac via AirDrop or USB.