This article provides instructions on how to collect the debug logs on your iOS or Android mobile device. When reporting issues you encounter on Nx Mobile, providing a client log can help the Nx support team investigate and resolve your request.

The most common issues that can be investigated are

• cloud connectivity issues (requires the server debug log and cloud system ID), and
• crashes.

Collect the Nx Mobile Debug Log

This is an easy method for collecting and sharing the Nx Mobile client log with the Nx support team. 
This method requires the mobile phone to have access to Nx Cloud.

1. Launch the Nx Mobile app.
2. Go to Main Menu, tap and hold the build number for 10 seconds.
   
3. Click the Change Log button, then select DEBUG1 or DEBUG2 (according to the instructions the Nx support team provided you).
   
4. Set the log collection interval and click Upload logs next button.
   
5. The log ID will be copied to the clipboard automatically. Please share this log ID with the Nx support team.
   
6. Try to reproduce the issue you experienced. The log will be sent and collected on our cloud system automatically.

Collect the Nx Mobile Debug Log with Device System Log

For Android 

Before collecting debug logs, make sure the Nx Mobile app is allowed to access the internal storage of the Android device. Since these settings vary per manufacturer, please check the instructions for your specific device to discover how to enable the permission per app and enable it for Nx Mobile. Usually, the option can be found under Settings > Permission.

Instructions:

1. Prepare a computer for log collecting and download the Android SDK Platform Tool.
2. Extract the ZIP file to an easily accessible directory (e.g., C:\platform-tools_r31.0.2-windows\platform-tools).
3. Enable Developer options and USB debugging on your Android device (e.g., phone, tablet, etc.) by following the instructions here.
4. Connect the Android device to your computer via a USB cable. For other platforms, additional applications or dependencies are required (see the instructions for macOS and Ubuntu). You may need to unlock your device to grant access to the computer.
5. Open the Command Prompt and change the path to the Android SDK directory where you extracted the ZIP archive in step 2.
   

6. To check if your Android device is detected by the SDK tool successfully, type the following command:

   adb devices
    

   If everything was set up properly, you will see the device name and its serial number.
   
   
   Note: If you see the “Unauthorized” name come up with the device serial number, please unlock your Android phone to authenticate and grant access to the computer.

7. To start the log collector, run the following command:

   adb logcat -c && adb logcat > mobile_client.log

   

8. Close Nx Mobile on the Android device.
9. Launch Nx Mobile and take note of the time. Long press the Nx Mobile version number for 10 seconds and the Developer Settings will appear. Confirm that Nx Mobile was started with VERBOSE log level enabled.
10. If there is an issue during the stream playback, connect to the Nx Witness system and view the camera’s stream. If you experience a cloud connectivity issue, please wait for at least one minute after the “unreachable” flag appears on the cloud system. Repeat the scenario several times and make sure the issue can be reproduced.
11. Close Nx Mobile and take note of the time.
12. Press Ctrl + C in the Command Prompt on the computer to stop the log collector.
13. Go to the Android SDK tool folder. Copy the mobile_client.log (located in the same folder as the Android SDK tool) and share it with the Nx support team for further investigation.
    

For iOS

A. Change the Log Level for Nx Mobile

1. Open the Nx Mobile app and disconnect from any connected Nx Witness system.
2. Long press the Nx Mobile version number for 10 seconds and the Developer Settings will appear. Change the log level to DEBUG2 (verbose).

B. Collect the log file generated by Nx Mobile

Windows

1. Close the Nx Mobile app.
2. Download and install a 3rd party tool for Windows PC to grab the iOS device log (e.g. we use 3uTools as an example).
3. Connect the iPhone or iPad on which Nx Mobile is installed to the Windows PC via a USB cable, and be sure the iOS device is unlocked, and the computer is trusted. 
4. Open the 3uTools application and click Toolbox > Realtime Log to get the Console logs.
5. Launch Nx Mobile and take note of the time. Long press the version number for 10 seconds and the Developer Settings will appear. Confirm Nx Mobile was started with verbose log level enabled.
6. If there is an issue during the stream playback, connect to the Nx Witness system and view the stream from the camera. If it’s the cloud connectivity issue, please wait for at least one more minute when you see the “unreachable” flag on the cloud system. Repeat the scenario several times and make sure the issue has been reproduced.
7. Close the Mobile client App and record the time the Mobile client was stopped at.
8. On your PC, check the timestamps listed in the log and make sure the log has covered the desired amount of time. If not, clean the log entries and repeat steps 5-7.
9. Copy all the console logs and share them with the Nx support team for further investigation.

MacOS

1. Close the Nx Mobile app.
2. Connect the iPhone or iPad on which Nx Mobile is installed to a Mac via a USB cable, and be sure the iOS device is unlocked, and the computer is trusted. 
3. Open the Console app on macOS, which could be found in the /Applications/Utilities/ directory.
4. From the Console app sidebar, look under the Devices section and select the iPhone or iPad that is connected to the Mac.
5. Console Log data will begin showing up immediately for the connected iOS device.
6. Launch Nx Mobile and take note of the time. Long press the version number for 10 seconds and the Developer Settings will appear. Confirm Nx Mobile was started with verbose log level enabled. 
7. If there is an issue during the stream playback, connect to the Nx Witness system and view the stream from the camera. If it is the cloud connectivity issue, please wait for at least one more minute when you see the “unreachable” flag on the cloud system. Repeat the scenario several times and make sure the issue has been reproduced.
8. Close the Mobile client App and record the time the Mobile client was stopped at.
9. On your PC, check the timestamps listed in the log and make sure the log has covered the desired amount of time. If not, clean the log entries and repeat steps 6-8.
10. Copy all the console logs and share them with the Nx support team for further investigation.