Migrate from the SignalFx Tracing Library for Ruby 🔗
The SignalFx Ruby tracing library is deprecated and will reach End of Support on September 30th, 2023. Replace it with the agent from the Splunk Distribution of OpenTelemetry Ruby.
The agent of the Splunk Distribution of OpenTelemetry Ruby is based on the OpenTelemetry Instrumentation for Ruby, an open-source project that uses the OpenTelemetry API.
Read the following instructions to learn how to migrate to the Splunk Ruby OTel agent.
Compatibility and requirements 🔗
The Splunk Distribution of OpenTelemetry Ruby requires Ruby 2.5 and higher. See OpenTelemetry Ruby compatibility and requirements.
Migrate to the Splunk Distribution of OpenTelemetry Ruby 🔗
To migrate from the SignalFx Tracing Library for Ruby to the Splunk Distribution of OpenTelemetry Ruby, follow these steps:
Remove the tracing library packages. See Remove the SignalFx Tracing Library for Ruby.
Deploy the Splunk Distribution of OpenTelemetry Ruby. See Deploy the Splunk Ruby agent.
Migrate your existing configuration. See Migrate settings for the Splunk Ruby OTel agent.
Note
Semantic conventions for span names and attributes change when you migrate. For more information, see Migrate from SignalFx Smart Agent to the Splunk Distribution of OpenTelemetry Collector.
Remove the SignalFx Tracing Library for Ruby 🔗
Follow these steps to remove the tracing library and its dependencies:
Uninstall
signalfx
:gem uninstall signalfx
Remove
signalfx
from your Gemfile.Remove any additional OpenTracing instrumentation packages you installed.
Deploy the Splunk Ruby agent 🔗
To install the Splunk Distribution of OpenTelemetry Ruby, see Instrument your Ruby application for Splunk Observability Cloud.
Migrate settings for the Splunk Ruby OTel agent 🔗
To migrate settings from the SignalFx tracing library to the Splunk Distribution of OpenTelemetry Ruby, rename the following environment variables:
SignalFx environment variable |
OpenTelemetry environment variable |
---|---|
|
|
|
|
|
|
|
|
For more information about Splunk Ruby OTel settings, see Configure the Ruby agent for Splunk Observability Cloud.
Log injection changes 🔗
To inject tracing metadata into log statements, see Connect Ruby trace data with logs for Splunk Observability Cloud.