To find the data retention UI: from theuser menu, clickManage your data and clickData retention.

On theData retention UIpage, you can review and manage how long different types of data are stored. You may want shorter retention for some data types in order to protect sensitive information, or you may want longer retention (up to seven years) to be able to see and analyze data and trends over a longer period.

To learn about plans and costs for changing retention, refer toData options: Data Plus and original.

Extend your data retention for long-term analysis and compliance

Extending your data retention allows you to do long-term analysis, visualization, and alerting for all your metrics, events, logs, and traces across all of your sources. However, it's important to manage that data for cost, performance, and in some cases, compliance reasons. Our data management hub provides the tools you need to understand and control where your data is coming from, and adjust what's stored and for how long.

Requirements

The way users manage data retention may depend on how many accounts you have in your organization and what they are trying to do.

Single-account organizations

If you are in an organization that has only one account in it, yourBilling User can manage the following:

• Max per contract: This is the highest value you can set for theEffective retention of a data type. If you would like to increase this, see ourData Plus plan.
• Effective retention: This is the amount of time data is currently retained for a data type. For the user to be able to edit this, the organization (account) needs to be onStandard or a higher edition.

If your Billing User can't perform either of these two tasks, contact support or your New Relic representative.

Multiple-account organizations

If you're in an organization that has more than one account in it, users can manage the following:

• Max per contract: This is the highest value you can set for theEffective retention of a data type. If you would like to increase this, see ourData Plus plan.
• Effective retention: This is the amount of time data is currently retained for a data type. For the user to be able to edit this:
  • The organization (account) needs to be onPro or a higher edition.
  • The user type needs to beFull platform.
  • The user would needView andModify permissions for theInsights event retention feature thatpoints to the account(s) they need to editEffective retention for.

If your user can't perform either of these two tasks after referencing the above details, contact support or your New Relic representative.

Default retention periods

The best way to understand your New Relic data retention is to go to theData retention UI page. We recommend this because your organization may have edited your settings and so they might not be the default settings shown below.

This table shows the defaultnamespace retention settings.

Retention details for assorted data types

In this section are details about a few different types of data, including some data types that have retention settings that can't be changed.

Edit data retention

To view and edit your retention, go todata retention view, and clickEdit data retention. There you'll see options for editing data retention or upgrading to Data Plus. If you don't see that, reviewthe requirements and talk to your New Relic account representative.

Options for increasing retention:

• If you haven't already, switch toData Plus, which offers significantly longer data retention and other benefits.
• For Data Plus or original data option: add data retention. 30 days of additional data retention for your organization costs $0.05 per GB ingested per month.

Important points about increasing retention:

• When you enable a higher retention period, retention is increased across the board for all data types listed in theData retention UI. It cannot be increased only for specific data types.
• Once you enable a higher retention period, reducing retention for specific data sources has no impact on your billing. To learn about ways to reduce your data ingest and billing, seeManage data ingest.
• When you adjust retention, it can take up to 24 hours to take effect.

Reducing retention

When you reduce the retention period for a data source, existing data of that 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 quicklyremoving data.

To learn about options for reducing data ingest, seeManage data ingest.

Delete existing data

Oncetelemetry data is reported to the New Relic database 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 itsdata retention period ends. If you want to delete data that has already been reported, contact your New Relic representative, if you have one.

Export and stream data

Organizations with Data Plus can export their data for long-term storage using their preferred tools. Features related to this include:

• Streaming data export
• Historical data export

Manage retention via API

In addition to changing your retention settings in the UI, you can use ourNerdGraph API. Some example NerdGraph requests are included below. Note that your data retention changes may take up to 24 hours to take effect.

Before using the API to adjust retention, reviewthe rules on adjusting retention.

query{
actor{
account(id:YOUR_ACCOUNT_ID){
dataManagement{
customizableRetention{
eventNamespaces{
namespace
}
}
}
}
}
}

query{
actor{
account(id:YOUR_ACCOUNT_ID){
dataManagement{
eventRetentionRules{
id
deletedAt
deletedById
createdAt
createdById
retentionInDays
namespace
}
}
}
}
}

query{
actor{
account(id:YOUR_ACCOUNT_ID){
dataManagement{
eventRetentionRule(namespace:"APM"){
id
deletedById
deletedAt
createdById
createdAt
retentionInDays
namespace
}
}
}
}
}

mutation{
dataManagementCreateEventRetentionRule(
accountId:YOUR_ACCOUNT_ID
namespace:"APM"
retentionInDays:8
){
id
deletedById
deletedAt
createdById
createdAt
retentionInDays
namespace
}
}

mutation{
dataManagementDeleteEventRetentionRule(
accountId:YOUR_ACCOUNT_ID
namespace:"APM"
){
id
deletedById
deletedAt
createdById
createdAt
retentionInDays
namespace
}
}

mutation{
dataManagementCopyRetentions(
sourceAccountId:SOURCE_ACCOUNT_ID
destinationAccountIds:[
DESTINATION_ACCOUNT_ID_1
DESTINATION_ACCOUNT_ID_2
DESTINATION_ACCOUNT_ID_3
]
){
success
failure
}
}

Account inheritance

The data retention settings of aparent account are inherited by its children accounts. In this context, a New Relic organization's first account is considered the parent account, and other accounts added to the organization inherit the settings in that account.

RSS - Atom

Subscribe to theRSS feed.