ottlspanevent

README

Span Event Context

The Span Event Context is a Context implementation for pdata SpanEvents, the Collector's internal representation for OTLP Span Event data. This Context should be used when interacting with individual OTLP Span Events.

Paths

In general, the Span Event 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.

The following paths are supported.

path	field accessed	type
cache	the value of the current transform context's temporary cache. cache can be used as a temporary placeholder for data during complex transformations	pcommon.Map
cache[""]	the value of an item in cache. Supports multiple indexes to access nested fields.	string, bool, int64, float64, pcommon.Map, pcommon.Slice, []byte or nil
resource	resource of the span event being processed	pcommon.Resource
resource.attributes	resource attributes of the span event being processed	pcommon.Map
resource.attributes[""]	the value of the resource attribute of the span event being processed. Supports multiple indexes to access nested fields.	string, bool, int64, float64, pcommon.Map, pcommon.Slice, []byte or nil
instrumentation_scope	instrumentation scope of the span event being processed	pcommon.InstrumentationScope
instrumentation_scope.name	name of the instrumentation scope of the span event being processed	string
instrumentation_scope.version	version of the instrumentation scope of the span event being processed	string
instrumentation_scope.attributes	instrumentation scope attributes of the span event being processed	pcommon.Map
instrumentation_scope.attributes[""]	the value of the instrumentation scope attribute of the span event being processed. Supports multiple indexes to access nested fields.	string, bool, int64, float64, pcommon.Map, pcommon.Slice, []byte or nil
span	span of the span event being processed	ptrace.Span
span.*	All fields exposed by the ottlspan context can accessed via span.	varies
attributes	attributes of the span event being processed	pcommon.Map
attributes[""]	the value of the attribute of the span event being processed. Supports multiple indexes to access nested fields.	string, bool, int64, float64, pcommon.Map, pcommon.Slice, []byte or nil
time_unix_nano	time_unix_nano of the span event being processed	int64
time	time of the span event being processed	time.Time
name	name of the span event being processed	string
dropped_attributes_count	dropped_attributes_count of the span event being processed	int64

Enums

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

Enum Symbol	Value
SPAN_KIND_UNSPECIFIED	0
SPAN_KIND_INTERNAL	1
SPAN_KIND_SERVER	2
SPAN_KIND_CLIENT	3
SPAN_KIND_PRODUCER	4
SPAN_KIND_CONSUMER	5
STATUS_CODE_UNSET	0
STATUS_CODE_OK	1
STATUS_CODE_ERROR	2

Documentation

Index

• func NewConditionSequence(conditions []*ottl.Condition[TransformContext], ...) ottl.ConditionSequence[TransformContext]
• func NewParser(functions map[string]ottl.Factory[TransformContext], ...) (ottl.Parser[TransformContext], error)
• func NewStatementSequence(statements []*ottl.Statement[TransformContext], ...) ottl.StatementSequence[TransformContext]
• type ConditionSequenceOption
  • func WithConditionSequenceErrorMode(errorMode ottl.ErrorMode) ConditionSequenceOption
• type Option
• type StatementSequenceOption
  • func WithStatementSequenceErrorMode(errorMode ottl.ErrorMode) StatementSequenceOption
• type TransformContext
  • func NewTransformContext(spanEvent ptrace.SpanEvent, span ptrace.Span, ...) TransformContext
  • func (tCtx TransformContext) GetInstrumentationScope() pcommon.InstrumentationScope
  • func (tCtx TransformContext) GetResource() pcommon.Resource
  • func (tCtx TransformContext) GetSpan() ptrace.Span
  • func (tCtx TransformContext) GetSpanEvent() ptrace.SpanEvent

Functions

func NewConditionSequence

func NewConditionSequence(conditions []*ottl.Condition[TransformContext], telemetrySettings component.TelemetrySettings, options ...ConditionSequenceOption) ottl.ConditionSequence[TransformContext]

func NewParser

func NewParser(functions map[string]ottl.Factory[TransformContext], telemetrySettings component.TelemetrySettings, options ...Option) (ottl.Parser[TransformContext], error)

func NewStatementSequence

func NewStatementSequence(statements []*ottl.Statement[TransformContext], telemetrySettings component.TelemetrySettings, options ...StatementSequenceOption) ottl.StatementSequence[TransformContext]

Types

type ConditionSequenceOption

type ConditionSequenceOption func(*ottl.ConditionSequence[TransformContext])

func WithConditionSequenceErrorMode

func WithConditionSequenceErrorMode(errorMode ottl.ErrorMode) ConditionSequenceOption

type Option

type Option func(*ottl.Parser[TransformContext])

type StatementSequenceOption

type StatementSequenceOption func(*ottl.StatementSequence[TransformContext])

func WithStatementSequenceErrorMode

func WithStatementSequenceErrorMode(errorMode ottl.ErrorMode) StatementSequenceOption

type TransformContext

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

func NewTransformContext

func NewTransformContext(spanEvent ptrace.SpanEvent, 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

func (TransformContext) GetSpanEvent

func (tCtx TransformContext) GetSpanEvent() ptrace.SpanEvent