Telemetry SDKs: send custom telemetry data to New Relic

The Telemetry SDKs are an open source set of API client libraries that send your metric and trace data to the New Relic platform.

We offer several open-source integrations (Prometheus, Istio, OpenCensus, and more) that make use of the Telemetry SDKs to send data, but if those solutions (or our Infrastructure integrations) aren't a good fit for you, you can use the Telemetry SDKs to create your own open-source data-reporting solutions.

Requirements and compatibility

All you need is an Event API insert key. If you are using a Telemetry SDK to write open source libraries, you don't even need to install the APM agent to use the SDK.

New Relic has contributed the Telemetry SDK to the open source community under an Apache 2.0 license.

Available libraries

The New Relic Telemetry SDKs are open source software on Github. Use the language-specific GitHub links below to get library details, coding examples, and procedures for how to use the SDKs. We currently support the following libraries, with more to be created in the future:

Language Library Description
Java Java library on GitHub Currently supports New Relic Metrics and New Relic Traces.
Python Python library on GitHub Currently supports New Relic Metrics and New Relic Traces.
Go Go library on Github Currently supports New Relic Metrics and New Relic Traces.

Write your own Telemetry SDK or contribute to an existing Telemetry SDK

If you need a telemetry SDK in a language that does not currently exist or want to contribute to an existing library, please reference the Telemetry SDK Specs.

Integrations built with the Telemetry SDK

The following are integrations and exporters that send data from popular monitoring services to New Relic. These solutions are built with our Telemetry SDK.

Exporter Source Additional information
DropWizard DropWizard integration on GitHub DropWizard specs
Istio Istio integration on GitHub
OpenCensus Go, Python OpenCensus specs
Micrometer Micrometer integration on GitHub Micrometer specs
Prometheus Prometheus integration on GitHub For Kubernetes | For Docker

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.