• /
  • Log in

Manage data retention

Using the Data retention page, review and manage how long your data will be stored in the New Relic database (NRDB). Keep data for shorter periods to protect sensitive information or for longer periods to notice trends over time. At a glance, get the sources of data that you’re storing, when they were last updated, and the length the data is stored. Retention settings range from 8 to 395 days depending on the data's source and namespace classifications in New Relic.

screenshot of data retention page

From the Data retention page, which shows the source of data, you can click Edit settings to adjust the data retention for each source.

Important

This doc applies to organizations on our New Relic One pricing plan. If you're on our original product-based pricing plan, you have different data retention rules. See Original data retention. Not sure which plan you're on? See Overview of pricing and user model.

Retention periods

The following table shows the default retention settings for our New Relic One pricing plan. To adjust retention settings, you must be on a Pro or Enterprise tier.

Source

Event namespace

Days retained

APM

APM

8

APM

APM errors

8

Browser

Browser

8

Browser

Browser events

8

Browser

Browser JS errors

8

Browser

Browser page view timing

8

Custom events

Custom events

30

Serverless

Lambda

8

Serverless

Lambda custom

8

Serverless

Lambda spans

8

Logs

Log

30

Infrastructure

Infrastructure processes

8

Infrastructure

Infrastructure integrations

395 (13 months)

Mobile

Mobile crash event trails (breadcrumb)

8

Mobile

Mobile exception

8

Mobile

Mobile general

8

Mobile

Mobile error

8

Mobile

Mobile crash

90

Mobile

Mobile session

90

Synthetics

Synthetics data

395 (13 months)

Traces

Traces

8

Adjust retention values

You can adjust your retention periods to better support your data needs. For example, you might reduce your contracted retention values to optimize query performance. Conversely, you might increase retention for some data types to support more granular analysis over longer periods of time, or to meet data compliance requirements.

The ability to edit data retention periods requires a specific edition of New Relic.

  • Original pricing plan users must have Insights Pro.

  • New Relic One pricing plan users have these edition considerations:

    • Standard edition: your data retention is fixed, and falls between 8 and 395 days (about 13 months) of retention, depending on which capabilities of the New Relic platform you’re using. The prescribed retention levels ensure that you can explore your data and experience the value of New Relic. If you need to raise some of the retention limits for your particular business needs, you can purchase additional retention.
    • Pro or Enterprise: If after you finalize your contracted retention you realize you need to make changes, you can adjust your telemetry data retention settings yourself.

User roles and retention

In order to edit retention, users need these roles:

Reduce retention values

When you reduce the number of days that specific data sources are retained, existing data of that source type won't immediately disappear. That data might be visible and returned in queries for up to several weeks. We have safeguards in place to ensure you don't accidentally delete data, but this also means that reducing retention values isn't a good strategy for quickly removing data.

That said, your change is registered in the system within 12 hours and new data of the adjusted source type will be retained for the new duration.

Note that reducing data retention below your contracted retention values will not reduce New Relic’s data ingest charges. Conversely, increasing retention for targeted telemetry data types is likely to trigger a conversation with New Relic about adjusting your data ingest charges.

Copy retention values

If you have permission to edit retention settings, you can also copy retention values from one child account to other child accounts under the same parent account. To do this, from within a child account, select the Copy settings to other accounts link, and then select the child accounts you want to apply the retention values to.

image of child accounts to copy retention values to

Select the child accounts you want to copy retention values to.

Data deletion

Once telemetry data (events, metrics, logs, traces) is reported to New Relic and available for querying, that data cannot be edited or deleted. This is a purposeful design decision that optimizes New Relic's speed and performance. Data will expire after its data retention period ends. If you need to delete data, contact your New Relic representative.

Manage retention via API

You can change your retention settings with NerdGraph as well as the UI. For the following examples, provide any necessary information, and run the code in the NerdGraph GraphiQL explorer.

Your retention changes take effect within 24 hours after updating.

Metric data rollup

Metric timeslice data is generated by APM (both custom metrics and default metrics), mobile, and browser agents. A metric timeslice consists of three parts: a metric name, the segment of time the metric represents (the "timeslice"), and a numeric value (the measurement). APM, browser, and mobile agents can collect thousands of metric timeslices per minute for a variety of performance metrics, such as error rate, bandwidth usage, and garbage collection time.

Metric timeslice data is aggregated and rolled up:

  • first to 1-minute increments, known as rollups, that are retained for 8 days
  • each day, those 1-minute rollups are aggregated to 1-hour roll-ups that are retained for 90 days

Key metric data is stored indefinitely. We meter on the size of the initial 1-minute rollup, and not on any of the subsequent rollups. Read on to learn the key metrics by product.

Key metrics reported by APM, browser, and mobile

Here are the key metrics that are stored indefinitely.

Product

Key metrics

APM

Browser

  • Apdex, for browser
  • Browser page load time
  • Throughput total. After 90 days, there is no breakout by browser type, and only the combined average value is available for the time range requested.

Mobile

Raw metric data

Raw metric data is handled a little differently when it comes from APM, Prometheus remote-write API, metrics functionality of the Telemetry SDK, and integrations built on the Telemetry SDK. Raw sub-minute metric data is stored for 30 days. Beyond 30 days, 1-minute resolution roll-up events are created and retained for 13 months. Like with metric timeslice data, we meter and bill on the size of the raw ingest, not the subsequent rollups.

Metric retention periods are not editable.

Account inheritance

The data retention settings of a parent account are inherited by its children accounts. In this context, an organization's first account is treated as the parent account, and other accounts added to the organization inherit the settings in that account. You also have the option to override those settings and set account-specific data retention settings.

Original pricing plan differences

If you're on our original product-based pricing plan, you have different data retention rules. See Original data retention.

For more help

If you need more help, check out these support and learning resources:

Create issueEdit page
Copyright © 2021 New Relic Inc.