Viewing Build Agent Logs
To analyze agent-specific cases, there are internal log files saved by the TeamCity agent process into <TeamCity agent home>/logs
directory on the agent machine.
When the agent is connected to TeamCity server, you can browse and download the agent logs in TeamCity web UI, on the Agent Logs tab for an agent.
If you need to customize the logging, see below.
Log Files
TeamCity uses Log4j 2.x for internal logging of events. The default build agent Log4j configuration file is <agent home>/conf/teamcity-agent-log4j2.xml
.
See the comments in the Log4j configuration file for enabling the DEBUG mode. Build agent logs are placed into <agent home>/logs
directory. Normally, you do not need to restart the agent for the updated logging configuration to be applied.
File name | Description |
---|---|
| General build agent log |
|
|
| VCS-related logging (for checkout mode "Automatically on agent") |
| log of the build agent upgrade (logged by the upgrading process) |
| log of the agent's monitoring/launching process |
| (only present when the agent is run as Windows service or by Java Service Wrapper) output of the process build agent launching process |
Generic Debug Logging
To enable general debug logging on an agent, change the jetbrains.buildServer
category logging priority in the <agent home>/conf/teamcity-agent-log4j2.xml
file:
If you're using TeamCity version < 2022.04 then the following replacement should be done in the <agent home>/conf/teamcity-agent-log4j.xml
file:
Then, see teamcity-agent.log*
files.
VCS Debug Logging
To enable detailed VCS logging on an agent, change the VCS category logging priority in the <agent home>/conf/teamcity-agent-log4j2.xml
file:
If you're using TeamCity version < 2022.04 then the following replacement should be done in the <agent home>/conf/teamcity-agent-log4j.xml
file:
Then, see teamcity-vcs.log*
files.
Specific Debug Logging
To get dump of the data sent from the agent to the server, enable an agent XML-RPC log, by uncommenting the line below in the <agent home>/conf/teamcity-agent-log4j2.xml
file.
If you're using TeamCity version < 2022.04 then the following replacement should be done in the <agent home>/conf/teamcity-agent-log4j.xml
file.
Then, see teamcity-xmlrpc.log
.
Advanced Logging Configuration
You can configure location of the logs by altering the value of the teamcity_logs
property (passed to JVM via -D
option). You can also change the Log4j configuration file location by changing the value of the log4j2.configuration
property. See the corresponding documentation section on how to pass the options.
For additional options on tweaking logging, refer to the TeamCity Server Logs page.