--- title: Track changes using Jenkins source: https://docs.newrelic.com/docs/change-tracking/config/change-tracking-jenkins --- The change tracking feature allows you to designate changes you want to monitor to see how they affect your customers and systems. While you can designate which changes you want to monitor by using GraphQL or our CLI, you can also record changes using pipelines in Jenkins. A pipeline will call whatever build you specify and also pass additional environment variables to the build process. This populates the data that is needed for your deployment to show up in charts across New Relic. You'll see the results in the change tracking UIs, and you can use this information to understand the impact of changes on entity health. ## Prerequisites [#prereq] To install the Jenkins plugin, you'll need: - Jenkins 1.580.1 or newer - Jenkins administrator privileges ## Install the Jenkins plugin [#install] 1. When you open Jenkins, go to **Manage Jenkins**, then **Plugins**. ![Screenshot showing where to find Manage Jenkins](https://docs.newrelic.com/images/tracking_screenshot-crop_jenkins-home-page.webp "Screenshot showing where to find Manage Jenkins") 2. Click **Available plugins**, then search `newrelic-deployment-notifier`. Click **Install**. ![Screenshot showing how to install the plugins](https://docs.newrelic.com/images/tracking_screenshot-crop_jenkins-install-notifier.webp "Screenshot showing how to install the plugin") 3. A new page appears with your installation's progress. No restart is needed for the plugin. ## Create Post-build Action [#create-post--build-action] To add the New Relic Deployment Notifier as a Post-build Action in your Jenkins build job configuration: 1. In your Jenkins job configuration go to the **Post-build Actions section**, click on **Add post-build action**, then select **New Relic Deployment Notifications**. ![Screenshot showing the Add post-build action button, with the dropdown menu showing New Relic Deployment Notifications](https://docs.newrelic.com/images/tracking_screenshot-crop_jenkins--postbuild.webp "Screenshot showing the Add post-build action button, with the dropdown menu showing New Relic Deployment Notifications") 2. Create a username/password credential for the User [API key](https://docs.newrelic.com/docs/apis/intro-apis/new-relic-api-keys/). Enter the key as the password. ![Screenshot showing credential creation dialog](https://docs.newrelic.com/images/tracking_screenshot-crop_jenkins--credential.webp "Screenshot showing credential creation dialog") 3. Select an entity in the dropdown list. ![Screenshot showing how to find Deployment Notifications](https://docs.newrelic.com/images/tracking_screenshot-crop_jenkins--validcredential.webp "Screenshot showing how to find Deployment Notifications") 4. Add the required `Version` or `Revision` value, and any of the optional values. You can [use environment variables](https://www.jenkins.io/doc/book/pipeline/jenkinsfile/#using-environment-variables) in these fields, like `${BUILD_NUMBER}`. ![Screenshot showing optional fields](https://docs.newrelic.com/images/tracking_screenshot-crop_jenkins--optional.webp "Screenshot showing optional fields") | Field | Description | | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Description | Insert a description of what you are tracking. | | Revision | Revision for the deployment. `${BUILD_NUMBER}` could be a good value here. | | Changelog | Reference to the list of changes incurred in the deployment. | | Commit | A hash to reference the commit ID. | | Deeplink | A deep link to either the Jenkins job or any other reference to the deployment. | | EntityGuid | The application entity in reference to the deployment (see [More about the application GUID](#guid)). | | DeploymentType | The type of deployment that is being conducted. | | GroupId | An identifier to reference a cluster of changes. | | Timestamp | Optional timestamp in Unix Epoch long format. If not provided, then we will set it to the time we received the request, which will be the number of milliseconds since the Unix Epoch. | | Version | Version of what's being deployed. `${BUILD_NUMBER}` could be a good value here. | | User | The user conducting the deployment. **Tip:** You can install [Build User Vars Plugin](https://wiki.jenkins.io/display/JENKINS/Build+User+Vars+Plugin) to have environment variables regarding the Jenkins user, and can use them in this field, like `${BUILD_USER}`. ![Screenshot showing User field set to ${BUILD_USER}](https://docs.newrelic.com/images/tracking_screenshot-crop_jenkins--user.webp "Screenshot showing User field set to ${BUILD_USER}") | 5. (Optional) If this Jenkins job affects multiple entities, they can be added to receive notifications as well. Click the **Add another notification** button to add more apps. ## What's next? [#whats-next] After you've designated the changes you want to track, you can analyze the effect of those changes in the New Relic UI. For details, see [How to view and analyze your changes in New Relic](https://docs.newrelic.com/docs/change-tracking/change-tracking-view-analyze). ## Remove the plugin [#remove-plugin] 1. From the **Plugins** page, click **Installed plugins**. 2. Search for `newrelic-deployment-notifier`. 3. Click the red `X`. ![Screenshot to remove the plugin](https://docs.newrelic.com/images/tracking_screenshot-crop_jenkins-rollback.webp "Screenshot to remove the plugin")