TeamCity

Host

To configure this check for an Agent running on a host:

Edit the teamcity.d/conf.yaml in the conf.d/ folder at the root of your Agent’s configuration directory. See the sample teamcity.d/conf.yaml for all available configuration options:

The TeamCity check offers two methods of data collection. To optimally monitor your TeamCity environment, configure two separate instances to collect metrics from each method.

1. OpenMetricsV2 method (requires Python version 3):

   Enable use_openmetrics: true to collect metrics from the TeamCity /metrics Prometheus endpoint.

   init_config:
   
   instances:
       ## @param server - string - required
       ## Specify the server name of your TeamCity instance.
       ## Enable Guest Authentication on your instance or enable the
       ## optional `basic_http_authentication` config param to collect data.
       ## If using `basic_http_authentication`, specify:
       ##
       ## server: http://<USER>:<PASSWORD>@teamcity.<ACCOUNT_NAME>.com
       #
     - server: http://teamcity.<ACCOUNT_NAME>.com
       ## @param use_openmetrics - boolean - optional - default: false
       ## Use the latest OpenMetrics V2 implementation to collect metrics from
       ## the TeamCity server's Prometheus metrics endpoint.
       ## Requires Python version 3.
       ##
       ## Enable in a separate instance to collect Prometheus metrics.
       ## This option does not collect events, service checks, or metrics from the TeamCity REST API.
       #
       use_openmetrics: true
   

Note: To collect OpenMetrics-compliant histogram and summary metrics (available starting in TeamCity Server 2022.10+), add the internal property, teamcity.metrics.followOpenMetricsSpec=true. See, TeamCity Internal Properties.

2. TeamCity Server REST API method:

   Configure a separate instance in the teamcity.d/conf.yaml file to collect additional build-specific metrics, service checks, and build status events from the TeamCity server’s REST API. Specify your projects and build configurations using the projects option (requires Python version 3):

   init_config:
   
   instances:
     - server: http://teamcity.<ACCOUNT_NAME>.com
   
       ## @param projects - mapping - optional
       ## Mapping of TeamCity projects and build configurations to
       ## collect events and metrics from the TeamCity REST API.
       #
       projects:
         <PROJECT_A>:
           include:    
           - <BUILD_CONFIG_A>
           - <BUILD_CONFIG_B>
           exclude:
           - <BUILD_CONFIG_C>
         <PROJECT_B>:
           include:
           - <BUILD_CONFIG_D>
         <PROJECT_C>: {}
   

   Customize each project’s build configuration monitoring using the optional include and exclude filters to specify build configuration IDs to include or exclude from monitoring, respectively. RegEx patterns are supported in the include and exclude keys to specify build configuration ID matching patterns. If both include and exclude filters are omitted, all build configurations are monitored for the specified project.

   For Python version 2, configure one build configuration ID per instance using the build_configuration option:

   init_config:
   
   instances:
     - server: http://teamcity.<ACCOUNT_NAME>.com
   
       ## @param projects - mapping - optional
       ## Mapping of TeamCity projects and build configurations to
       ## collect events and metrics from the TeamCity REST API.
       #
       build_configuration: <BUILD_CONFIGURATION_ID>
   

Restart the Agent to start collecting and sending TeamCity events to Datadog.

Log collection

1. Configure TeamCity logging settings.

2. By default, Datadog’s integration pipeline supports the following kind of log format:

   [2020-09-10 21:21:37,486]   INFO -  jetbrains.buildServer.STARTUP - Current stage: System is ready
   

   Clone and edit the integration pipeline if you defined different conversion patterns.

3. Collecting logs is disabled by default in the Datadog Agent. Enable it in your datadog.yaml file:

   logs_enabled: true
   

4. Uncomment the following configuration block in your teamcity.d/conf.yaml file. Change the path parameter value based on your environment. See the sample teamcity.d/conf.yaml for all available configuration options.

   logs:
     - type: file
       path: /opt/teamcity/logs/teamcity-server.log
       source: teamcity
     - type: file
       path: /opt/teamcity/logs/teamcity-activities.log
       source: teamcity
     - type: file
       path: /opt/teamcity/logs/teamcity-vcs.log
       source: teamcity
     - type: file
       path: /opt/teamcity/logs/teamcity-cleanup.log
       source: teamcity
     - type: file
       path: /opt/teamcity/logs/teamcity-notifications.log
       source: teamcity
     - type: file
       path: /opt/teamcity/logs/teamcity-ws.log
       source: teamcity
   

5. Restart the Agent.

Containerized

For containerized environments, see the Autodiscovery Integration Templates for guidance on applying the parameters below.

Log collection

Collecting logs is disabled by default in the Datadog Agent. To enable it, see Kubernetes log collection.