TeamCity 9.0 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 at 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, you can view errors separately, or 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.

You can download a full build log in the textual form from the Build Results page by clicking Download log. Alternatively, you can use the following URL: http://teamcity:8111/httpAuth/downloadBuildLog.html?buildId=. 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.

ANSI-style Coloring in Build Log

Since TeamCity 9.1, 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 April 2023