我的书签
添加书签
移除书签Logging
Introduction
You can turn on additional logging to diagnose and troubleshoot issues with the GoCD server and agent.
Log location
To change where the GoCD server logs or GoCD agent logs are stored, use the system properties gocd.server.log.dir and gocd.agent.log.dir respectively. Refer to the system properties documentation to find out how to set the system property on the gocd server or agent.
Note: The system property deals with configuring the log location for the GoCD server or agent related logs and not the plugin logs.
GoCD Server
To turn on additional logging on the GoCD server, you must:
* create/edit the file CONFIG_DIR/logback-include.xml. The config directory is typically /etc/go on Linux and C:\Program Files\Go Server\config on Windows. See the section Log configuration syntax for the log configuration syntax.
The table below describes the various loggers that can be configured with the server:
Logger| Additivity| Description
---|---|---
com.thoughtworks.go.server.Rails| true| This will enable debugging the rails application server.
com.thoughtworks.studios.shine| true| This will enable debugging of GoCD’s test report analysis that is shown on the “Tests” tab of the stage details page on the server.
org.springframework| true| This will enable debugging of the spring framework.
org.apache.velocity| true| This will enable debugging of some of the server view templates.
org.eclipse.jetty.server.RequestLog| false| This will enable http request logging to help diagnose and identify slow page render times.
PerformanceLogger| false| This will output performance debug logs for 3 key background jobs: scheduling, material updates, work assignment. It is recommended that you send these logs to a different file using an appender.
com.microsoft.tfs.core| true| This will turn on debugging for the underlying Microsoft Team Foundation Server library used by GoCD.
com.thoughtworks.go.tfssdk14| true| This will turn on debugging for the GoCD wrapper around Microsoft TFS library.
com.thoughtworks.go.domain.materials.dependency| true| Turn on logging for materials of type dependency.
com.thoughtworks.go.domain.materials.git| true| Turn on logging for materials of type git.
com.thoughtworks.go.domain.materials.mercurial| true| Turn on logging for materials of type mercurial.
com.thoughtworks.go.domain.materials.packagematerial| true| Turn on logging for materials of type packagematerial.
com.thoughtworks.go.domain.materials.perforce| true| Turn on logging for materials of type perforce.
com.thoughtworks.go.domain.materials.scm| true| Turn on logging for materials of type scm.
com.thoughtworks.go.domain.materials.svn| true| Turn on logging for materials of type svn.
com.thoughtworks.go.domain.materials.tfs| true| Turn on logging for materials of type tfs.
GoCD Agent
To turn on additional logging on the GoCD agent, you must:
* create/edit the file CONFIG_DIR/agent-logback-include.xml. The config directory is typically /var/lib/go-agent/config on Linux and C:\Program Files\Go Agent\config on Windows. See the section Log configuration syntax for the log configuration syntax.
The table below describes the various loggers that can be configured with the server:
Logger| Additivity| Description
---|---|---
org.springframework| true| This will enable debugging of the spring framework.
org.apache.http.wire| true| This will enable debugging of http connections between the agent and server.
com.microsoft.tfs.core| true| This will turn on debugging for the underlying Microsoft Team Foundation Server library used by GoCD.
com.thoughtworks.go.tfssdk14| true| This will turn on debugging for the GoCD wrapper around Microsoft TFS library.
com.thoughtworks.go.domain.materials.dependency| true| Turn on logging for materials of type dependency.
com.thoughtworks.go.domain.materials.git| true| Turn on logging for materials of type git.
com.thoughtworks.go.domain.materials.mercurial| true| Turn on logging for materials of type mercurial.
com.thoughtworks.go.domain.materials.packagematerial| true| Turn on logging for materials of type packagematerial.
com.thoughtworks.go.domain.materials.perforce| true| Turn on logging for materials of type perforce.
com.thoughtworks.go.domain.materials.scm| true| Turn on logging for materials of type scm.
com.thoughtworks.go.domain.materials.svn| true| Turn on logging for materials of type svn.
com.thoughtworks.go.domain.materials.tfs| true| Turn on logging for materials of type tfs.
Log configuration syntax
To configure logging, you can specify the configuration below. You must tweak the <logger /> and optionally <appender /> to write to specific log files. You can read more about logback configuration in the logback configuration documentation. This file will be reloaded every 5 seconds, so a restart of the GoCD server or agent is not necessary.
Note: It is recommended that you do not set the log level to
DEBUGorTRACEfor long periods of time since this can significantly affect performance.
1.
2. 3.
4.
5.
6.
7. 8.
14. 15.
34.
Example: Enable web-request logs
To turn on web request logs, add below content to logback-include.xml.
1.
2.
3. 4.
5.
6.
7.
8.
9.
10. 11.
12.
13.
14.
15.
16.
17.
18.
19. 20.
21.
22.
23.
Advanced logging features
If you’d like to send log events to a log aggregator service (like logstash, graylog, splunk) of your choice, you may require additional configuration to be performed:
* ensure that the relevant java libraries along with their dependencies are present in the libs directory, relative to the working directory of the GoCD server or agent process. The working directory is usually /var/lib/go-{server,agent} on linux, and C:\Program Files\Go {Server,Agent} on windows.
* configure appenders and encoders in the relevant logback-include.xml file for your agent or server
Example logstash setup
For e.g. to send logs to logstash (using logstash-logback-encoder) one would need to perform the following:
* download all logstash-logback-encoder jars and dependencies into libs dir:
* logstash-logback-encoder-4.11.jar
* jackson-databind-2.9.1.jar
* jackson-annotations-2.9.1.jar
* jackson-core-2.9.1.jar
Then follow the instructions on the README to configure your logback-include.xml to setup relevant appenders and encoders:
1.
2.
3. 4.
5.
6.
7.
8.
9. 10.
11.
12.
13.
Override Existing logback.xml
If you’d like to completely override the packaged logback.xml, create a CONFIG_DIR\logback.xml file. If such a file is present, GoCD will use the loggers and file appender provided in the file for logging. You can read more about logback configuration in the logback configuration documentation
The following is a sample logback.xml users can use to override logging for GoCD root logger. The example uses a user defined directory for writing logs.
1.
2.
3. 4.
5.
6.
7.
8. %date{ISO8601} %-5level [%thread] %logger{0}:%line - %msg%n
9.
10.
11. 12.
13.
14.
15.
16.
17.
18.
19. 20.
21.
22.
23. 24.
- Please note while overriding the logging for your GoCD server, redirect all logs to appropriate files in order to avoid any loss of logs.
Example gelf setup
Another example setup using GELF (Graylog Extended Log Format) using logback-gelf:
Download logback-gelf-1.1.0.jar and place it in libs directory. On typical linux server, that can be done with
1. wget "http://repo1.maven.org/maven2/de/siegmar/logback-gelf/1.1.0/logback-gelf-1.1.0.jar" -O /var/lib/go-server/libs/logback-gelf-1.1.0.jar
Configure logback-include.xml with any of the gelf appenders as defined on project documentation: An example logging over UDP could look like this:
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22. 23.
24.
25.
26.
