headers

Documentation

Index

• Constants
• func CopyAll(outReq *http.Request, req *http.Request)
• func CopyAllSecure(outReq *http.Request, req *http.Request)
• func EnsureRootSpan(ctx context.Context, operationName string) (context.Context, trace.Span)
• func ExtractTraceContext(req *http.Request) context.Context
• func InjectTraceHeaders(ctx context.Context, req *http.Request, format string)
• func ParseTraceparent(traceparent string) (traceID, spanID string, sampled bool, err error)
• func SetProxyHeaders(outReq *http.Request, req *http.Request)
• type TraceInfo
  • func GetTraceInfo(ctx context.Context) TraceInfo

Constants

const (
	TraceFormatOTEL    = "otel"
	TraceFormatDatadog = "datadog"
	TraceFormatBoth    = "both"
)

Trace format constants

const (
	TraceparentHeader = "traceparent"
	TracestateHeader  = "tracestate"
)

W3C Trace Context headers

const (
	DatadogTraceIDHeader          = "x-datadog-trace-id"
	DatadogParentIDHeader         = "x-datadog-parent-id"
	DatadogSamplingPriorityHeader = "x-datadog-sampling-priority"
	DatadogOriginHeader           = "x-datadog-origin"
)

Datadog trace headers

Functions

func CopyAll

func CopyAll(outReq *http.Request, req *http.Request)

func CopyAllSecure

func CopyAllSecure(outReq *http.Request, req *http.Request)

func EnsureRootSpan

func EnsureRootSpan(ctx context.Context, operationName string) (context.Context, trace.Span)

EnsureRootSpan creates a root span if none exists in the context Returns the context with span and the span itself

func ExtractTraceContext

func ExtractTraceContext(req *http.Request) context.Context

ExtractTraceContext extracts trace context from incoming request headers Supports both W3C traceparent and Datadog headers

func InjectTraceHeaders

func InjectTraceHeaders(ctx context.Context, req *http.Request, format string)

InjectTraceHeaders injects trace headers into outgoing request based on format

func ParseTraceparent

func ParseTraceparent(traceparent string) (traceID, spanID string, sampled bool, err error)

ParseTraceparent parses a W3C traceparent header value

func SetProxyHeaders

func SetProxyHeaders(outReq *http.Request, req *http.Request)

Types

type TraceInfo

type TraceInfo struct {
	TraceID       string // 128-bit hex (OTEL format)
	SpanID        string // 64-bit hex (OTEL format)
	DDTraceID     string // 64-bit decimal (Datadog format - lower 64 bits of trace ID)
	DDSpanID      string // 64-bit decimal (Datadog format)
	Sampled       bool
	HasValidTrace bool
}

TraceInfo contains extracted trace information

func GetTraceInfo

func GetTraceInfo(ctx context.Context) TraceInfo

GetTraceInfo extracts trace information from context in both formats