• Log inStart now

Track changes using NerdGraph (GraphQL)

The change tracking feature allows you to track the effect of various changes on your customers and systems. For example, if you make some deployments, you can use the change tracking feature to monitor the results in New Relic UI charts. You'll also get access to features that help you understand the effects of those changes.

Instead of designating which changes you want to monitor by using our CLI or a CI/CD integration, you can do the same thing using GraphQL mutations and queries via our NerdGraph API.

For general information on using NerdGraph, see Introduction to NerdGraph.


Requirements include:

  • NerdGraph requirements
  • User permissions: Any user type can use NerdGraph to create deployment markers and track other changes, but only full platform users can access the curated change tracking UI experiences.

Understand fields in NerdGraph explorer

The fields you'll use in your GraphQL queries fall into these general types:

Create a deployment marker using a mutation

To record a change, such as a deployment, you'll need to include the required fields, and then decide if you want to include any optional fields.

Here are some example GraphQL mutations that show some ways to create deployment markers:

Query deployments

You can use GraphQL and NRQL queries to fetch data about changes related to deployments. See the examples below to try out some queries. You can also learn about GraphQL queries in the NerdGraph entities API tutorial.

What's 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.

Copyright © 2023 New Relic Inc.

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