A Jenkins plugin for automatically forwarding metrics, events, and service checks to a Datadog account.

Note: The Jenkins CI plugin page for this plugin references this documentation.

This plugin requires Jenkins 1.580.1 or newer.

This plugin can be installed from the Update Center (found at Manage Jenkins -> Manage Plugins) in your Jenkins installation:

1. Select the Available tab, search for Datadog, and select the checkbox next to Datadog Plugin.
2. Install the plugin by using one of the two install buttons at the bottom of the screen.
3. To verify the plugin is installed, search for Datadog Plugin on the Installed tab. After the plugin is installed successfully, continue to the configuration section below.

Note: If you see an unexpected version of the Datadog Plugin, run Check Now from the Manage Jenkins -> Manage Plugins screen.

You can use two ways to configure your plugin to submit data to Datadog:

• Sending the data directly to Datadog through HTTP.
• Using a DogStatsD server that acts as a forwarder between Jenkins and Datadog.

The configuration can be done from the plugin user interface with a Groovy script, or through environment variables.

To configure your Datadog Plugin, navigate to the Manage Jenkins -> Configure System page on your Jenkins installation. Once there, scroll down to find the Datadog Plugin section:

1. Select the radio button next to Use Datadog API URL and Key to report to Datadog (selected by default).
2. Use your Datadog API key in the API Key textbox on the Jenkins configuration screen.
3. Test your Datadog API key by using the Test Key button on the Jenkins configuration screen directly below the API key textbox.
4. Save your configuration.

1. Select the radio button next to Use a DogStatsD Server to report to Datadog.
2. Specify your DogStatD server hostname and port.
3. Save your configuration.

Configure your Datadog plugin to forward data through HTTP or DogStatsD using the Groovy scripts below. Configuring the plugin this way might be useful if you're running your Jenkins Master in a Docker container using the official Jenkins Docker image or any derivative that supports plugins.txt and Groovy init scripts.

import jenkins.model.*
import org.datadog.jenkins.plugins.datadog.DatadogGlobalConfiguration

def j = Jenkins.getInstance()
def d = j.getDescriptor("org.datadog.jenkins.plugins.datadog.DatadogGlobalConfiguration")

// If you want to use Datadog API URL and Key to report to Datadog
d.setReportWith('HTTP')
d.setTargetApiURL('https://api.datadoghq.com/api/')
d.setTargetApiKey('<DATADOG_API_KEY>')

// Customization, see dedicated section below
d.setBlacklist('job1,job2')

// Save config
d.save()

import jenkins.model.*
import org.datadog.jenkins.plugins.datadog.DatadogGlobalConfiguration

def j = Jenkins.getInstance()
def d = j.getDescriptor("org.datadog.jenkins.plugins.datadog.DatadogGlobalConfiguration")

d.setReportWith('DSD')
d.setTargetHost('localhost')
d.setTargetPort(8125)

// Customization, see dedicated section below
d.setBlacklist('job1,job2')

// Save config
d.save()

Configure your Datadog plugin using environment variables with the DATADOG_JENKINS_PLUGIN_REPORT_WITH variable, which specifies the report mechanism to use.

1. Set the DATADOG_JENKINS_PLUGIN_REPORT_WITH variable to HTTP.
2. Set the DATADOG_JENKINS_PLUGIN_TARGET_API_URL variable, which specifies the Datadog API endpoint (defaults https://api.datadoghq.com/api/).
3. Set the DATADOG_JENKINS_PLUGIN_TARGET_API_KEY variable, which specifies your Datadog API key.

1. Set the DATADOG_JENKINS_PLUGIN_REPORT_WITH variable to DSD.
2. Set the DATADOG_JENKINS_PLUGIN_TARGET_HOST variable, which specifies the DogStatsD server host (defaults to localhost).
3. Set the DATADOG_JENKINS_PLUGIN_TARGET_PORT variable, which specifies the DogStatsD server port (defaults to 8125).

Logging is done by utilizing the java.util.Logger, which follows the best logging practices for Jenkins. To obtain logs, follow the directions in the Jenkins logging documentation. When adding a logger, all Datadog plugin functions start with org.datadog.jenkins.plugins.datadog. and the function name you are after should autopopulate. As of this writing, the only function available was org.datadog.jenkins.plugins.datadog.listeners.DatadogBuildListener.

From the global configuration page, at Manage Jenkins -> Configure System you can customize your configuration with:

From a job specific configuration page:

This plugin is collecting the following events, metrics, and service checks:

Build status jenkins.job.status with the default tags: : job, node, branch, result (Git branch, SVN revision, or CVS branch)

Note: Git branch tag is available when using the Git Plugin.

The jenkinsci/datadog-plugin repository handles the most up-to-date changes made to the Datadog Plugin, as well as issue tickets revolving around that work. Releases are merged to the Jenkins-CI git repository for the Datadog-plugin, and represents the source used for plugin releases found in the Update Center in your Jenkins installation.

Every commit to the repository triggers the Jenkins Org CI pipeline defined in the Jenkinsfile at the root folder of the source code.

A list of releases is available at jenkinsci/datadog-plugin/releases.

To release a new Datadog-plugin version:

1. Change the project version in the pom.xml from x.x.x-SNAPSHOT to the updated version number you would like to see.
2. Add an entry for the new release number to the CHANGELOG.md file, and ensure that all changes are listed accurately.
3. Clone the repository and checkout the master branch.
4. For repository admins only - Trigger the release by running the following command mvn -DlocalCheckout=true release:prepare release:perform. If the command completes successfully, then the newly updated plugin should be available from the Jenkins Update Center within ~4 hours (plus mirror propagation time).

GitHub's built-in issue tracking system is used to track all issues relating to this plugin: jenkinsci/datadog-plugin/issues. However, given how Jenkins plugins are hosted, there may be issues that are posted to JIRA as well. You can check this jenkins issue for those issue postings.

Note: Unresolved issues on JIRA mentioning Datadog.

See the CHANGELOG.md.

First of all and most importantly, thank you for sharing.

If you want to submit code, fork this repository and submit pull requests against the master branch. For more information, checkout the contributing guidelines for the Datadog Agent.

Check out the development document for tips on spinning up a quick development environment locally.

To keep track of testing procedures for ensuring proper functionality of the Datadog Plugin on Jenkins, there is a testing document.