Locating Crash Reports

Mon, Sep 19

If an applications crashs while running on a device, iOS logs the errors and creates a crash report. The report includes specifics about the OS version, date/time, the exception type, a stack trace, among other details.

Below is a partial listing of a report:

Crash Reports in Xcode and Organizer

If you are in the midst of writing an application that has crashed on a development device, you can view crash reports from within Xcode Organizer:

- Open Organizer
- Select the Devices option (on the top of the screen)
- Select the device on menu (left side of the screen)
- Choose Device Logs

Notice the list includes all the apps that have crashed on the device, not only the applications that you’ve written.

Crash Reports and the App store

For applications that a user has installed from the App Store, crash logs will be uploaded to Apple and you can download using iTunes Connect. For example, if you have an application that is available on the App Store and a user has notified you that the app crashed, you can access the crash report:

- Log into the iOS Dev Center
- From the menu in the upper right, choose iTunes Connect
- Select Manage Your Applications
- Click on the application you are interested for which you want to see the reports
- Select the View Details option below if application icon
- Select the Crash Reports link

Crash Reports with Ad Hoc and Enterprise Apps

When a device is synchronized with iTunes, crash reports are copied from the device onto the system running iTunes. To have a user get a copy of the crash report to you, they will need to locate the report(s) from the local system and make the report available to you (email, etc).

The location of the report is dependent on the OS:

Mac OS X: ~/Library/Logs/CrashReporter/MobileDevice/<DEVICE_NAME>

Windows XP: C:\Documents and Settings\<USERNAME>\Application Data\Apple Computer\Logs\CrashReporter\MobileDevice\<DEVICE_NAME>

Windows Vista or 7: C:\Users\<USERNAME>\AppData\Roaming\Apple Computer\Logs\CrashReporter\MobileDevice\<DEVICE_NAME>

<DEVICE_NAME> is the name set for the device (go to Settings – General – About)
<USERNAME> is the name used when logging into the computer.

Crash Report Files

The files of the most help are those that end in .crash files. The crash report’s filename begins with the application name and contains date/time information. In addition, <DEVICE_NAME> will appear at the end of the file name, before the extension.

When locating crash log files, the files are written with the following format:

appName_date_deviceName.crash

For example: iPhoneApp_2011-07-25-094420_MyiPhone.crash

4 comments

Also make sure to keep copies of the dSYM file for each version you ship. That allows you to “symbolicate” the crash log and get references to line numbers and function names.

by Costa Walcott on Sep 19, 2011. Reply #

Thanks for sharing. John. I’m a newbie to App Store. I have some apps on App Store now. When I look into crash logs I just don’t know how to get start, I will appreciate it if you cloud show me some detail about tracking or reproducing the crash.

by Totiz on Sep 20, 2011. Reply #

I get this message in my logs now…
“Not saving crash log because we have reached the limit for logs to store on disk. Sync or otherwise clear logs from….”

The crash reports never get saved now so I lose them. How can I clear the directory on the device of crash logs? Is there a tool for this? I googled and searched in Apple’s developer docs and found nothing useful.

by Felix on Dec 13, 2012. Reply #

I would recommend trying to delete all the logs files from your system which should be in a path similar to /Users/YOURUSERNAME/Library/Logs/CrashReporter/MobileDevice/NAMEOFDEVICE. Then try to sync your device using iTunes. See if that helps.

by John Muchow on Dec 13, 2012. Reply #

Leave a Comment