SignalFx Tracing Library for PHP からの移行

PHP 用 OpenTelemetry インストルメンテーションは、非推奨の SignalFx Tracing Library for PHP に代わるものです。SignalFx インストルメンテーションから移行するには、次の手順に従います。

PHP 用 OpenTelemetry インストルメンテーションは、非推奨の SignalFx Tracing Library for PHP に代わるものです。SignalFx インストルメンテーションから移行するには、次の手順に従います。

互換性と要件

要件の完全なリストについては、「OpenTelemetry PHP インストルメンテーションの互換性と要件」を参照してください。

PHP 用 OpenTelemetry インストルメンテーションに移行する

SignalFx Tracing Library for PHP から PHP 用 OpenTelemetry インストルメンテーションへの移行は、以下の手順で行います:

  1. SignalFx Tracing Library for PHP をアンインストールします。「Uninstall the SignalFx Tracing Library for PHP」を参照してください。

  2. PHP 用 OpenTelemetry インストルメンテーションをインストールし、有効化します。「Splunk Distribution of OpenTelemetry PHP を手動でインストールする」を参照してください。

  3. 設定を更新してください。「コンフィギュレーション設定の変更」を参照してください。

  4. サーバーとアプリケーションを再起動します。

SignalFx Tracing Library for PHP をアンインストールします。

  1. SignalFx Tracing Library for PHP をアンインストールするには、次のコマンドを実行します:php signalfx-setup.php --uninstall

  2. INIファイルに signalfx-tracing.so への参照が含まれていないことと、エクステンションファイルが削除されていることを確認してください。

  3. オプションで、/opt/signalfx/signalfx-library ディレクトリを削除します。

コンフィギュレーション設定の変更

以下の表は、SignalFx Tracing Library for PHP の環境変数と、それに相当する OpenTelemetry を示しています:

SignalFx 環境変数

OpenTelemetry環境変数

SIGNALFX_SERVICE_NAME

OTEL_SERVICE_NAME=<service_name>

SIGNALFX_ENV

OTEL_RESOURCE_ATTRIBUTES=deployment.environment=<environment_name>

SIGNALFX_VERSION

OTEL_RESOURCE_ATTRIBUTES=version=<version>

SIGNALFX_GLOBAL_TAGS

OTEL_RESOURCE_ATTRIBUTES

SIGNALFX_ACCESS_TOKEN

Splunk Collector で処理

SIGNALFX_REALM

Splunk Collector で処理

SIGNALFX_ENDPOINT_URL

OTEL_EXPORTER_OTLP_TRACES_ENDPOINT

SIGNALFX_METRICS_ENDPOINT_URL

OTEL_EXPORTER_OTLP_ENDPOINT