NAME

OpenTelemetry::Propagator::TraceContext - Propagate context using the W3C TraceContext format

SYNOPSIS

use OpenTelemetry::Trace;
use OpenTelemetry::Propagator::TraceContext;

my $propagator = OpenTelemetry::Propagator::TraceContext;

# Inject TraceContext data from the context to a carrier
my $carrier = {};
$propagator->inject( $carrier, $context );

# Extract TraceContext data from a carrier to the context
my $new_context = $propagator->extract( $carrier, $context );

# The TraceContext data will be in the span in the context
my $span = OpenTelemetry::Trace->span_from_context($new_context);

DESCRIPTION

This package defines a propagator class that can interact with the context (which can be either an implicit or explicit instance of OpenTelemetry::Context) and inject or extract data using the W3C TraceContext format.

It implements the propagator interface defined in OpenTelemetry::Propagator.

METHODS

inject

$propagator = $propagator->inject(
    $carrier,
    $context // OpenTelemetry::Context->current,
    $setter  // OpenTelemetry::Propagator::TextMap::SETTER,
)

extract

$new_context = $propagator->extract(
    $carrier,
    $context // OpenTelemetry::Context->current,
    $getter  // OpenTelemetry::Propagator::TextMap::GETTER,
)

keys

@keys = $propagator->keys

SEE ALSO

OpenTelemetry::Context

OpenTelemetry::Propagator

W3C TraceContext format

OpenTelemetry::TraceContext::W3C

A different distribution written to deal with W3C's tracecontext data, earlier than this distribution or its related OpenTelemetry::SDK

COPYRIGHT AND LICENSE

This software is copyright (c) 2023 by José Joaquín Atria.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.