Skip to content

How to get your device logs

lmarceau edited this page Nov 23, 2022 · 20 revisions

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.

Through Firefox Settings

Access 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 "On my iPhone" > Fennec > Logs. You can see the different logs files here, which you can export using the share menu from Apple.

Access 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.

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