New Relic offers a variety of APIs and SDKs you can use to:
- Send data to New Relic.
- Retrieve data from New Relic.
- View and configure settings.
This document provides examples and reference information for our APIs.
APIs for data ingest
Our four primary data ingest APIs are some of the many solutions for reporting data to New Relic. These APIs can be used directly, but they're also the underlying ingest route for many of our more curated tools, such as our open source telemetry integrations and our Telemetry SDKs.
Data type | Description |
---|---|
Send metrics to New Relic from any source (including other telemetry monitoring services). | |
Send custom event data to New Relic without the use of an agent or integration. | |
Send your log data to New Relic. | |
Send distributed tracing data to New Relic without the use of an agent or integration. |
NerdGraph (GraphQL)
NerdGraph is the API we recommend for querying New Relic data, querying account information, and making a range of feature configurations. To learn what you can do, check out the NerdGraph tutorials.
NerdGraph is our newest API and is our attempt to bring together in one place some of our older APIs, like our REST API. Note that there is still some functionality you can do with REST APIs that can't yet be done with NerdGraph, and this is why some New Relic organizations still use the REST API.
REST API
Our REST API is our older API for querying and configuration, which NerdGraph is in the process of replacing. The REST API has some configuration abilities that NerdGraph doesn't yet have, but when possible you should use NerdGraph. The REST API can be used for a wide range of features: for detail, see APIs by feature.
APIs by feature
New Relic tools and features, like APM, infrastructure monitoring, browser monitoring, and alerts, are often used together, and sometimes can overlap in functionality. This is why multiple APIs may be relevant to each area. Some API functionality will depend on your access to features and data.
Account management, admin, and usage APIs
Like any other New Relic product or service, you want to be confident that your APIs protect you and your customers' data privacy. The following are API resources related to New Relic account administration and usage.
For more information about API capabilities, see the specific New Relic API. For more information about New Relic's security measures, see our security and privacy documentation, or visit the New Relic security website.
Resource | Details |
---|---|
REST API | REST API features include:
|
Subscription usage (original pricing plan) | For organizations on our original pricing plan, you can use NerdGraph to query subscription usage data. This can be helpful to see how usage compares to your current subscription level, or for doing departmental chargebacks. |
Partner API | If you're a New Relic partnership organization, you can use the Partner API to retrieve data and make configurations. |
Other APIs
For more help
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 and and documentation.