Version: 2021.1
Analyzing profiler traces
Understanding optimization in Unity

Log Files

There might be times during development when you need to get information from the logs of the standalone player you’ve built, the target device, the Package Manager or the Editor. The log files are useful when you have experienced a problem, to find out exactly where the problem occurred.

All messages, warnings, and errors written to the Console windowA Unity Editor window that shows errors, warnings and other messages generated by Unity, or your own scripts. More info
See in Glossary
in the Editor are also written to these log files. You can write your own messages to the Console and log files using the Debug class.

On macOS, you can access the Player, Package Manager, and Editor logs through the Console.app utility.

On Windows, the Package Manager and Editor logs are placed in folders which are not shown in the Windows Explorer by default. See below for more information on where to find the logs.

Package Manager

To view the Package Manager log, navigate to the Unity log folder:

Operating system Log files
Linux ~/.config/unity3d/upm.log
macOS ~/Library/Logs/Unity/upm.log
You can also use the Console.app utility from your /Applications/Utilities folder to find the log file.
Windows (user account) %LOCALAPPDATA%\Unity\Editor\upm.log
Windows (system user account) %ALLUSERSPROFILE%\Unity\Editor\upm.log

Editor

To view the Editor log, open a Console Window (menu: Window > General > Console) and select Open Editor Log from the Console window menu. You can also navigate to the following folder:

Operating system Log files
Linux ~/.config/unity3d/Editor.log
macOS ~/Library/Logs/Unity/Editor.log
You can also use the Console.app utility from your /Applications/Utilities folder to find the log file.
Windows %LOCALAPPDATA%\Unity\Editor\Editor.log

Player

To view the Player log, open a Console Window (menu: Window > General > Console) and select Open Player Log from the Console window menu. You can also navigate to the following folder:

Operating system Log files
Linux ~/.config/unity3d/CompanyName/ProductName/Player.log
macOS ~/Library/Logs/Company Name/Product Name/Player.log
You can also use the Console.app utility from your /Applications/Utilities folder to find the log file.
Windows %USERPROFILE%\AppData\LocalLow\CompanyName\ProductName\Player.log

On Windows and Linux standalones, you can change the location of the log file, or stop Unity from logging to it. For more information, see the Command line arguments documentation.

iOS

Access the device log in XCode via the GDB console or the Organizer Console. The latter is useful for getting crashlogs when your application is not running through the XCode debugger.

See the documentation on Troubleshooting and Reporting crash bugs for information about debugging crashes and issues.

Android

Use the logcat console to access your device log. To use it, launch the adb application in the Android SDK/platform-tools directory with the logcat parameter:

$ adb logcat

You can also get Android Logcat package via Package Manager, which provides UI(User Interface) Allows a user to interact with your application. Unity currently supports three UI systems. More info
See in Glossary
interface for getting logs from Android.

Universal Windows Platform

Device Log files
Desktop %USERPROFILE%\AppData\Local\Packages<productname>\TempState\UnityPlayer.log
Windows Phone You can retrieve your Windows Phone log with Windows Phone Power Tools. The Windows Phone IsoStoreSpy also provides a number of helpful debugging tools.

WebGL

For WebGLA JavaScript API that renders 2D and 3D graphics in a web browser. The Unity WebGL build option allows Unity to publish content as JavaScript programs which use HTML5 technologies and the WebGL rendering API to run Unity content in a web browser. More info
See in Glossary
, Unity writes the log output to your browser’s JavaScript console.

Accessing log files on Windows

On Windows Vista and Windows 7, to make the AppData folder visible in Windows Explorer go to Tools > Folder Options > View (tab). The Tools menu is hidden by default. Press the Alt key once to display it.

On Windows 10, to make the AppData folder visible in Windows Explorer go to View > Show/hide and enable the Hidden items option.

On Windows, no standard out stream exists by default, so you must launch the Editor with a valid configured stdout stream, like as a child process from a CI system. If you specify - to send output to stdout you won’t see the output in the console window.


  • Tizen support discontinued in 2017.3 NewIn20173
Analyzing profiler traces
Understanding optimization in Unity