/newrelic-exporter-specs

A repository of design guidelines and implementation details for implementing exporters for open instrumentation systems

Apache License 2.0Apache-2.0

New Relic Exporter Specifications

Purpose

With this documentation, we intend to document our general principles, and specific implementations of what we generally call "Exporters". By this, we mean libraries or tools that extract data from existing telemetry systems, convert the data into a New Relic-friendly format, and send them to New Relic. In general, the implementations of these exporters will rely on our open-source SDKs to do the work of sending the data to New Relic.

Intent

This documentation is divided into two sections, with two different intents. Documentation at the top level of this project is generally intended to be prescriptive. If you are designing an exporter, we strongly recommend following the Guidelines.md, as it will support interoperability between the metrics exported from various metric libraries. The documentation in the subdirectories, of the specific exporters, however, are intended to be purely descriptive. They should reflect exactly what the current version of the exporter actually does, even if it doesn't exactly follow the guidelines.

Organization

See the Guidelines.md for general principles on how to build exporters and provide adequate information so that they will be able to be queried by NRQL and visualizations can be created.

Each subdirectory contains a specification for how the relevant exporter functions.

OpenCensus

Cross-language specifications for how we extract data from OpenCensus can be found in the opencensus directory.

DropWizard metrics

The detailed description of how the New Relic DropWizard Reporter converts DropWizard metrics into New Relic dimensional metrics can be found in the dropwizard directory.

Micrometer

The detailed description of how the New Relic Micrometer Registry converts Micrometer metrics into New Relic dimensional metrics can be found in the micrometer directory.

Contributing

Full details are available in CONTRIBUTING.md.

Licensing

License details are in LICENSE.md..