OpenTelemetry context for trace correlation. More...

#include <otel_context.h>

Collaboration diagram for kcenon::logger::otlp::otel_context:

Public Member Functions
bool	is_valid () const noexcept
	Check if context is valid.

bool	is_sampled () const noexcept
	Check if trace is sampled.

Static Public Member Functions
static otel_context	empty () noexcept
	Create an empty/invalid context.

Public Attributes
std::string	trace_id

std::string	span_id

std::string	trace_flags

std::string	trace_state

Static Private Member Functions
static bool	is_valid_hex (const std::string &str) noexcept

Detailed Description

OpenTelemetry context for trace correlation.

Contains trace identification and propagation information following the W3C Trace Context specification.

Definition at line 45 of file otel_context.h.

Member Function Documentation

◆ empty()

static otel_context kcenon::logger::otlp::otel_context::empty ( )

inlinestaticnodiscardnoexcept

Create an empty/invalid context.

Returns: Empty otel_context

Examples: /home/runner/work/logger_system/logger_system/include/kcenon/logger/otlp/otel_context.h.

Definition at line 120 of file otel_context.h.

                                                       {
        return otel_context{};
    }

◆ is_sampled()

bool kcenon::logger::otlp::otel_context::is_sampled ( ) const

inlinenodiscardnoexcept

Check if trace is sampled.

Returns: true if the sampled flag (bit 0) is set

Examples: /home/runner/work/logger_system/logger_system/include/kcenon/logger/otlp/otel_context.h.

Definition at line 103 of file otel_context.h.

                                                   {
        if (trace_flags.empty()) {
            return false;
        }
        // Check if the last character is '1', '3', '5', '7', '9', 'b', 'd', 'f'
        // (odd numbers in hex, meaning bit 0 is set)
        char last = trace_flags.back();
        return (last == '1' || last == '3' || last == '5' || last == '7' ||
                last == '9' || last == 'b' || last == 'd' || last == 'f' ||
                last == 'B' || last == 'D' || last == 'F');
    }

References trace_flags.

◆ is_valid()

bool kcenon::logger::otlp::otel_context::is_valid ( ) const

inlinenodiscardnoexcept

Check if context is valid.

Returns: true if trace_id and span_id are present and properly formatted

Examples: /home/runner/work/logger_system/logger_system/include/kcenon/logger/otlp/otel_context.h.

Definition at line 93 of file otel_context.h.

                                                 {
        return trace_id.length() == 32 && span_id.length() == 16 &&
               is_valid_hex(trace_id) && is_valid_hex(span_id);
    }

References is_valid_hex(), span_id, and trace_id.

Here is the call graph for this function:

◆ is_valid_hex()

static bool kcenon::logger::otlp::otel_context::is_valid_hex ( const std::string & str )

inlinestaticnodiscardprivatenoexcept

Examples: /home/runner/work/logger_system/logger_system/include/kcenon/logger/otlp/otel_context.h.

Definition at line 125 of file otel_context.h.

                                                                          {
        for (char c : str) {
            if (!((c >= '0' && c <= '9') ||
                  (c >= 'a' && c <= 'f') ||
                  (c >= 'A' && c <= 'F'))) {
                return false;
            }
        }
        return true;
    }