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 window in the Editor is 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 |
| Windows | C:\Users\username\AppData\Local\Unity\Editor\upm.log |
On macOS, you can also use the Console.app utility to find the log under the ~/Library/Logs/Unity folder.
On Windows, you can find the Editor log file in the local application data folder <LOCALAPPDATA>\Unity\Editor\Editor.log, where CSIDL_LOCAL_APPDATA defines <LOCALAPPDATA>.
To view the Editor log, open a Console Window (menu: Window > General > Console) and select Open Editor Log from the Console window menu.
| Operating system | Log files |
|---|---|
| Linux | ~/.config/unity3d/Editor.log |
| macOS | ~/Library/Logs/Unity/Editor.log |
| Windows | C:\Users\username\AppData\Local\Unity\Editor\Editor.log |
On macOS, you can also use the Console.app utility to find the log under the ~/Library/Logs/Unity folder.
On Windows, you can find the Editor log file in the local application data folder <LOCALAPPDATA>\Unity\Editor\Editor.log, where CSIDL_LOCAL_APPDATA defines <LOCALAPPDATA>.
| Operating system | Log files |
|---|---|
| Linux | ~/.config/unity3d/CompanyName/ProductName/Player.log |
| macOS | ~/Library/Logs/Company Name/Product Name/Player.log |
| Windows | C:\Users\username\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 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 WebGL, 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.