Use diagnostics to research device issues
You can use sysdiagnose to research general iOS and iPadOS issues before you troubleshoot or report them to your IT department or AppleCare. Sysdiagnose extracts information from iPhone and iPad and captures it in a log file. Your IT team or AppleCare can then read the file to understand software or network issues. You can use sysdiagnose log files to troubleshoot issues when you don’t have access to the iPhone or iPad device.
Set up and run sysdiagnose
Press and hold both volume buttons and the side or top button on iPhone or iPad for 1 to 1.5 seconds, then release them.
A short vibration indicates that sysdiagnose started. A message that says “Diagnostics are in flight, Perform the following” may appear with Send Feedback and Ignore options.
Important: Before running sysdiagnose, try to reproduce the issue on the device. Even if the issue doesn’t consistently occur, document the date and time that sysdiagnose was started, and use it to find the sysdiagnose log file.
Set up and run sysdiagnose using AssistiveTouch
Alternatively, if any buttons on iPhone or iPad aren’t functioning, you can use AssistiveTouch in the Accessibility settings to run sysdiagnose.
In Settings > Accessibility > Touch > AssistiveTouch, turn on AssistiveTouch.
Tap Customize Top Level Menu, and on the Customize Top Level Menu screen, tap the Add button (+) to add an action icon.
Tap the action placeholder icon (+) to add a function.
Tap the action placeholder icon that appeared, tap System, select Analytics from the list, then tap the checkmark.
Analytics is now added to AssistiveTouch, and you can tap the Back button to leave that menu. Reproduce the failure or behavior of the iPhone or iPad you’re trying to troubleshoot.
Tap the AssistiveTouch tool, then tap the Analytics action icon from the Top Level Menu.
Confirm that the message “AssistiveTouch Gathering analytics” appears.
iOS and iPadOS capture sysdiagnose log files and store them in Analytics & Improvements in Settings.
In Settings, tap Privacy & Security > Analytics & Improvements > View Analytics Logs.
Multiple analytics log files appear.
Tap the search bar and type “sys” to begin your search.
Use the date and time you documented to find the sysdiagnose log file.
In Settings > Accessibility > Touch > AssistiveTouch, turn off AssistiveTouch.
Locate and transfer sysdiagnose files on devices
After you run sysdiagnose on iPhone or iPad, you can transfer the log file to a Mac so that you can send it to AppleCare or your organization’s IT team for analysis. You can use AirDrop to transfer the file or connect iPhone or iPad to a Mac and transfer the file using the Finder.
Go to Settings > Privacy & Security > Analytics & Improvements > View Analytics Logs on iPhone or iPad.
Locate the sysdiagnose file and use AirDrop to send it to a Mac. Scroll down to the sysdiagnose file with the corresponding date, tap the file, and tap the box with an arrow in it at the top right.
Choose the Mac to send it to from the list of devices that appear in the AirDrop area. After the transfer is complete (this may take several minutes), the file is located in the
/Users/[user short name]/Downloadsfolder and looks similar tosysdiagnose_YYYY.MM.DD_HH-MM-SS-XX….
Transfer the log file to Mac using the Finder
While the iPhone or iPad is connected to the Mac, click the device below Locations in the Finder sidebar, and click Sync.
Next, you’ll find the sysdiagnose log file in the hidden Library folder on the Mac,
Macintosh HD/Users/[user short name]/Library/. macOS hides the/Users/[username]/Library/folder by default.In the Finder, press and hold the Option key while you click the Go menu. The Library folder appears in the menu.
Click the Library folder, then go to Logs > CrashReporter > MobileDevice > [device name] > DiagnosticLogs > sysdiagnose. The sysdiagnose log file appears.