Important
This doc is for accounts on our original Product-based pricing. If you're on the newer pricing plan, see New Relic One pricing plan. Not sure which you're on? See Overview of pricing plans.
For accounts on our original pricing plan, this document explains:
- How New Relic calculates billable usage for an Insights Pro subscription.
- Available subscription usage attributes and example NRQL queries to use in the New Relic UI or in API calls.
Data generation
Once per day, an account with an Insights Pro subscription will generate an NrDailyUsage
event for every event namespace. A NrDailyUsage
event includes a count of the events under that namespace.
To view the attributes for this event, see the NrDailyUsage
entry in the data dictionary.
Usage calculations
Tip
Only the account Owner and Admins can view the usage UI. However, anyone in your account can query usage data using the NrDailyUsage
event.
To get an estimate of the current month's billable usage:
- Go to: account dropdown > Account settings > Usage.
- On the Insights usage page, set the time picker to Current month.
For more information about the usage UI, see Introduction to subscription usage data.
The Insights usage UI only displays paid events: these are events that count towards an Insights Pro subscription. It does not display events that are included free as part of other New Relic product subscriptions. However, you can also query the product included events.
How long specific events are retained will depend on each event type's data retention period. For a list of the applicable event types, see Event namespaces.
Table definitions
Here are definitions of the column headers displayed in the UI table and CSV files. The columns you see depend on the Group by option you select in the UI.
Header | Definition |
---|---|
Account name | The name of the account. This can be a standalone account, a master account, or a partnership. |
Account ID | |
Event namespace | The category of event governed by Insights subscription. For example: |
Stored paid events | The number of events stored that count towards an Insights Pro subscription. Events included as part of other New Relic product subscriptions are not counted. |
% of total usage | The percentage of the total usage used. |
Event namespaces (types)
An Insights Pro subscription governs the data retention of certain types of events. An event's namespace (indicated by the insightsEventNamespace
attribute) corresponds to one or more event types that share a single data retention policy.
Event namespace in UI | Event namespace when queried | Event types |
---|---|---|
APM Transactions |
|
|
APM Errors |
|
|
Browser |
|
|
Page view timing |
|
|
SPA monitoring |
|
|
JS errors |
|
|
Custom:* |
| Event types stored using custom filters created by New Relic. Not applicable for most customers. |
Custom events |
| Custom event types that you create using New Relic agents or the Event API |
|
| |
Mobile crash |
|
|
Mobile error (for HTTP requests and HTTP errors features) |
|
|
Mobile exception |
|
|
Mobile general |
|
|
Mobile session |
|
|
Query examples
To get the most out of your Insights usage data, you can:
- Run queries of this data and create custom charts and dashboards.
- Use this data programmatically, using one of our APIs.
For general information about how to use NRQL queries, see Introduction to usage data.
Tip
Insights writes usage events once per day. That is why these queries use since 24 hours ago
or timeseries 1 day
.
Here are some NRQL query examples about usage.
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 data security and licenses documentation.