NerdGraph is our GraphQL-format API that lets you query New Relic data and configure some New Relic features. After you sign up for a free New Relic account and install any of our monitoring services, you can get started with NerdGraph.
What is NerdGraph?NerdGraph is one of several New Relic APIs. NerdGraph is the API we recommend for querying New Relic data and for performing some specific configurations (learn more about features). NerdGraph provides a single API interface for returning data from New Relic's various APIs and microservices. Over time, other configuration capabilities will be added to NerdGraph.
ImportantNerdGraph isn't used for data ingest. For that, you'd use our data ingest APIs.
NerdGraph is built using GraphQL , which is an open source API format that allows you to request exactly the data needed, with no over-fetching or under-fetching.
RequirementsBefore you get started:
The API endpoint you use depends on your data center region:
https://api.newrelic.com/graphql
https://api.eu.newrelic.com/graphql
To access the endpoint, you could make calls from your code, use the NerdGraph API explorer, or make a curl
command similar to this:
$curl -X POST https://api.newrelic.com/graphql \
> -H 'Content-Type: application/json' \
> -H 'API-Key: YOUR_NEW_RELIC_USER_KEY' \
> -d '{ "query": "{ requestContext { userId apiKey } }" }'
Use the NerdGraph API explorer
An easy way to experiment with the NerdGraph API is to use the NerdGraph API explorer. For help getting started with this tool, see NerdGraph API explorer tutorial.
NerdGraph functionalityNerdGraph functionality can be broken down into two main categories:
You can use NerdGraph to return and configure a wide range of data. One way to see what NerdGraph can do is to start building queries and exploring the schema using the NerdGraph explorer.
These are some of the most commonly used NerdGraph features:
Here are all our available NerdGraph docs:
NerdGraph terminologyThe following are terms that originate with GraphQL, the API format NerdGraph uses.
Term
Definition
Queries and mutations
There are two classes of GraphQL operations:
mutation
, as well as the name
of the mutation.Type
Data in GraphQL is organized into types. Types can be scalars (like strings, numbers, or booleans) or object types.
An object type is a custom type made up of a collection of fields. For example, an object type called User
may represent a user in a system.
Field
A field represents a piece of information on an object type that can be queried. Fields can be scalars, lists, or objects. For example, a User
object type could have a string field called name
.
Interface
An interface is an abstract type that represents a collection of common fields that other object types can implement
.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4