Introduction to the Metric API

New Relic's Metric API lets you send metric data to New Relic from a variety of sources.

Why use New Relic's Metric API?

New Relic's Metric API makes it easy to send virtually any metric data to New Relic. The Metric API is an HTTP endpoint; to send data, you make a POST request to the endpoint with a JSON payload containing your metric data points.

Use our Metric API if you want to:

  • Report metric data to New Relic without a New Relic agent.
  • Integrate metric data from an open source or in-house developed tool, library, or framework.
  • Have full control over the metric data you are sending including the resolution and associated dimensions.
  • Leverage the power of NRQL for querying your metric data.
  • Set up alerts for your metric data.

To integrate metric data from an open source library, tool, or framework, check out our exporters for Prometheus, Dropwizard, or Micrometer. If you’re using one of our supported programming languages, you can also use the Telemetry SDK. The Telemetry SDK client libraries are built on top of the Metric API, and encode best practices for sending metric data efficiently and reliably.

Get started

To start sending data, see Report metrics via the Metric API. It only takes a few steps to send your first metric data points to New Relic.

Access and requirements

This service is currently generally available free of charge until November 30, 2019 ("Free Period") to all New Relic paid accounts, subject to these limitations:

  • Ingest limit of 100 thousand metric data points ("Raw Metric Data Points") per minute ("Ingest Limit"). Any change to the Ingest Limit beyond this rate may result in a charge to you.
  • Cardinality limit of 50 thousand unique metric time series per day ("Cardinality Limit"). Any change to the Cardinality Limit beyond the published limit may result in a charge to you.
  • All Raw Metric Data Points will be retained for 30 days free of charge. All additional aggregated data, for example 1-minute rollups, derived from the Raw Metric Data Points, will be retained for 13 months without charge. Any change to the retention period beyond such periods may result in a charge to you.
  • New Relic reserves the right to restrict your free access for this service at any time upon notice to you, including after: (i) the Ingest Limit or Cardinality Limit is exceeded, or (ii) the initial Free Period, but New Relic may increase or extend either case at its sole discretion.

All you need to get started is a Insert API key. For additional information on limits and restricted attributes, see Metric API requirements and limits.

View and query your metrics

After you start sending us your metric data, you can use NRQL to view and query your metrics. For metric functions, examples, and sample queries, see Query metric data.

Alert on metric data

To alert on metrics created via the Metric API, use NRQL alert conditions: Select the NRQL category when defining your condition, then use the FROM Metric ... NRQL query syntax to express it. When you create these alert conditions, Alerts automatically uses the finest granularity data available (the raw metric data points) to evaluate alerts.


If receive a NrIntegrationError, see Troubleshoot a NrIntegrationError event.

For more help

Recommendations for learning more:

  • Browse New Relic's Explorers Hub for community discussions about New Relic's APIs.
  • Use your preferred search engine to find other New Relic resources.