This document describes data requirements for the Metric API, including:
- Maximum limits
- Restricted attributes
The following default limits apply for all Metric data:
Age range for timestamp values
Metrics reported with a timestamp older than 48 hours ago or newer than 24 hours from the time they are reported are dropped.
Max data points per minute (DPM)
1 million DPM
Max unique timeseries (cardinality) per account per day
A timeseries is a single, unique combination of a metric name and any attributes.
Max unique timeseries (cardinality) per metric name per day
Max payloads per minute
Max attributes per metric
Max metric attribute name length
Max characters for an attribute key
Max metric attribute value length
Allowed HTTP protocols
Numerical long values falling outside minimum or maximum Java long values
Numerical long values that fall outside of the minimum or maximum Java long value will be rejected.
Numerical double values falling outside minimum or maximum Java double values
Numeric double values that fall outside of a the minimum or maximum Java double value will be rejected.
Total maximum size or length: 1MB (10^6 bytes) maximum per POST. We highly recommend using compression.
The payload must encoded as UTF-8.
Attribute naming syntax
Attribute names can be a combination of alphanumeric characters, colons (
The following default limits apply only to data collected via the Prometheus Remote Write integration:
Max unique Count and Summary timeseries (cardinality) per account per 5 minute interval
A timeseries is a single, unique combination of a metric name and any attributes. Timeseries received above this limit are dropped. This limit is enforced prior to and in addition to standard Metric limits.
Metric API limits apply at the individual account level. Trial and paid accounts receive a 1M DPM and 1M cardinality limit for trial purposes, but you can request up to 15M DPM and 15M cardinality for your account. To request changes to your metric rate limits, contact your New Relic account representative, or visit our Support portal.
This section describes how the Metric API behaves when you exceed the rate limits, and how to respond if limits are exceeded.
These attributes are restricted by the New Relic platform. Any values submitted with these keys in the attributes section of a metric data point will cause the data point to be dropped, or the value to be omitted or overwritten:
This resets to the value
This resets to the
Additional restrictions include:
Metric and attribute names
You cannot pass the same value for metric name and attribute name.
In the following example, the metric is invalid because the metric is named
Example: Metric value used as an attribute (invalid)
The Metric API inherits some reserved words from New Relic Insights, including
Keys within metric JSON
All keys used within the metric JSON cannot be attribute keys. This includes
Exception: You can use
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.