Logging the Internal Events
TeamCity uses Log4J for internal logging of events. The following logging rules are used:
Build agent logs
Build agent Log4J configuration file is <agent home>/conf/teamcity-agent-log4j.xml
Build agent logs are placed to <agent home>/logs directory.
General build agent log is named teamcity-agent.log
When build agent is installed using Java Service Wrapper (as windows service), it logs its output and error output to <agent home directory>/logs/wrapper.log .
To configure location of the logs, you have to alter value of teamcity_logs property (passed to JVM via -D option).
To change Log4J configuration file location, you have to change value of log4j.configuration property.
Such changes should be made in:
- <agent home directory>/launcher/conf/wrapper.conf file if build agent is installed as service
- <agent home directory>/bin/agent.(sh|bat) if the agent is run from the command line
TeamCity server logs
TeamCity server Log4J configuration file is <TeamCity home>/conf/teamcity-server-log4j.xml
TeamCity server logs are placed to <TeamCity home>/logs directory and prefixed with teamcity- prefix.
General TeamCity server log is named teamcity-server.log, there are also teamcity-activities.log and teamcity-vcs.log.
To configure location of the logs, you have to alter value of teamcity_logs property (passed to JVM via -D option).
To change Log4J configuration file location, you have to change value of log4j.configuration property.
Such changes should be made:
- in files <TeamCity home>/bin/runAll.(bat|sh) if server is run from the command line (or in catalina.(bat|sh)
- Using tomcat6w.exe, if TeamCity is installed as Windows service
- If you used the WAR-distribution to install TeamCity, by default you should be able to find teamcity.log file in the <J2EEContainer>/logs directory. You may add log4j.configuration property to specify Log4J configuration for TeamCity.
Example of server log configuration properties:
