gtrace

Documentation

Overview

Package gtrace provides convenience wrapping functionality for tracing feature using OpenTelemetry.

Index

• func CheckSetDefaultTextMapPropagator()
• func CommonLabels() []attribute.KeyValue
• func GetBaggageMap(ctx context.Context) *gmap.StrAnyMap
• func GetBaggageVar(ctx context.Context, key string) *gvar.Var
• func GetDefaultTextMapPropagator() propagation.TextMapPropagator
• func GetSpanId(ctx context.Context) string
• func GetTraceId(ctx context.Context) string
• func IsActivated(ctx context.Context) bool
• func IsTracingInternal() bool
• func MaxContentLogSize() int
• func SetBaggageMap(ctx context.Context, data map[string]interface{}) context.Context
• func SetBaggageValue(ctx context.Context, key string, value interface{}) context.Context
• type Baggage
  • func NewBaggage(ctx context.Context) *Baggage
  • func (b *Baggage) Ctx() context.Context
  • func (b *Baggage) GetMap() *gmap.StrAnyMap
  • func (b *Baggage) GetVar(key string) *gvar.Var
  • func (b *Baggage) SetMap(data map[string]interface{}) context.Context
  • func (b *Baggage) SetValue(key string, value interface{}) context.Context
• type Carrier
  • func NewCarrier(data ...map[string]interface{}) Carrier
  • func (c Carrier) Get(k string) string
  • func (c Carrier) Keys() []string
  • func (c Carrier) MustMarshal() []byte
  • func (c Carrier) Set(k, v string)
  • func (c Carrier) String() string
  • func (c Carrier) UnmarshalJSON(b []byte) error
• type Span
  • func NewSpan(ctx context.Context, spanName string, opts ...trace.SpanStartOption) (context.Context, *Span)
• type Tracer
  • func NewTracer(name ...string) *Tracer

Functions

func CheckSetDefaultTextMapPropagator

func CheckSetDefaultTextMapPropagator()

CheckSetDefaultTextMapPropagator sets the default TextMapPropagator if it is not set previously.

func CommonLabels

func CommonLabels() []attribute.KeyValue

CommonLabels returns common used attribute labels: ip.intranet, hostname.

func GetBaggageMap

func GetBaggageMap(ctx context.Context) *gmap.StrAnyMap

GetBaggageMap retrieves and returns the baggage values as map.

func GetBaggageVar

func GetBaggageVar(ctx context.Context, key string) *gvar.Var

GetBaggageVar retrieves value and returns a *gvar.Var for specified key from baggage.

func GetDefaultTextMapPropagator

func GetDefaultTextMapPropagator() propagation.TextMapPropagator

GetDefaultTextMapPropagator returns the default propagator for context propagation between peers.

func GetSpanId

func GetSpanId(ctx context.Context) string

GetSpanId retrieves and returns SpanId from context. It returns an empty string is tracing feature is not activated.

func GetTraceId

func GetTraceId(ctx context.Context) string

GetTraceId retrieves and returns TraceId from context. It returns an empty string is tracing feature is not activated.

func IsActivated

func IsActivated(ctx context.Context) bool

IsActivated checks and returns if tracing feature is activated.

func IsTracingInternal

func IsTracingInternal() bool

IsTracingInternal returns whether tracing spans of internal components.

func MaxContentLogSize

func MaxContentLogSize() int

MaxContentLogSize returns the max log size for request and response body, especially for HTTP/RPC request.

func SetBaggageMap

func SetBaggageMap(ctx context.Context, data map[string]interface{}) context.Context

SetBaggageMap is a convenient function for adding map key-value pairs to baggage. Note that it uses attribute.Any to set the key-value pair.

func SetBaggageValue

func SetBaggageValue(ctx context.Context, key string, value interface{}) context.Context

SetBaggageValue is a convenient function for adding one key-value pair to baggage. Note that it uses attribute.Any to set the key-value pair.

Types

type Baggage

type Baggage struct {
	// contains filtered or unexported fields
}

Baggage holds the data through all tracing spans.

func NewBaggage

func NewBaggage(ctx context.Context) *Baggage

NewBaggage creates and returns a new Baggage object from given tracing context.

func (*Baggage) Ctx

func (b *Baggage) Ctx() context.Context

Ctx returns the context that Baggage holds.

func (*Baggage) GetMap

func (b *Baggage) GetMap() *gmap.StrAnyMap

GetMap retrieves and returns the baggage values as map.

func (*Baggage) GetVar

func (b *Baggage) GetVar(key string) *gvar.Var

GetVar retrieves value and returns a *gvar.Var for specified key from baggage.

func (*Baggage) SetMap

func (b *Baggage) SetMap(data map[string]interface{}) context.Context

SetMap is a convenient function for adding map key-value pairs to baggage. Note that it uses attribute.Any to set the key-value pair.

func (*Baggage) SetValue

func (b *Baggage) SetValue(key string, value interface{}) context.Context

SetValue is a convenient function for adding one key-value pair to baggage. Note that it uses attribute.Any to set the key-value pair.

type Carrier

type Carrier map[string]interface{}

Carrier is the storage medium used by a TextMapPropagator.

func NewCarrier

func NewCarrier(data ...map[string]interface{}) Carrier

func (Carrier) Get

func (c Carrier) Get(k string) string

Get returns the value associated with the passed key.

func (Carrier) Keys

func (c Carrier) Keys() []string

Keys lists the keys stored in this carrier.

func (Carrier) MustMarshal

func (c Carrier) MustMarshal() []byte

func (Carrier) Set

func (c Carrier) Set(k, v string)

Set stores the key-value pair.

func (Carrier) String

func (c Carrier) String() string

func (Carrier) UnmarshalJSON

func (c Carrier) UnmarshalJSON(b []byte) error

type Span

type Span struct {
	trace.Span
}

func NewSpan

func NewSpan(ctx context.Context, spanName string, opts ...trace.SpanStartOption) (context.Context, *Span)

NewSpan creates a span using default tracer.

type Tracer

type Tracer struct {
	trace.Tracer
}

func NewTracer

func NewTracer(name ...string) *Tracer

Tracer is a short function for retrieving Tracer.