Migrate from the Splunk Ruby agent to the OpenTelemetry instrumentation for Ruby

Learn how to migrate from the deprecated Splunk Distribution of OpenTelemetry Ruby to the upstream OpenTelemetry instrumentation for Ruby.

The Splunk Distribution of OpenTelemetry Ruby has been deprecated as of March 15, 2024, and will reach end of support on March 15, 2025. Use this guide to learn how to migrate from the Splunk Ruby agent to the upstream OpenTelemetry instrumentation for Ruby.

Compatibility and requirements

Make sure that you have the correct requirements for the OpenTelemetry Ruby instrumentation. See OpenTelemetry Ruby compatibility and requirements.

Migrate to the OpenTelemetry instrumentation for Ruby

To migrate from the Splunk instrumentation for Ruby to the OpenTelemetry instrumentation for Ruby, follow these steps:

  1. Uninstall the Splunk Ruby agent.

  2. Install and activate the OpenTelemetry instrumentation for Ruby. See Instrument your Ruby application for Splunk Observability Cloud.

  3. Restart the server and application.

Uninstall the Splunk Ruby agent

If you’ve installed the Splunk Ruby agent, uninstall it using the following command:

gem uninstall splunk-otel