Skip to main content

Unhandled Exception Logging

Embrace automatically logs all unhandled exceptions thrown by your application, including the exception message and managed stack trace when available.


Embrace uses Unity's Application.logMessageReceived event to capture unhandled exceptions. If the logger is disabled (Debug.unityLogger.logEnabled = false), Embrace will not automatically log any exceptions. It is recommended to leave the logger enabled in release builds. If desired, lower severity logs can be disabled using Debug.unityLogger.filterLogType = LogType.Exception.

Multi-Threaded Exceptions

By default, only exceptions thrown on the main Unity thread are logged. To capture exceptions on background threads as well, enable the Capture Multi-Threaded Log Exceptions in the Embrace settings window (Tools > Embrace > Settings > General).

Managed Stack Traces

Each exception log can include a managed stack trace provided by the Unity runtime. To ensure that stack traces are available, confirm that the Stack Trace level for exceptions in your project's player settings is set to ScriptOnly or Full for each platform (Edit > Project Settings > Player > Other Settings > Stack Trace).