This page describes how you can retrieve logs to troubleshoot your app and request help.
Troubleshoot the runtime
The OculusLogGatherer.exe tool is included with the app installation and can be used when you have issues with the runtime.
Note: You must have local administrative privileges to run this tool.
To run the tool, navigate to the installation folder, and find the Support -> oculus-diagnostics folder.
For example:
C:\Program Files (x86)\Oculus\Support\oculus-diagnostics\OculusLogGatherer.exe.
When you run the tool, you can select the following options:
Use last to indicate how much log data you want to export. The default log period is 24 hours.
Full logs checkbox to export all available logs
Auto submit checkbox to automatically submit the logs to Meta
The export, a .zip file, will be copied to the clipboard and saved to your desktop. The .zip export organizes the files by log type.
Troubleshoot Unity Editor issues
If you’re having issues with the Unity Editor, please review Unity’s How to Report Bugs page for information about reporting bugs to Unity.
The Issue Tracker has information about known issues, check to see if what you are experiencing has already been reported. If the issue is not already known, you can report the bug in the Unity Editor (Help->Report).
Troubleshoot a Meta XR SDK integration
Using Log Files
If your issue exists with the Unity software integration, please review the Unity Log Files page for information on how to retrieve the logs.
The log file for your unity project can be retrieved by using the command %LOCALAPPDATA%\Unity\Editor\Editor.log.
If you experience a crash, retrieve the log and search for “tombstone”, which is written and logged after the crash. If you scroll up from there, there will be a call stack that describes the processes that were occurring at the time of the crash.
Using Crash/Dump Files
When Unity or an app encounters a failed state, press ctr-alt-delete (windows only), right click on the failed process, and select “create dump file” from the menu. The dump file’s location will be displayed to you upon successful creation.
Troubleshoot Unreal Editor issues
If you’re having issues with the Unreal Editor, review Unreal’s How to Report Bugs page for information about reporting bugs to Unreal.
The Unreal Engine Issues Tracker has information about known issues, check to see if what you are experiencing has already been reported. If the issue is not already known, please make a new report in the tracker.
Troubleshoot an Unreal integration
Use Log Files
If your issue exists with the Unreal software integration, please review the Unreal Log Files page for information on how to retrieve the logs.
The Unreal Editor can pull log files specific to the area where you’re encountering issues. You can generate Editor Session Logs, Game Logs, Build/Cook Logs, Crash Logs, and Compile Logs.
When diagnosing specific issues it is helpful to have Editor Session Logs and Crash Logs to send to Meta when requesting support.
The editor session log file for your Unreal project is located at Engine\Saved\Logs\UE4.log.
The crash logs file for your Unreal project can be retrieved using the command: %USERPROFILE%\AppData\Local\Microsoft\Windows.
Use Crash/Dump Files
If you experience a crash, retrieve the log and search for “tombstone”, which is written and logged after the crash. If you scroll up from there, there will be a call stack that lists the process that were occurring at the time of the crash.
The crash dump is automatically generated by Unreal in the event of a crash in your project. You can find the file titled minidump.dmp in your C:\Users\UserName\AppData\WER\ReportQueue folder.
Get support
If you’re unable to diagnose the issue yourself using the information you retrieved, there are two ways to request help.
Discussion Forums - Ask questions, review answers, and connect with a community of developers. Our team monitors the Forum and will provide support when needed.
Contact Meta - Use the form to send us a message describing the issue you’re having and indicate that you have a log or file that you would like to submit to Oculus for review.
Contact the Meta Horizon Store team
If you have tried other options, and need to talk to the Meta Horizon Store team, use the Get Developer Support form.