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.
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 |
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 |
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.
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.
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.
| 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. |
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.
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.