• EnglishEspañol日本語한국어Português
  • Log inStart now

Record and view deployments


We recommend that you use the change tracking feature instead of the older deployment markers. If you've been using deployment markers feature, you can still use it, but keep in mind that the change tracking feature is available for and , as well as .

Deploying an app can be a risky event—when your app breaks, and a bad deployment is often the cause. New Relic allows you to track deployments so you can correlate deployments with changes in your app's performance. Tracking deployments creates deployment markers that appear in APM charts and dashboards.

See how deployment markers work in this short video (4:30 minutes):

Options for tracking deployments

You can use the New Relic REST API v2 to record new deployments and retrieve a list of past deployments. In addition, some APM agents have agent-specific methods to record deployments automatically.

You can use your Slack integration with New Relic, or a simple webhook, to notify your team in real time of deployments for applications monitored by APM. Slack provides a webhook URL that allows you to post generic JSON that will appear formatted in a chosen Slack channel.

There are a few places where you can view deployments in the New Relic UI after they have been recorded:

  • In the activity feed on the APM Summary, Service summary, and entity summary pages.
  • On APM performance charts as chart markers (vertical lines with pinheads).
  • On dashboard charts as chart markers.
  • On the Deployments page for summary performance.


Deployment markers are not available for browser applications, but you can try these alternatives:

  • Switch from deployment markers to the change tracking feature that enables you to track browser application changes.
  • See browser releases for a way to tag errors with release versions.

Record deployments with the REST API

You can use the New Relic REST API v2 to record deployments and get a list of past deployments.

  • The examples in this document use curl as a command line tool. However, you can use any method to make your REST requests. You can also create and view deployments with the API Explorer.
  • JSON uses double quotes " for element names and content. Using single quotes ' will cause errors.
  • The examples use X-Api-Key which can be used for either a user key or a REST API key. User keys are now the preferred way of accessing our REST APIs, and you may use Api-Key headers when using them.

Record deployments using the New Relic agent

Some agents have additional methods to record deployments:

View deployment details

After you configure the deployment information, you can view and drill down into details in the UI. For tips, see our change tracking document How to view and analyze your changes in New Relic.

Notify your team about deployments

Whether you're tracking deployments with the REST API or the newer GraphQL API, you can notify your team members using a webhook. For details, see the change tracking webhook instructions.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.