Tips for finding Knowledge Articles

  • - Enter just a few key words related to your question or problem
  • - Add Key words to refine your search as necessary
  • - Do not use punctuation
  • - Search is not case sensitive
  • - Avoid non-descriptive filler words like "how", "the", "what", etc.
  • - If you do not find what you are looking for the first time,reduce the number of key words you enter and try searching again.
  • - Minimum supported Internet Explorer version is IE9
Home  >
article

KB-4992: How to collect console logs for iOS devices

Centrify Identity Service, App Edition ,  

7 February,17 at 12:01 AM

Applies to: Centrify Identity Service (All Editions)



Question:

Centrify Support has requested console logs from an iOS device to be used for troubleshooting a range of issues from group policies not applying to authentication failures. 

How are these logs retrieved?



Answer:

iOS devices need to be connected to a Mac or PC computer via a USB sync cable in order to collect device-level log data. Logs need to be collected QUICKLY after a reproduction as iOS devices only store around 15 minutes of device log entries at a time (depending on device activity). 


Device Setup:

Before gathering console logs for the device, you will need to change some settings in the Centrify mobile application:
  1. Open the Centrify mobile application on the iOS device
  2. Click the Settings button.

    User-added image
     
  3. Under the Log Settings section, choose the Log Level and change it to Debug and click the button to enable "Log to Console".

    User-added image
     


Log Collection:

There are several software options for collecting device logs from iOS devices from Mac or PC computers. The below sections describe a few available methods.

For Mac Computers:
  1. LemonJar iOS Console app (Recommended)
  2. Xcode 6 (for iOS 8 and above)

1. LemonJar iOS Console
  1. On a Mac system with OS X 10.9.2 or higher, download the iOS Console app:
  2. Install and open the app
    • Note: At first only the app icon will appear in the Dock, no window will be shown.
  3. Connect the iOS device to the Mac and the logging window will now appear.
    • User-added image
  4. Reproduce the issue, the iOS Console should start populating with related entries.
  5. Once the issue is fully captured, save the log:
    • User-added image
  6. Send the log file into Centrify Support for analysis.


2. Collecting console logs using Xcode 6 (for iOS 8 and above):
  1. Download and install Xcode 6.
  2. ​Connect your iOS 8 device to your computer.
  3. Open Xcode 6 and go to Window > Devices.
  4. Select your device from the Devices column.

    User-added image
     
  5. Select the device console icon ( User-added image ) at the bottom of the window. 
  6. Clear the console logs by pressing the trash icon ( User-added image ) at the bottom right side of the window.
  7. Reproduce the issue on the device.
  8. After the error occurs, go to Xcode 6 and use the save button ( User-added image ) to save the log.
  9. Send the log file to Centrify Support as a .txt 




For PC Computers: Note: Source(s): http://support.blackberry.com/kb/articleDetail?articleNumber=000036986
 
  1. On a PC system with iTunes installed (required), download iOSLogInfo:
  2. Unzip the iOSLogInfo folder to a local hard drive. (example: C:\iOSLogInfo)
  3. Connect the iOS device to an available USB port using the device’s sync cable
  4. Open a command prompt session – be sure to select “Run as Administrator
                  User-added image

       5. From the command window, navigate to the folder where you extracted the files using the following command. (example: cd c:\iosloginfo)
       6. Enter the following command to start a console session and write an output file named consolelogs.txt

             sdsiosloginfo.exe -d > c:\iosloginfo\consolelogs.txt

                 User-added image

       7. To stop the capture session, press CTRL+C
       8. Navigate to the folder where you created the log and send the consolelogs.txt file to Centrify Support.

                  User-added image


Additional Commands available:
  • Capture console logs:
sdsiosloginfo.exe -d > C:\iOSLogInfo\consolelogs.log
  • Capture Crash logs: 
sdsioscrashlog.exe -e -k C:\iOSLogInfo\crash_logs
  • Pull Disk Usage:
sdsdeviceinfo.exe -q com.apple.disk_usage -x > C:\iOSLogInfo\iOS_Disk_Usage.xml
  • Pull Device Stats:
sdsdeviceinfo.exe -x > C:\iOSLogInfo\iOS_Device_Stats.xml
  • Pull iTunes logs:
sdsioscrashlog.exe -e -k C:\iOSLogInfo\itunes_logs



Note: This information is provided as a convenience only and does not represent support offered by Centrify. Any links to third-party software available on this website are provided “as is” without warranty of any kind, either expressed or implied and such software is to be used at your own risk.


For additional information not covered in this troubleshooting guide, please review Centrify Online Help or visit the Customer Support Portal at https://www.centrify.com/support

Still have questions? Click here to log a technical support case, or collaborate with your peers in Centrify's Online Community.