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 に移行するには、以下の手順に従ってください:
トレース・ライブラリパッケージを削除します。SignalFx Tracing Library for Pythonの削除 を参照してください。
Splunk Distribution of OpenTelemetry Python をデプロイします。Splunk Python エージェントをデプロイする を参照してください。
既存の構成を移行します。Splunk Python OTel エージェントの設定を移行する を参照してください。
Pythonサービスまたはアプリケーションを起動します。マイグレーション完了後、Pythonアプリケーションを起動します。 を参照してください。
注釈
スパン名と属性の意味上の規約は、マイグレーションの際に変更されます。詳しくは、SignalFx Smart Agent から Splunk Distribution of OpenTelemetry Collector への移行 を参照してください。
SignalFx Tracing Library for Pythonの削除 🔗
以下の手順に従って、トレース・ライブラリとその依存関係を削除してください:
signalfx-tracing
をアンインストールします:pip uninstall signalfx-tracing
requirements.txtまたはpyproject.tomlファイルから
signalfx-tracing
を削除します。パッケージ・マネージャーが
signalfx-tracing
の依存関係をすべて削除していない場合は、手動で削除してください:pip uninstall opentracing pip uninstall jaeger-client
sfx-py-trace-bootstrap
コマンドでインストールされたすべてのインストルメンテーション・パッケージを削除します。追加でインストールした OpenTracing のインストルメンテーション・パッケージをすべて削除します。
Djangoアプリケーションの追加手順 🔗
Splunk Distribution of OpenTelemetry Python では、INSTALLED_APPS
に何も追加する必要はありません。
以下の手順に従って、Django の設定を更新してください:
settings.py の
INSTALLED_APPS
からsignalfx_tracing
を削除します。環境変数
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環境変数 |
---|---|
|
|
|
|
|
|
|
|
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 のログに接続する を参照してください。