Summary

• Adds propagator: xray and propagator: w3c+xray config options that swap the global TextMapPropagator for AWS X-Ray's X-Amzn-Trace-Id header format (or both headers simultaneously for gradual migrations)
• Adds id_generator: xray that builds a TracerProvider using the SDK's env-var auto-configuration factories plus XRayIdGenerator, producing epoch-prefixed trace IDs that X-Ray's UI renders as timestamps
• Both options require open-telemetry/contrib-aws (added to suggest); the bundle throws a clear LogicException at container boot if the package is absent

How it works

A new XRayBootstrapper service registers a Globals::registerInitializer callback in its constructor, then subscribes to kernel.request and console.command at PHP_INT_MAX priority. This forces Symfony to construct the service — and therefore queue the initializer — before OpenTelemetrySubscriber (priority 256) or ConsoleSubscriber (priority 128) call Globals::tracerProvider() for the first time. All existing instrumentation (HTTP, HttpClient, Messenger, Doctrine, etc.) picks up the X-Ray propagator and ID generator automatically because every subscriber goes through Globals::propagator() and Globals::tracerProvider().

Usage

composer require open-telemetry/contrib-aws

# config/packages/open_telemetry.yaml
open_telemetry:
  propagator: xray       # inject/extract X-Amzn-Trace-Id headers
  id_generator: xray     # epoch-prefixed trace IDs recognised by X-Ray UI

Point OTEL_EXPORTER_OTLP_ENDPOINT at your ADOT Collector as usual — the exporter is configured from env vars the same way as before.

Tests

All 560 existing tests pass. 28 new tests are added across three files:

• ConfigurationTest — valid/invalid values for both new config keys, correct defaults
• BundleBootTest — default config registers no bootstrapper; missing package throws LogicException at boot; all three propagator modes and id_generator: xray register XRayBootstrapper
• XRayBootstrapperTest — propagator injection produces X-Amzn-Trace-Id headers; extraction parses incoming X-Ray headers into the correct span context; id_generator: xray produces 32-char hex trace IDs whose first 8 chars decode to a plausible Unix timestamp

The XRayBootstrapperTest cases currently skip (they are marked with markTestSkipped when open-telemetry/contrib-aws is absent from dev deps). Adding the package to require-dev in CI will make them live.

Closes #7

🤖 Generated with Claude Code