Check build results
Review build results and monitor build performance in Unity Build Automation.
Read time 3 minutesLast updated 9 months ago
Build Automation provides detailed information about each build's status, metrics, and progress. This helps you monitor build performance, troubleshoot issues, and track running builds.
View build results
To access detailed information on all build attempts in the Unity Dashboard, navigate to DevOps > Build Automation > Build history. The build history table displays a list of all your build attempts along with their statuses, build targets, platforms, build times, and completion times.Build Status
Build Automation marks each with a status icon to indicate its result:
Build succeededThe build has successfully completed
Build failedThe build has failed
Build canceledThe build was canceled
Build is queuedA build might queue if a builder isn't currently available to be assigned to the build attempt, or if you have reached your concurrency limit. If you've reached the concurrency limit, a warning message appears at the top of the page notify you.
Build is sent to a builderThe build process hasn't started yet because the builder is being provisioned or the environment
Build is in progressYou can monitor the progress running builds until completion.
Detailed build information
You can view more detailed information on specific builds, including those in progress. Select the arrow next to the build entry in the Build History table to display the detailed information panel and expand metrics for the selected build, including:Metric | Description |
|---|---|
| Build Result | The current status, whether in progress, succeeded, failed, or canceled. |
| Start and Finish Times | The start time is displayed for in-progress builds. The finish time appears for completed builds. |
| Build Time | The total time taken or elapsed for the build. |
| Wait Time | The time spent in the queue before the build started. |
| Checkout Time | The time taken to check out the repository. |
| Billable Build Time | The time counted toward billing once the build begins. |
| Workspace Size | The amount of storage space used during the build. |
Download build artifacts
To access and download the build artifacts for successful builds:- In the Build History table, locate the build entry for which you need artifacts.
- On the right side of the build entry, click the three dots to open the options menu.
- Select Download .ZIP file from the dropdown menu to download the build artifacts as a compressed file.
Unity Build Automation - Download Build Artifacts
Share build artifacts externally
You can share build artifacts with individuals who don't have an account associated with your project. Build Automation can automatically generate shareable links, allowing you to send builds via email or through integrations like Slack. Additionally, you can generate these links manually from the dropdown menu of a given build. To share a build:- Locate the build entry in the Build History table.
- Select the three dots on the right side of the entry to open the shortcut menu.
- Select Share Link from the dropdown menu to generate a shareable link.
Unity Build Automation - Share Build Artifacts Externally
Additional operations
After reviewing your build results, you can perform several operations directly from the build history table to manage and interact with your builds. Access these options in the Unity Dashboard:- Locate the build entry in the Build History table.
- Select the three dots on the right side of the entry to open the shortcut menu to view a complete list of additional operations.
The context menu for the build history table that displays the options listed in the following table.
Operation | Description |
|---|---|
| Replay build | Rerun the build with the same configurations. This is useful when you want to verify if an issue was temporary or if you need to generate a new build without changing any parameters. |
| Edit build target | Modify the build target configuration settings. |
| Add label | Attach a custom label to the build. Labels help you categorize builds and quickly find specific versions in your build history. |
| Play (WebGL Only) | Launch and test a WebGL build directly in your browser. This option allows for immediate testing without downloading the build. |
| Delete | Remove the build from your build history. This action permanently deletes the build artifacts and can't be undone. Use this option remove old or unnecessary builds. |
View Logs
If a build encounters issues that result in build failures, you can view logs to diagnose the problem:- In the Build History table, locate the build entry.
- Select Logs on the right side of the entry to open the log file.
- Review the logs to identify any errors or warnings that may have caused the build failure.