Bug reports can help Magic Leap troubleshoot root causes for issues you may encounter on your device.
Via the Compute pack
Hold down the following three buttons on the Compute Pack at the same time:
- Volume up
- Volume down
- Power button
A prompt will appear. It will include a countdown to the bug report generating, as well as an option to generate it now or cancel the generation.
Once generation is confirmed or automatically happens, you can proceed with using the device.
When the bug report is ready, you'll be prompted again.
This bug report is then stored locally on the device and must be connected to a computer and retrieved using Magic Leap Hub.
Retrieving the Bug Report via Magic Leap Hub
This process is not the same as generating a bug report via Magic Leap Hub. After generating a Bug Report on your device, you'll need to connect the device to Magic Leap Hub and open Device Bridge.
- Go to "Device Bridge > Files"
- On the lefthand "Folders" menu, expand "/" if it's not already expanded, and click on "bugreports"
- Select the bug report you want to retrieve from the presented list of files
- Click the "Download" button on the right-hand panel to download a .zip of the bug report to your Magic Leap 2 downloads directory,
Note: Your device will need developer mode enabled, and the prompt to trust the computer will need to have been accepted as well.
Retrieving the Bug Report via Magic Leap Hub 3
From the Magic Leap Hub 3 device screen, select the "Files" icon on the left-hand side menu. On the following screen, select "Bug Reports". Scroll through the list and look for the .zip file of the bug report you generated, and click the down arrow icon to save the file to your computer.
Via ADB
You can easily create a bug report using Android Debug Bridge (ADB). Please refer to the documentation on our Developer Portal for more information on using ADB.
First confirm your Magic Leap 2 is recognized. In an open ADB shell, while your Magic Leap 2 is on and connected to your computer, enter
adb devices
Your device's serial should be returned by this command. If it is, enter the following to generate a bug report that you can send to Magic Leap for review. This zip file will be created in whatever folder your command line interface is currently in.
adb bugreport filename.zip
Via Magic Leap Hub
Bug reports can also be generated in Magic Leap Hub. With your device connected to your computer and powered-on, open Magic Leap Hub. Note: Your device will need developer mode enabled, and the prompt to trust the computer will need to have been accepted as well.
- Click the device icon in the bottom right-hand corner of ML Hub
- Select the device from the list that appears
- Click the "generate bug report" icon
- You'll be prompted to save a .zip file containing the bug report on your computer
- You'll see a dialog in the lower right-hand corner saying "Creating Bug Report"
- The dialog will disappear once the bug report is created
Via Magic Leap Hub 3
From the device screen, click "Create bug report" on the right hand side under the "Device" section. A bug report will begin generating automatically. A notification appears while the bug report is being generated, and upon completion a prompt will appear at the bottom of the screen allowing you to download the bug report directly from the device screen.
The GIF below shows the process: