Android Debug Bridge (adb) is a powerful command-line tool with many features and capabilities. One of which lets you record live logs of your device.
How to set it up:
- Download and install Android Studio or SDK Platform Tools.
- On your device go to Settings > Emteria Settings and toggle to Enable ADB over Ethernet.
- Make sure your computer is in the same Network as your device.
- On your computer open:
- To establish a connection with your device use:
adb connect <ip>
- To live log in terminal use:
- Pipe the output into a file with:
adb logcat > path/to/log.txt
UART debuggingA serial connection to your device gives you debug information even before ADB is started, so that you can debug the whole boot of your device.
Kernel debuggingAccess the device's shell either via ADB or UART and get diagnostic messages from the kernel:
You can capture the generated bugreport with:
adb pull /data/user_de/0/com.android.shell/files/bugreports
Alternatively, you can create the bugreport using:
For more information, see the Android documentation.
From your Device:
You can upload the current system log directly to our support service via:
Settings > Emteria > Submit bugreport.
The report will be automatically generated and uploaded in the background. Please use this feature immediately after you have discovered a crash or a broken application. Waiting or rebooting the device may overwrite the existing logs.
Note: This is possible starting with version 0.5.7 of emteria.OS.
From your Device Hub:
You can also sumbit a bugreport with an MDM command from your Device Hub. To do so:
- Log into your Device Hub.
- Navigate to Management.
- In the Devices overview select the device for which you want to submit a bugreport.
- Navigate to the Commands tab.
- Click on Add.
- Now the New Command window opens.
- In the Examples tab select Submit new bugreport.
- Click Create.
Android may summarize, filter and rate-limit similar messages if user applications generate excessive amounts of logs.
To change this behavior, persist.logd.filter property can be disabled through the shell, for example, by using ADB:
adb shell setprop persist.logd.filter disable
We have vcgencmd on our RPi images. In closed casings without a heat sink the CPU can become very hot, which leads to CPU throttling and might also cause freezes. You can check the current CPU temperature in the Raspberry Pi Settings or in the device shell using:
When you encountered a bug, please head to our forum to report it. Please be concise in your description but give as much details as needed. A good bugreport consists of the following parts:
- Device / model and connected peripherals
- emteria.OS version
- What steps have you performed
- What outcome did you expect
- What outcome did you actually encounter
- Was there an error message
- Append logs