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

SignalFx Tracing Library for Pythonからの移行 🔗

SignalFx Tracing Library for Python は非推奨となり、2022年12月17日にサポート終了となります。Splunk Distribution of OpenTelemetry Python のエージェントに置き換えてください。

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

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

互換性と要件 🔗

Splunk Distribution of OpenTelemetry Python には Python 3.7 以上が必要です。Pythonエージェントの互換性と要件 を参照してください。

Splunk Distribution of OpenTelemetry Python への移行 🔗

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

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

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

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

  4. Pythonサービスまたはアプリケーションを起動します。マイグレーション完了後、Pythonアプリケーションを起動します。 を参照してください。

注釈

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

SignalFx Tracing Library for Pythonの削除 🔗

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

  1. signalfx-tracing をアンインストールします:

    pip uninstall signalfx-tracing
    
  2. requirements.txtまたはpyproject.tomlファイルから signalfx-tracing を削除します。

  3. パッケージ・マネージャーが signalfx-tracing の依存関係をすべて削除していない場合は、手動で削除してください:

    pip uninstall opentracing
    pip uninstall jaeger-client
    
  4. sfx-py-trace-bootstrap コマンドでインストールされたすべてのインストルメンテーション・パッケージを削除します。

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

Djangoアプリケーションの追加手順 🔗

Splunk Distribution of OpenTelemetry Python では、INSTALLED_APPS に何も追加する必要はありません。

以下の手順に従って、Django の設定を更新してください:

  1. settings.py の INSTALLED_APPS から signalfx_tracing を削除します。

  2. 環境変数 DJANGO_SETTINGS_MODULE に manage.py または wsgi.py と同じ値を設定します。

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

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

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

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

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 Python OTel 設定の詳細については、Splunk Observability Cloud 用の Python エージェントを設定する を参照してください。

マイグレーション完了後、Pythonアプリケーションを起動します。 🔗

splunk-py-trace を使用して、Pythonアプリケーションまたはサービスを実行します。例えば、python main.py を使ってサービスを実行する場合、splunk-py-trace python main.py を使って実行することで、自動的にインストルメンテーションを行うことができます。詳細については、Python アプリケーションを Splunk Observability Cloud にインストルメンテーションする を参照してください。

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

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

This page was last updated on 2023年04月24日.