etrace

README

trace

opentrace: https://github.com/opentracing-contrib/opentracing-specification-zh/blob/master/semantic_conventions.md opentelemetry: https://github.com/open-telemetry/opentelemetry-specification/tree/main/specification/trace/semantic_conventions tracecontext: https://www.w3.org/TR/trace-context/ nginx otel:https://github.com/open-telemetry/opentelemetry-cpp-contrib/tree/main/instrumentation/nginx

Documentation

Index

• Variables
• func CompatibleExtractGrpcTraceID(header metadata.MD)
• func CompatibleExtractHTTPTraceID(header http.Header)
• func CompatibleParse(traceID string) string
• func CustomTag(key string, val string) attribute.KeyValue
• func ExtractTraceID(ctx context.Context) string
• func IsGlobalTracerRegistered() bool
• func SetGlobalTracer(tp trace.TracerProvider)
• func TagComponent(component string) attribute.KeyValue
• func TagSpanKind(kind string) attribute.KeyValue
• func TagSpanURL(url string) attribute.KeyValue
• type Option
• type Tracer
  • func NewTracer(kind trace.SpanKind, opts ...Option) *Tracer
  • func (t *Tracer) Start(ctx context.Context, operation string, carrier propagation.TextMapCarrier) (context.Context, trace.Span)

Variables

var (
	// String ...
	String = attribute.String
)

Functions

func CompatibleExtractGrpcTraceID

func CompatibleExtractGrpcTraceID(header metadata.MD)

CompatibleExtractGrpcTraceID ... Deprecated 该方法会在v0.9.0移除

func CompatibleExtractHTTPTraceID

func CompatibleExtractHTTPTraceID(header http.Header)

CompatibleExtractHTTPTraceID ... Deprecated 该方法会在v0.9.0移除

func CompatibleParse

func CompatibleParse(traceID string) string

CompatibleParse ... opentrace: 18af9db18a77f4b7:18af9db18a77f4b7:0000000000000000:0 opentelemetry: 00-18af9db18a77f4b718af9db18a77f4b7-18af9db18a77f4b7-00 https://www.w3.org/TR/trace-context/

func CustomTag

func CustomTag(key string, val string) attribute.KeyValue

CustomTag ...

func ExtractTraceID

func ExtractTraceID(ctx context.Context) string

ExtractTraceID HTTP使用request.Context，不要使用错了

func IsGlobalTracerRegistered

func IsGlobalTracerRegistered() bool

IsGlobalTracerRegistered returns a `bool` to indicate if a tracer has been globally registered

func SetGlobalTracer

func SetGlobalTracer(tp trace.TracerProvider)

SetGlobalTracer ...

func TagComponent

func TagComponent(component string) attribute.KeyValue

TagComponent ...

func TagSpanKind

func TagSpanKind(kind string) attribute.KeyValue

TagSpanKind ...

func TagSpanURL

func TagSpanURL(url string) attribute.KeyValue

TagSpanURL ...

Types

type Option

type Option func(*options)

Option is tracing option.

type Tracer

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

Tracer is otel span tracer

func NewTracer

func NewTracer(kind trace.SpanKind, opts ...Option) *Tracer

NewTracer create tracer instance

func (*Tracer) Start

func (t *Tracer) Start(ctx context.Context, operation string, carrier propagation.TextMapCarrier) (context.Context, trace.Span)

Start start tracing span