Docs » Splunk Observability Cloud でサポートされているインテグレーション » バックエンドアプリケーションをインストルメンテーションして、スパンを Splunk APM に送信する » Splunk Observability Cloud (OpenTelemetry) 用に Ruby アプリケーションをインストルメンテーションする » Splunk Observability Cloud に Ruby アプリケーションをインストルメンテーションする » SignalFx Tracing Library for Ruby からの移行

SignalFx Tracing Library for Ruby からの移行 🔗

SignalFx Ruby トレース・ライブラリは非推奨であり、2023年9月30日にサポート終了となります。Splunk Distribution of OpenTelemetry Ruby のエージェントに置き換えてください。

Splunk Distribution of OpenTelemetry Ruby は、OpenTelemetry API を使用するオープンソースプロジェクトである OpenTelemetry Instrumentation for Ruby に基づいています。

Splunk Ruby OTel エージェントへの移行方法については、以下の説明をお読みください。

互換性と要件 🔗

Splunk Distribution of OpenTelemetry Ruby には Ruby 2.5 以上が必要です。OpenTelemetry Ruby の互換性と要件 を参照してください。

Splunk Distribution of OpenTelemetry Ruby への移行 🔗

SignalFx Tracing Library for Ruby から Splunk Distribution of OpenTelemetry Ruby へ移行するには、以下の手順に従ってください：

  1. トレース・ライブラリパッケージを削除します。SignalFx Tracing Library for Ruby の削除 を参照してください。

  2. Splunk Distribution of OpenTelemetry Ruby をデプロイします。Splunk Ruby エージェントをデプロイする を参照してください。

  3. 既存の構成を移行します。Splunk Ruby OTel エージェントの設定を移行する を参照してください。

注釈

スパン名と属性の意味上の規約は、マイグレーションの際に変更されます。詳しくは、SignalFx Smart Agent から Splunk Distribution of OpenTelemetry Collector への移行 を参照してください。

SignalFx Tracing Library for Ruby の削除 🔗

以下の手順に従って、トレース・ライブラリとその依存関係を削除してください：

  1. signalfx をアンインストールします：

    gem uninstall signalfx

  2. Gemfileから signalfx を削除します。

  3. 追加でインストールした OpenTracing のインストルメンテーション・パッケージをすべて削除します。

Splunk Ruby エージェントをデプロイする 🔗

Splunk Distribution of OpenTelemetry Ruby をインストールするには、Splunk Observability Cloud に Ruby アプリケーションをインストルメンテーションする を参照してください。

Splunk Ruby OTel エージェントの設定を移行する 🔗

SignalFx トレース・ライブラリから Splunk Distribution of OpenTelemetry Ruby に設定を移行するには、以下の環境変数の名前を変更します：

SignalFx 環境変数

OpenTelemetry環境変数

SIGNALFX_ACCESS_TOKEN

SPLUNK_ACCESS_TOKEN

SIGNALFX_SERVICE_NAME

OTEL_SERVICE_NAME

SIGNALFX_ENDPOINT_URL

OTEL_EXPORTER_JAEGER_ENDPOINT または OTEL_EXPORTER_OTLP_ENDPOINT

SIGNALFX_RECORDED_VALUE_MAX_LENGTH

SPLUNK_MAX_ATTR_LENGTH

Splunk Ruby OTel 設定の詳細については、Splunk Observability Cloud 用の Ruby エージェントを設定する を参照してください。

ログ・インジェクションの変更 🔗

トレースメタデータをログ文に注入するには、Ruby のトレースデータを Splunk Observability Cloud のログに接続する を参照してください。

This page was last updated on 2024年03月01日.