Download the PHP package open-telemetry/opentelemetry-propagation-instana without Composer
On this page you can find all versions of the php package open-telemetry/opentelemetry-propagation-instana. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download open-telemetry/opentelemetry-propagation-instana
More information about open-telemetry/opentelemetry-propagation-instana
Files in open-telemetry/opentelemetry-propagation-instana
Package opentelemetry-propagation-instana
Short Description OpenTelemetry Instana propagator.
License Apache-2.0
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package opentelemetry-propagation-instana
This is a read-only subtree split of https://github.com/open-telemetry/opentelemetry-php-contrib.
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
Usage
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 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 https://www.ibm.com/docs/en/obi/current?topic=monitoring-traces#tracing-headers.
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.
- 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
- Format: A string of 16 characters from the alphabet
0-9a-f, representing a 64 bit ID. - This header corresponds to the OpenTelemetry SpanId.
X-INSTANA-L - sampling level
- The only two valid values are
1and0. - A level of
1means that this request is to be sampled, a level of0means that the request should not be sampled. - This header corresponds to the sampling bit of the OpenTelemetry TraceFlags.
Useful links
- For more information on Instana, visit https://www.instana.com/ and Instana' documentation.
- For more information on OpenTelemetry, visit: https://opentelemetry.io/
Installing dependencies and executing tests
From Instana subdirectory:
