PHPackages open-telemetry/opentelemetry-propagation-instana - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. open-telemetry/opentelemetry-propagation-instana ActiveLibrary[Logging & Monitoring](/categories/logging) open-telemetry/opentelemetry-propagation-instana ================================================ OpenTelemetry Instana propagator. 0.1.0(12mo ago)0112.7k↓11.8%Apache-2.0PHPPHP ^8.1 Since May 22Pushed 12mo ago5 watchersCompare [ Source](https://github.com/opentelemetry-php/contrib-propagator-instana)[ Packagist](https://packagist.org/packages/open-telemetry/opentelemetry-propagation-instana)[ RSS](/packages/open-telemetry-opentelemetry-propagation-instana/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (14)Versions (2)Used By (0) [![Releases](https://camo.githubusercontent.com/46e38a504120203bf7615645011bcf2bb834e03e8eb0bc8e0f4864c729fd5baf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f72656c65617365732d707572706c65)](https://github.com/opentelemetry-php/contrib-propagator-instana/releases)[![Issues](https://camo.githubusercontent.com/b9b31135f113cdb6e2b662b4040276044ee0803567bc17688eaf4386f797ea50/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6973737565732d70696e6b)](https://github.com/open-telemetry/opentelemetry-php/issues)[![Source](https://camo.githubusercontent.com/e27dd1126a60abf1c26521d893d9f235ef342a76231c2428ddbc4651185bd626/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f736f757263652d636f6e747269622d677265656e)](https://github.com/open-telemetry/opentelemetry-php-contrib/tree/main/src/Propagation/Instana)[![Mirror](https://camo.githubusercontent.com/2f9050293ab0c0d9471e618215bc7417a63b6873c960e1605bddb69b1911fa4c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d6972726f722d6f70656e74656c656d657472792d2d7068702d2d636f6e747269622d626c7565)](https://github.com/opentelemetry-php/contrib-propagator-instana)[![Latest Version](https://camo.githubusercontent.com/c8696c1dcd6a2271024bc7301004e27eff0966676bba2ccaede452385d4d0cb5/687474703a2f2f706f7365722e707567782e6f72672f6f70656e2d74656c656d657472792f6f70656e74656c656d657472792d70726f7061676174696f6e2d696e7374616e612f762f756e737461626c65)](https://packagist.org/packages/open-telemetry/opentelemetry-propagation-instana/)[![Stable](https://camo.githubusercontent.com/a6de7594233523d294d6fd6cb3c1ba2dbc6504863d9d96e0e84313c15b2cd613/687474703a2f2f706f7365722e707567782e6f72672f6f70656e2d74656c656d657472792f6f70656e74656c656d657472792d70726f7061676174696f6e2d696e7374616e612f762f737461626c65)](https://packagist.org/packages/open-telemetry/opentelemetry-propagation-instana/) This is a read-only subtree split of . OpenTelemetry Instana Propagator ================================ [](#opentelemetry-instana-propagator) The OpenTelemetry Propagator for Instana provides HTTP header propagation and Baggage propagation for systems that are using IBM Observability by Instana. This propagator translates the Instana trace correlation headers (`X-INSTANA-T/X-INSTANA-S/X-INSTANA-L`) into the OpenTelemetry `SpanContext`, and vice versa. It does not handle `TraceState`. Installation ------------ [](#installation) ``` composer require open-telemetry/opentelemetry-propagation-instana ``` Usage ----- [](#usage) ``` $propagator = InstanaPropagator::getInstance(); ``` Both of the above have extract and inject methods available to extract and inject respectively into the header. For Baggage propagation, use opentelemetry's MultiTextMapPropagator, and pass the array list of propagators i.e Instana and Baggage propagator as below. ``` $propagator = new MultiTextMapPropagator([InstanaPropagator::getInstance(), BaggagePropagator::getInstance()]); ``` Propagator Details ------------------ [](#propagator-details) There are three headers that the propagator handles: `X-INSTANA-T` (the trace ID), `X-INSTANA-S` (the parent span ID), and `X-INSTANA-L` (the sampling level). Example header triplet: - `X-INSTANA-T: 80f198ee56343ba864fe8b2a57d3eff7`, - `X-INSTANA-S: e457b5a2e4d86bd1`, - `X-INSTANA-L: 1`. A short summary for each of the headers is provided below. More details are available at . ### X-INSTANA-T -- trace ID [](#x-instana-t----trace-id) - A string of either 16 or 32 characters from the alphabet `0-9a-f`, representing either a 64 bit or 128 bit ID. - This header corresponds to the [OpenTelemetry TraceId](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/overview.md#spancontext). - If the propagator receives an X-INSTANA-T header value that is shorter than 32 characters when *extracting* headers into the OpenTelemetry span context, it will left-pad the string with the character "0" to length 32. - No length transformation is applied when *injecting* the span context into headers. ### X-INSTANA-S -- parent span ID [](#x-instana-s----parent-span-id) - Format: A string of 16 characters from the alphabet `0-9a-f`, representing a 64 bit ID. - This header corresponds to the [OpenTelemetry SpanId](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/overview.md#spancontext). ### X-INSTANA-L - sampling level [](#x-instana-l---sampling-level) - The only two valid values are `1` and `0`. - A level of `1` means that this request is to be sampled, a level of `0` means that the request should not be sampled. - This header corresponds to the sampling bit of the [OpenTelemetry TraceFlags](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/overview.md#spancontext). Useful links ------------ [](#useful-links) - For more information on Instana, visit and [Instana' documentation](https://www.ibm.com/docs/en/obi/current). - For more information on OpenTelemetry, visit: Installing dependencies and executing tests ------------------------------------------- [](#installing-dependencies-and-executing-tests) From Instana subdirectory: ``` $ composer install $ ./vendor/bin/phpunit tests ``` ### Health Score 34 — LowBetter than 77% of packages Maintenance50 Moderate activity, may be stable Popularity32 Limited adoption so far Community10 Small or concentrated contributor base Maturity35 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 361d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/4978962?v=4)[Brett McBride](/maintainers/brettmc)[@brettmc](https://github.com/brettmc) ![](https://avatars.githubusercontent.com/u/4099109?v=4)[Bob Strecansky](/maintainers/bobstrecansky)[@bobstrecansky](https://github.com/bobstrecansky) --- Top Contributors [![HeenaBansal20](https://avatars.githubusercontent.com/u/139580694?v=4)](https://github.com/HeenaBansal20 "HeenaBansal20 (3 commits)") --- Tags opentelemetryotelopen-telemetrypropagatorinstana ### Code Quality TestsPHPUnit Static AnalysisPHPStan, Psalm Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/open-telemetry-opentelemetry-propagation-instana/health.svg) ``` [![Health](https://phpackages.com/badges/open-telemetry-opentelemetry-propagation-instana/health.svg)](https://phpackages.com/packages/open-telemetry-opentelemetry-propagation-instana) ``` ### Alternatives [open-telemetry/sdk SDK for OpenTelemetry PHP. 2322.9M248](/packages/open-telemetry-sdk)[open-telemetry/opentelemetry-auto-symfony OpenTelemetry auto-instrumentation for Symfony 551.2M1](/packages/open-telemetry-opentelemetry-auto-symfony)[open-telemetry/opentelemetry-auto-pdo OpenTelemetry auto-instrumentation for PDO 111.2M1](/packages/open-telemetry-opentelemetry-auto-pdo)[open-telemetry/opentelemetry-auto-wordpress OpenTelemetry auto-instrumentation for Wordpress 17166.0k](/packages/open-telemetry-opentelemetry-auto-wordpress) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)