TeamCity 2020.1 Help

Build Log

A build log is an enhanced console output of a build. It is represented by a structured list of the events which took place during the build. Generally, it includes entries on TeamCity-performed actions and the output of the processes launched during the build. TeamCity captures the processes output and stores it in an internal format that allows for hierarchical display.

Viewing Build Log

The log of a specific build is available for browsing on the Build Results page.

The Tree view is the most capable view provided in the web UI. By default, all messages are displayed. Using the View drop-down menu, you can switch from all messages to viewing errors separately, or you can choose Important messages to see the log filtered by "error" and "warning" statuses. You can also use the "Verbose" view level and download a raw build log using the corresponding link.

Since TeamCity 10.0, it is possible to enable the dark theme in the build log by selecting the Use console view checkbox.

You can download a full build log in the textual form or as a .zip archive from the Build Results page by clicking the Download full build log link at the top right corner. Alternatively, you can use the following URL: http://teamcity:8111/httpAuth/downloadBuildLog.html?buildId=<id>. It is also possible to download the build log as a .zip file using the corresponding link in the UI or via the following URL: http://teamcity:8111/httpAuth/downloadBuildLog.html?buildId=&archived=true.

Build Log Size

It is recommend to keep the build log small and tune build scripts not to print too much into the output. Large build logs are hard to view in the browser and are loading TeamCity infrastructure piping build messages from the agent to the server while the build is running.

It is recommended to print into the output only the messages required to understand the build progress and build failures. The rest of the information should be streamed into a log file and the file should be published as a build artifact. A "good" build log size is megabytes at most.

Partial Build Log Display

Since TeamCity 2017.1, when opening large build logs, TeamCity displays a part of it to avoid browser hanging. You can view the full build log on clicking the corresponding link.

The display threshold is set to 7M characters by default and can be adjusted using the teamcity.buildLog.sizeThreshold.chars internal property (not applicable to running build logs and logs links with states (for example, direct links to messages).

ANSI-style Coloring in Build Log

TeamCity build logs render clickable hyperlinks and support ANSI-style escape color codes by default: if your tool produces a colored console output, you will see in the build log in TeamCity. See the related feature request for the full list of supported sequences.

To disable the coloring, set the teamcity.buildLog.ansiColoring.enabled=false internal property.

Last modified: 20 November 2020