Event data retention

New Relic products report a wide range of event data. Different products have different data retention periods, and different ways to extend event data retention.

Overview of event data retention

All New Relic product subscriptions come with a certain level of data retention that governs how long different types of data are retained. One type of data governed by data retention rules is event data. Event data is available in some UI charts and tables, and also available for querying via NRQL, our querying language.

There are events reported from products by default, and there are custom events: each have their own retention rules, depending on the product and subscription level.

Here are some examples of how different product subscriptions can affect event data retention:

  • Free/Lite APM subscription: default-reported events available for 1 day. No custom events available.
  • Pro APM subscription: default-reported events available for 8 days. Custom events available for 1 day (and able to be extended with Insight Pro).

To see your New Relic subscriptions, go to the Account summary page.

Extend event data retention

There are different ways to lengthen the retention of your event data:

For other product data retention details, see Data retention.

For details about the data retention of other products or integrations, see that specific documentation.

Insights Pro subscription

A paid Insights subscription is what governs the extension of event data retention for:

  • Our APM, Browser, Mobile, and Serverless products
  • Custom events that come from an agent API or from the Event API

Note that having an Insights Pro subscription doesn't require use of the Insights UI (insights.newrelic.com) to query your data: there are other querying options available.

To see the data retention governed by your Insights subscription, go to: rpm.newrelic.com > Account dropdown > Account settings > Usage > Event data retention.

With an Insights Pro subscription, you can use flexible retention to customize how your event data is retained. This lets you keep only the data you need, for as long as you need it.

How number of events stored is calculated

This is an explanation of how the number of stored events are calculated by default for an Insights Pro subscription. (Note that with flexible retention, you have more fine-grained control over the retention period.)

The events stored is calculated based on 1) total events stored over time (calculated based on the events generated per week) and 2) the weeks of data retention available. This equation can be represented like this:

events stored = (events generated per week) * (weeks of retention)

An Insights Pro subscription provides a given number of weeks of data retention as well as a given number of events over that retention period.

For example:

  • (200M transactions per week) * (4 weeks of retention) = 800M events stored in Insights
  • (16M transactions per week) * (50 weeks of retention) = 800M events stored in Insights

For Insights Pro subscriptions, data is purged based on retention window, not volume. It is deleted from the system once it's past the retention window.

For example: If your Insights license is for 800 million events with a 4 week retention period, your data would start being purged after it is older than four weeks. Temporary spikes in data exceeding your subscription level will still be recorded, but consistent overage should be solved by upgrading your subscription level or decreasing data collected.

For customers without an Insights Pro subscription, New Relic may throttle or downsample events to a limit of not more than than 4,000 events per host per minute.

Insights Pro overage example

In this example, you have an Insights Pro subscription with a license for 800 million events over 4 weeks, a rate of 200 million events per week. You have APM Pro, Browser Pro, and Mobile Enterprise. A fifth week of data is added via your subscriptions, bumping you to a total of 1 billion events stored within your plan:

  • If you are using 975 million events, you are not over your retention.
  • If you are using 1.25 billion events, you are over your retention.

Disable/enable Transaction and Pageview event reporting

Owners or Admins

The Insights Data summary UI page is used to see the types of events being reported. You can also use this page to enable and disable the reporting of PageView and Transaction events.

To view Data summary:

  1. Go to insights.newrelic.com > Manage data.
  2. Select the Summary tab.

Note: if you disable PageView or Transaction event reporting, this can affect some New Relic UI elements. You may see some empty charts on some UI pages that rely on this data.

  1. Go to insights.newrelic.com > Manage data > Summary.
  2. From the Summary tab, select Configure data sources.
  3. Toggle the appropriate switch on or off, then save.

Toggling Transaction on or off will cause reporting agents to restart themselves.

For more about configuring event reporting, see Event data retention.

For more help

Recommendations for learning more: