A long-lived project that still receives updates
Instrument your Ruby apps with Honeycomb
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

>= 2.3.0
 Project Readme

Honeycomb Beeline for Ruby

OSS Lifecycle Build Status Gem Version

⚠️Note: Beelines are Honeycomb's legacy instrumentation libraries. We embrace OpenTelemetry as the effective way to instrument applications. For any new observability efforts, we recommend instrumenting with OpenTelemetry.

This package makes it easy to instrument your Ruby web app to send useful events to Honeycomb, a service for debugging your software in production.

Sign up for a Honeycomb trial to obtain an API key before starting.

Compatible with

Requires Ruby version 2.5 or later

Built in instrumentation for:

  • Active Support
  • AWS (v2 and v3)
  • Faraday
  • Rack
  • Rails (tested on versions 4.1 and up)
  • Redis (tested on versions 3.x and 4.x)
  • Sequel
  • Sinatra

Testing

Find rspec test files in the spec directory.

To run tests on gem-specific instrumentations or across various dependency versions, use appraisal (further instructions in the readme for that gem). Find gem sets in the Appraisals config.

To run a specific file: bundle exec appraisal <gem set> rspec <path/to/file>

Get in touch

Please reach out to support@honeycomb.io or ping us with the chat bubble on our website for any assistance. We also welcome bug reports.

Contributions

Features, bug fixes and other changes to beeline-ruby are gladly accepted. Please open issues or a pull request with your change. Remember to add your name to the CONTRIBUTORS file!

All contributions will be released under the Apache License 2.0.