Trace context for propagation across service boundaries. More...

#include <distributed_tracer.h>

Collaboration diagram for kcenon::monitoring::trace_context:

Public Member Functions
std::string	to_w3c_traceparent () const
	Serialize to W3C Trace Context format.

Static Public Member Functions
static common::Result< trace_context >	from_w3c_traceparent (const std::string &header)
	Parse from W3C Trace Context format.

Public Attributes
std::string	trace_id

std::string	span_id

std::string	trace_flags

std::string	trace_state

std::unordered_map< std::string, std::string >	baggage

Detailed Description

Trace context for propagation across service boundaries.

Examples: multi_service_tracing_example.cpp.

Definition at line 95 of file distributed_tracer.h.

Member Function Documentation

◆ from_w3c_traceparent()

static common::Result< trace_context > kcenon::monitoring::trace_context::from_w3c_traceparent ( const std::string & header )

inlinestatic

Parse from W3C Trace Context format.

Definition at line 113 of file distributed_tracer.h.

                                                                                     {
        // Parse format: version-traceid-spanid-traceflags
        if (header.length() < 55) {  // Minimum valid length
            error_info err(kcenon::monitoring::monitoring_error_code::invalid_argument,
                          "Invalid traceparent header length");
            return common::Result<trace_context>::err(err.to_common_error());
        }
 
        trace_context ctx;
        // Simple parsing - production code would be more robust
        size_t pos = 0;
        size_t dash1 = header.find('-', pos);
        size_t dash2 = header.find('-', dash1 + 1);
        size_t dash3 = header.find('-', dash2 + 1);
 
        if (dash1 == std::string::npos || dash2 == std::string::npos || dash3 == std::string::npos) {
            error_info err(kcenon::monitoring::monitoring_error_code::invalid_argument,
                          "Invalid traceparent header format");
            return common::Result<trace_context>::err(err.to_common_error());
        }
 
        ctx.trace_id = header.substr(dash1 + 1, dash2 - dash1 - 1);
        ctx.span_id = header.substr(dash2 + 1, dash3 - dash2 - 1);
        ctx.trace_flags = header.substr(dash3 + 1);
 
        return common::ok(ctx);
    }

References kcenon::monitoring::invalid_argument, span_id, kcenon::monitoring::error_info::to_common_error(), trace_flags, and trace_id.

Referenced by kcenon::monitoring::distributed_tracer::extract_context_from_carrier(), and TEST_F().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ to_w3c_traceparent()

std::string kcenon::monitoring::trace_context::to_w3c_traceparent ( ) const

inline

Serialize to W3C Trace Context format.

Examples: multi_service_tracing_example.cpp.

Definition at line 105 of file distributed_tracer.h.

                                         {
        // Version-TraceId-SpanId-TraceFlags
        return "00-" + trace_id + "-" + span_id + "-" + trace_flags;
    }