open-telemetry/extension-propagator-cloudtrace

CloudTraceContext propagator extension for OpenTelemetry PHP.

0.0.3 2023-12-24 23:31 UTC

Requires

• php: ^7.4 || ^8.0
• open-telemetry/api: ^1.0
• open-telemetry/context: ^1.0

Apache-2.0

• opentelemetry-php contributors

• extension
• apm
• tracing
• opentelemetry
• otel
• propagator
• cloudtrace

README

OpenTelemetry Extension

CloudTrace Propagator

CloudTrace is a propagator that supports the specification for the header "x-cloud-trace-context" used for trace context propagation across service boundaries. (https://cloud.google.com/trace/docs/setup#force-trace). OpenTelemetry PHP CloudTrace Propagator Extension provides option to use it bi-directionally or one-way. One-way does not inject the header for downstream consumption, it only processes the incoming headers and returns the correct span context. It only attaches to existing X-Cloud-Trace-Context traces and does not create downstream ones.

For one-way CloudTrace:

CloudTracePropagator::getOneWayInstance()

For bi-directional CloudTrace:

CloudTracePropagator::getInstance()

Contributing

This repository is a read-only git subtree split. To contribute, please see the main OpenTelemetry PHP monorepo.