Docs » Supported integrations in Splunk Observability Cloud » Instrument back-end applications to send spans to Splunk APM » Instrument PHP applications for Splunk Observability Cloud » Migrate from the SignalFx Tracing Library for PHP

Migrate from the SignalFx Tracing Library for PHP 🔗

The OpenTelemetry instrumentation for PHP is the alternative to the deprecated SignalFx Tracing Library for PHP. To migrate from the SignalFx instrumentation, follow these instructions.

Compatibility and requirements 🔗

For a complete list of requirements, see OpenTelemetry PHP instrumentation compatibility and requirements.

Migrate to the OpenTelemetry instrumentation for PHP 🔗

To migrate from the SignalFx Tracing Library for PHP to the OpenTelemetry instrumentation for PHP, follow these steps:

  1. Uninstall the SignalFx Tracing Library for PHP. See Uninstall the SignalFx Tracing Library for PHP.

  2. Install and activate the OpenTelemetry instrumentation for PHP. See Install the Splunk Distribution of OpenTelemetry PHP manually.

  3. Update your settings. See Configuration setting changes.

  4. Restart the server and application.

Uninstall the SignalFx Tracing Library for PHP 🔗

  1. To uninstall the SignalFx Tracing Library for PHP, run the following command:

php signalfx-setup.php --uninstall

  1. Make sure that your INI file doesn’t contain references to signalfx-tracing.so and that the extension file is removed.

  2. Optionally, delete the /opt/signalfx/signalfx-library directory.

Configuration setting changes 🔗

The following table shows SignalFx Tracing Library for PHP environment variables and their OpenTelemetry equivalents:

SignalFx environment variable

OpenTelemetry environment variable

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

Handled by the Splunk Collector

SIGNALFX_REALM

Handled by the Splunk Collector

SIGNALFX_ENDPOINT_URL

OTEL_EXPORTER_OTLP_TRACES_ENDPOINT

SIGNALFX_METRICS_ENDPOINT_URL

OTEL_EXPORTER_OTLP_ENDPOINT