Skip to content

How to get your device logs

Jump to bottom
lmarceau edited this page Dec 15, 2022 · 20 revisions

Device logs

There's different type of logs we can get from our application. If you encounter a crash, you can get your hands on crash reports which are useful to get the stack trace that caused the said crash. This is normally the most useful way to debug a crash. If you have no crashes and experience another type of issue (for example a performance issue) it would be useful to get the Firefox logs which are more generic. Firefox logs can help pinpoint certain issues although without certainty. So if you have a crash you can send both type of logs if you want, but if you have no crash the Firefox logs are the best we can get.

Crash logs

Get crash logs from iOS settings analytics

  • Open the iOS Settings
  • Navigate to Privacy & Security > Analytics & Improvements > Analytics Data
  • Use the search function and tap in the application name (i.e. Firefox)
  • Select the desired log
  • You can share by clicking the share button at the top of the opened log

Get crash logs from Xcode

  • Have your physical phone connected to Xcode.
  • Open the devices and simulator window under XCode menu Window -> Devices and Simulator.
  • Select your device in the side bar list.
  • Click on View Device Logs.
  • Sort by processes to find Firefox related logs.

Firefox logs

Access Firefox logs via Files App on iOS Device

  • Launch Firefox on a real device.
  • Open Settings.
  • Scroll down to Version and tap it several times.
  • Scroll down and hit "Debug: copy log files to app container". This triggers the logs to be saved into the Documents folder.
  • Open the Files App on your iOS device and navigate to "Browse > On my iPhone" > Fennec > Logs. You can see the different logs files here, which you can export using the share menu from Apple.

Access Firefox logs via XCode container method

  • Launch Firefox on a real device.
  • Open Settings.
  • Scroll down to Version and tap it several times.
  • Scroll down and hit "Debug: copy log files to app container". This triggers the logs to be saved into the Documents folder.
  • Connect your device via USB.
  • Open Xcode.
  • Window > Devices. Choose your device.
  • Find "Firefox" on the right side.
  • Click the three dots icon, and choose "Download Container…". Save it somewhere you can find later. This saves a .xcappdata file. Screen Shot 2022-10-24 at 1 57 31 PM
  • Locate the .xcappdata file you just saved and right-click on it to "Show Package Contents".
  • Navigate to AppData/Documents/Logs, you have all the devices logs there.

Firefox logs format

Note that logs are currently separated in three categories:

  • Sync to record what's happening with Sync, Accounts, Providers, Storage, and Profiles
  • Browser to record what's happening in the front-end and the browser
  • Keychain to record interactions with the keychain
Clone this wiki locally