This is a template. Feel free to copy the text in this template to create your own GraphQL API tutorial, then fill in details that will help users learn how to use GraphQL in practical ways.
Ideally the final version of your GraphQL doc will include:
- An introduction paragraph describing what problem or use case the users want to solve, or why the API can help them query to get this data
- Three to five query examples that show interesting data they can get from GraphQL
Sample intro paragraph: You can use the New Relic GraphQL API to [add key use cases here]. To construct these queries and see responses, you can use the New Relic GraphQL Explorer. This document explains some of the available functions to query [data to be queried].
Example query #1 with GraphQL
Add a description here for your example query. Tell users why they want to query this kind of data. Fill out the first block with your code, and the second with the data returned by the query:
{
actor {
account(id: YOUR_ACCOUNT_ID) {
nrql(query: "SELECT count(*) FROM Transaction SINCE 1 HOUR AGO") {
results
}
}
}
}
This query returns the following:
{
"data": {
"actor": {
"account": {
"nrql": {
"results": [
{
"count": 1000
}
]
}
}
}
}
}
The actual value of the count varies depending on your data. Use the New Relic GraphQL Explorer to experiment with queries.
Example query #2 with GraphQL
Add a description here for your example query. Tell the customer why they want to query this kind of data. Fill out the first block with your code, and the second with the data returned by the query:
{
actor {
account(id: YOUR_ACCOUNT_ID) {
nrql(query: "SELECT count(*) FROM Transaction SINCE 1 HOUR AGO") {
results
}
}
}
}
This query returns the following:
{
"data": {
"actor": {
"account": {
"nrql": {
"results": [
{
"count": 1000
}
]
}
}
}
}
}
The actual value of the count varies depending on your data. Use the New Relic GraphQL Explorer to experiment with queries.
Example query #3 with GraphQL
Add a description here for your example query. Tell the customer why they want to query this kind of data. Fill out the first block with your code, and the second with the data returned by the query:
{
actor {
account(id: YOUR_ACCOUNT_ID) {
nrql(query: "SELECT count(*) FROM Transaction SINCE 1 HOUR AGO") {
results
}
}
}
}
This query returns the following:
{
"data": {
"actor": {
"account": {
"nrql": {
"results": [
{
"count": 1000
}
]
}
}
}
}
}
The actual value of the count varies depending on your data. Use the New Relic GraphQL Explorer to experiment with queries.
For more help
If you need more help, check out these support and learning resources:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's and and documentation.