Star us on GitHub
Star
Menu

Using highlight.io with Other Ruby Frameworks

Learn how to set up highlight.io on your non-Rails Ruby backend.
1
Add `tracingOrigins` to your client Highlight snippet.

This backend SDK requires one of the Highlight frontend SDKs to be installed, so please make sure you've followed the fullstack mapping guide first.

H.init("<YOUR_PROJECT_ID>", { tracingOrigins: ['localhost', 'example.myapp.com/backend'], networkRecording: { enabled: true, recordHeadersAndBody: true, }, });
Copy
2
Install the Highlight Ruby SDK.

Add Highlight to your Gemfile and install with Bundler.

gem "highlight_io" bundle install
Copy
3
Initialize the Highlight Ruby SDK.

Highlight::H.new initializes the SDK and allows you to call the singleton Highlight::H.instance. Setting your project id also lets Highlight record errors for background tasks and processes that aren't associated with a frontend session.

require "highlight" Highlight::H.new("<YOUR_PROJECT_ID>", environment: "production") do |c| c.service_name = "my-app" c.service_version = "1.0.0" end
Copy
4
Add Highlight tracing.

trace will automatically record raised exceptions and send them to Highlight.

require "highlight" Highlight::H.instance.trace(nil, nil) do # your code here end
Copy
5
Verify your errors are being recorded.

Now that you've set up the Middleware, verify that the backend error handling works by consuming an error from traced code.

6
Record custom errors. (optional)

If you want to explicitly send an error to Highlight, you can use the record_exception method within traced code.

Highlight::H.instance.record_exception(e)
Copy
7
Set up logging.

Start sending logs to Highlight! Follow the logging setup guide to get started.