ottlspan

README

___# Span Context

The Span Context is a Context implementation for pdata Spans, the collector's internal representation for OTLP span data. This Context should be used when interacted with OTLP spans.

Paths

In general, the Span Context supports accessing pdata using the field names from the traces proto. All integers are returned and set via int64. All doubles are returned and set via float64.

All TraceIDs and SpanIDs are returned as pdata SpanID and TraceID types. Use the SpanID function and TraceID function when interacting with pdata representations of SpanID and TraceID. When checking for nil, instead check against an empty byte slice (SpanID(0x0000000000000000) and TraceID(0x00000000000000000000000000000000)).

The following fields are the exception.

path	field accessed	type
resource	resource of the span being processed	pcommon.Resource
resource.attributes	resource attributes of the span being processed	pcommon.Map
resource.attributes[""]	the value of the resource attribute of the span being processed	string, bool, int64, float64, pcommon.Map, pcommon.Slice, []byte or nil
resource.dropped_attributes_count	number of dropped attributes of the resource of the span being processed	int64
instrumentation_scope	instrumentation scope of the span being processed	pcommon.InstrumentationScope
instrumentation_scope.name	name of the instrumentation scope of the span being processed	string
instrumentation_scope.version	version of the instrumentation scope of the span being processed	string
instrumentation_scope.dropped_attributes_count	number of dropped attributes of the instrumentation scope of the span being processed	int64
instrumentation_scope.attributes	instrumentation scope attributes of the span being processed	pcommon.Map
instrumentation_scope.attributes[""]	the value of the instrumentation scope attribute of the span being processed	string, bool, int64, float64, pcommon.Map, pcommon.Slice, []byte or nil
attributes	attributes of the span being processed	pcommon.Map
attributes[""]	the value of the attribute of the span being processed	string, bool, int64, float64, pcommon.Map, pcommon.Slice, []byte or nil
trace_id	a byte slice representation of the trace id	pcommon.TraceID
trace_id.string	a string representation of the trace id	string
span_id	a byte slice representation of the span id	pcommon.SpanID
span_id.string	a string representation of the span id	string
parent_span_id	a byte slice representation of the parent span id	pcommon.SpanID
parent_span_id.string	a string representation of the parent span id	string
trace_state[""]	an individual entry in the trace state	string
status.code	the status code of the span being processed	int64
status.message	the status message of the span being processed	string

Enums

The Span Context supports the enum names from the traces proto.

Documentation

Index

• func NewParser(functions map[string]interface{}, ...) ottl.Parser[TransformContext]
• type TransformContext
  • func NewTransformContext(span ptrace.Span, instrumentationScope pcommon.InstrumentationScope, ...) TransformContext
  • func (tCtx TransformContext) GetInstrumentationScope() pcommon.InstrumentationScope
  • func (tCtx TransformContext) GetResource() pcommon.Resource
  • func (tCtx TransformContext) GetSpan() ptrace.Span

Functions

func NewParser

func NewParser(functions map[string]interface{}, telemetrySettings component.TelemetrySettings) ottl.Parser[TransformContext]

Types

type TransformContext

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

func NewTransformContext

func NewTransformContext(span ptrace.Span, instrumentationScope pcommon.InstrumentationScope, resource pcommon.Resource) TransformContext

func (TransformContext) GetInstrumentationScope

func (tCtx TransformContext) GetInstrumentationScope() pcommon.InstrumentationScope

func (TransformContext) GetResource

func (tCtx TransformContext) GetResource() pcommon.Resource

func (TransformContext) GetSpan

func (tCtx TransformContext) GetSpan() ptrace.Span