Logs of Internal Events

Added by Kirill Maximov, last edited by Yegor Yarko on May 26, 2008  (view change)
Documentation Index

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:

-Dlog4j.configuration=file:../conf/teamcity-server-log4j.xml -Dteamcity_logs=../logs/

Labels