New Relic Ruby Telemetry SDK

The New Relic Ruby Telemetry SDK is an easy way to send data to New Relic. The SDK currently supports sending span/trace data via New Relic's Trace API.

Why is this cool?

Send data to New Relic! No agent required.

Our Telemetry SDK makes it easier for you to send your telemetry data to New Relic. We've covered all of the basics for you so you can focus on writing feature code directly related to your business need or interest.

Installation

With Bundler

For using with Bundler, add the New Relic Telemetry SDK gem to your project's Gemfile.

gem 'newrelic-telemetry_sdk'

and run bundle install to activate the new gem.

Without Bundler

If you are not using Bundler, install the gem with:

gem install newrelic-telemetry_sdk

and then require the New Relic Ruby Telemetry SDK in your Ruby start-up sequence:

require 'newrelic-telemetry_sdk'

Getting Started

Sending your first span

The example code assumes you've set the following environment variables:

NEW_RELIC_INSERT_KEY

NewRelic::TelemetrySdk.configure do |config|
   config.api_insert_key = ENV["NEW_RELIC_INSERT_KEY"]
end

span = NewRelic::TelemetrySdk::Span.new
sleep 1
span.finish
client = NewRelic::TelemetrySdk::TraceClient.new
client.report span

For more detailed examples please see our examples directory.

Testing

Running the test suite is simple. Just invoke:

bundle
bundle exec rake

Support

New Relic hosts and moderates an online forum where customers can interact with New Relic employees as well as other customers to get help and share best practices. Like all official New Relic open source projects, there's a related Community topic in the New Relic Explorers Hub. You can find this project's topic/threads here:

https://discuss.newrelic.com/t/new-relic-telemetry-sdk-for-ruby/114266

Contributing

We encourage your contributions to improve newrelic-telemetry-sdk-ruby! Keep in mind when you submit your pull request, you'll need to sign the CLA via the click-through using CLA-Assistant. You only have to sign the CLA one time per project. If you have any questions, or to execute our corporate CLA, required if your contribution is on behalf of a company, please drop us an email at [email protected].

License

newrelic-telemetry-sdk-ruby is licensed under the Apache 2.0 License.

Find and use data

Tips on how to find and query your data in New Relic:

For general querying information, see:

Limitations

The New Relic Telemetry APIs are rate limited. Please reference the documentation for New Relic Metrics API and New Relic Trace API requirements and limits on the specifics of the rate limits.