Sometimes your devices act up in the field. Generating useful logs can be your first step to diagnosing the problem.
What is a Bug Report?
A bug report is a log that contains information about an Android device. It can help you fix bugs in your applications. You can find out more about bug reports from Android’s documentation. Esper simplifies the process of collecting bug reports from Android devices.
The Request Bug Report button allows you to capture and upload a bug report from your device.
Once a bug report has been requested, the user will need to manually approve this request. This feature is available in Multi-app and Kiosk Mode.
Requesting a Report
Capture bug reports to diagnose your devices. Bug reports can be enabled through Multi-App Mode or Kiosk Mode for devices that are communicating with Esper. A notification will appear requesting permission before each device can upload the report to the console, so someone will need to be physically close to the device.
Requirements:
- Someone to tap “Share” from the notification pop up on the device.
Don’t want to be physically close to your devices to enable bug reports? If your devices allow Remote Control, you’ll be able to collect a bug report during a Remote Control session. Read over the requirements to see if your devices qualify.
Step 1: To request a bug report, go to Devices & Groups and locate the device. Then go to the Capture Logs tab.
A notification will appear. Accept the notification to continue.
The notification bar allows device users to accept a bug report. Enable this toggle for devices that are in Kiosk Mode, or for any situation where the notification bar is hidden.
Step 2: Click on Request Bug Report. A bug report request will be sent as a notification on the device.
For Foundation devices, go to Step 7.
Step 3: On the device, pull down to access the notification bar.
Step 4: Once the report is ready, the Share and Decline report options will be available in the notification bar.
Step 5: Click the notification to open up the following pop-up to Share the report. Pressing Decline will end the process.
Step 6: Select the Share button to send the report to the Console.
Step 7: Once the report is uploaded to the Console, click Download to download and view the report.
Canceling Bug Reports
Did you select the wrong device for a bug report? You can cancel a bug report from the device's Event Feed. Only bug reports that have a queued status may be canceled.
Go the the Event Feed and click on Cancel.
Requesting a Bug Report
Capture bug reports to diagnose your devices. Bug reports can be enabled through Multi App mode for devices that are communicating with Esper. A notification will appear requesting permission before each device can upload the report to the console, so someone will need to be physically close to the device.
Requirements:
- Devices must be in Multi-App mode with notifications enabled. Apply a Compliance Policy if it is not enabled through the Template.
In the Template, verify that the notification bar and Mutli-App Mode are enabled.
Verify that the Device Mode is set to Multi-App Mode.
- You’ll also need someone to tap “Share” from the notification pop-up on the device. Don’t want to be physically close to your devices to enable bug reports? If your devices allow Remote Control, you’ll be able to collect a bug report during a Remote Control session. Read over the requirements to see if your devices qualify.
Generating a Bug Report of a Device From the Console
Step 1: To generate a report, go to the Capture logs tab and then click on Start.
Step 2: Once a bug report is started, a notification will appear on the device. Tap Share to send the bug report to the Console.
Pressing Decline will end the process.
As the report is gathered, the status will change from Requesting Report to Permission Granted to Download.
Step 3: The Download status is a live link. Clicking on Download will download the bug report with the date and timestamp for the device to help your technical staff debug any issues.
Canceling a Bug Report
You can only cancel Bug Reports that are in the queue state. To cancel a Bug Report, click on the ⓘ (info) button to open the Event Feed.
Then select Cancel.
If the Cancel action is unsuccessful, that means the status has entered a new state and has not yet updated in the Console. Refresh the console to view the new state.