NerdGraph tutorial: Partner and reseller subscriptions
The subscription provisioning functionality of our NerdGraph API allows you, as a New Relic partner, to create subscriptions for your accounts. And it gives you access to a more extensive range of New Relic products than the Partner API.
Requirements
You should not use NerdGraph to adjust your subscription provisioning unless specifically instructed by your New Relic representative.
NerdGraph's provisioning functionality and the Partnership API are compatible when it comes to the products supported by both (APM, Mobile, Insights, Browser, Synthetics, and Infrastructure). If you use NerdGraph to create a subscription for any of the newer products, you'll no longer be able to update the account using the Partnership API.
The NerdGraph provisioning functionality uses a mutation called organizationProvisioningUpdatePartnerSubscription. Here's an example request making subscription changes to a specific account:
NerdGraph doesn't allow you to upgrade or downgrade individual product subscriptions for an account. Instead, the API requires you to replace (add) the configuration for all product subscriptions for the account.
Tip
If any product configurations are not included, NerdGraph automatically provisions the account with a free product (when available).
Mapping for products (productId)
With each account creation call, you must supply at least one New Relic product type. The mutation query only accepts the numeric productId for the type.
The number of allowable hosts per account and the data retention period vary by subscription level within APM’s pricing structure. For example, APM allows an unlimited number of allowable hosts for Lite accounts, but only a 24-hour data retention period.
In addition, pricing and data retention depend on whether you select pricing models based on hosts or compute units (CU). Use the product ID’s integer format to identify the subscription level and type of plan.
Subscription level
products.id
unitsOfMeasure.unit
Lite
18
Not applicable
Standard
41
HOSTS
Standard Annual
38
HOSTS
Pro (Host)
42
HOSTS
Pro Annual (Host)
39
HOSTS
Enterprise
43
HOSTS
Enterprise Annual
40
HOSTS
If you select pricing models based on compute units (CU), use these product ID integer formats to identify the subscription level and type of plan.
New Relic Mobile's pricing structure allows 100,000 monthly active users per account at the Enterprise subscription level. Data retention varies by subscription level. Use the product ID’s integer format to identify the subscription level.
Subscription level
products.id
unitsOfMeasure.unit.1
unitsOfMeasure.unit.2
Lite
49
Not applicable
Not applicable
Enterprise
54
APPS
USERS
Enterprise Annual
55
APPS
USERS
Example request
Mobile Enterprise with 1 App and 100,000 Monthly Active user
New Relic Insights bases the pricing structure on the number of allowable events stored and the associated data retention policy. For example, data retention for Insights Free is one day.
Subscription level
products.id
unitsOfMeasure.unit.1
unitsOfMeasure.unit.2
Free
67
Not applicable
Not applicable
None
65
Not applicable
Not applicable
Pro
66
DATA_RETENTION_IN_DAYS
EVENTS_IN_MILLIONS
Pro Annual
69
DATA_RETENTION_IN_DAYS
EVENTS_IN_MILLIONS
Example request
Insights Pro with 7 days data retention and 25 million events
New Relic Browser’s pricing structure allows an unlimited number of app users, regardless of subscription level. However, the number of allowable page views per month and the data retention period vary by subscription level. For example:
Lite accounts include an unlimited number of page views per month and 24-hour data retention.
Pro account pricing starts at 500,000 page views per month and three months data retention.
Use the product ID’s integer format to identify the subscription level.
With New Relic Synthetics' pricing structure, the default number of allowable monitoring checks and the data retention period vary by subscription level. Use the product ID’s integer format to identify the subscription level.
Response: Once NerdGraph has received your request and has validated it is in the right format it will respond with a message like this. This does not mean that your message has been successfully processed or applied; but it has been validated to be in the right format and it enqueued for processing.