pdata

package
Version: v0.37.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 13, 2021 License: Apache-2.0 Imports: 17 Imported by: 115

Documentation

Overview

Package pdata (pipeline data) implements data structures that represent telemetry data in-memory. All data received is converted into this format, travels through the pipeline in this format, and is converted from this format by exporters when sending.

Current implementation primarily uses OTLP ProtoBuf structs as the underlying data structures for many of of the declared structs. We keep a pointer to OTLP protobuf in the "orig" member field. This allows efficient translation to/from OTLP wire protocol. Note that the underlying data structure is kept private so that we are free to make changes to it in the future.

Most of the internal data structures must be created via New* functions. Zero-initialized structures, in most cases, are not valid (read comments for each struct to know if that is the case). This is a slight deviation from idiomatic Go to avoid unnecessary pointer checks in dozens of functions which assume the invariant that "orig" member is non-nil. Several structures also provide New*Slice functions that allow creating more than one instance of the struct more efficiently instead of calling New* repeatedly. Use it where appropriate.

This package also provides common ways for decoding serialized bytes into protocol-specific in-memory data models (e.g. Zipkin Span). These data models can then be translated to pdata representations. Similarly, pdata types can be translated from a data model which can then be serialized into bytes.

* Encoding: Common interfaces for serializing/deserializing bytes from/to protocol-specific data models. * Translation: Common interfaces for translating protocol-specific data models from/to pdata types. * Marshaling: Common higher level APIs that do both encoding and translation of bytes and data model if going directly pdata types to bytes.

Index

Constants

View Source
const (
	SeverityNumberUNDEFINED = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_UNSPECIFIED)
	SeverityNumberTRACE     = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_TRACE)
	SeverityNumberTRACE2    = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_TRACE2)
	SeverityNumberTRACE3    = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_TRACE3)
	SeverityNumberTRACE4    = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_TRACE4)
	SeverityNumberDEBUG     = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_DEBUG)
	SeverityNumberDEBUG2    = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_DEBUG2)
	SeverityNumberDEBUG3    = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_DEBUG3)
	SeverityNumberDEBUG4    = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_DEBUG4)
	SeverityNumberINFO      = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_INFO)
	SeverityNumberINFO2     = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_INFO2)
	SeverityNumberINFO3     = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_INFO3)
	SeverityNumberINFO4     = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_INFO4)
	SeverityNumberWARN      = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_WARN)
	SeverityNumberWARN2     = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_WARN2)
	SeverityNumberWARN3     = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_WARN3)
	SeverityNumberWARN4     = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_WARN4)
	SeverityNumberERROR     = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_ERROR)
	SeverityNumberERROR2    = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_ERROR2)
	SeverityNumberERROR3    = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_ERROR3)
	SeverityNumberERROR4    = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_ERROR4)
	SeverityNumberFATAL     = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_FATAL)
	SeverityNumberFATAL2    = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_FATAL2)
	SeverityNumberFATAL3    = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_FATAL3)
	SeverityNumberFATAL4    = SeverityNumber(otlplogs.SeverityNumber_SEVERITY_NUMBER_FATAL4)
)
View Source
const (
	// MetricAggregationTemporalityUnspecified is the default MetricAggregationTemporality, it MUST NOT be used.
	MetricAggregationTemporalityUnspecified = MetricAggregationTemporality(otlpmetrics.AggregationTemporality_AGGREGATION_TEMPORALITY_UNSPECIFIED)
	// MetricAggregationTemporalityDelta is a MetricAggregationTemporality for a metric aggregator which reports changes since last report time.
	MetricAggregationTemporalityDelta = MetricAggregationTemporality(otlpmetrics.AggregationTemporality_AGGREGATION_TEMPORALITY_DELTA)
	// MetricAggregationTemporalityCumulative is a MetricAggregationTemporality for a metric aggregator which reports changes since a fixed start time.
	MetricAggregationTemporalityCumulative = MetricAggregationTemporality(otlpmetrics.AggregationTemporality_AGGREGATION_TEMPORALITY_CUMULATIVE)
)
View Source
const (
	// SpanKindUnspecified represents that the SpanKind is unspecified, it MUST NOT be used.
	SpanKindUnspecified = SpanKind(otlptrace.Span_SPAN_KIND_UNSPECIFIED)
	// SpanKindInternal indicates that the span represents an internal operation within an application,
	// as opposed to an operation happening at the boundaries. Default value.
	SpanKindInternal = SpanKind(otlptrace.Span_SPAN_KIND_INTERNAL)
	// SpanKindServer indicates that the span covers server-side handling of an RPC or other
	// remote network request.
	SpanKindServer = SpanKind(otlptrace.Span_SPAN_KIND_SERVER)
	// SpanKindClient indicates that the span describes a request to some remote service.
	SpanKindClient = SpanKind(otlptrace.Span_SPAN_KIND_CLIENT)
	// SpanKindProducer indicates that the span describes a producer sending a message to a broker.
	// Unlike CLIENT and SERVER, there is often no direct critical path latency relationship
	// between producer and consumer spans.
	// A PRODUCER span ends when the message was accepted by the broker while the logical processing of
	// the message might span a much longer time.
	SpanKindProducer = SpanKind(otlptrace.Span_SPAN_KIND_PRODUCER)
	// SpanKindConsumer indicates that the span describes consumer receiving a message from a broker.
	// Like the PRODUCER kind, there is often no direct critical path latency relationship between
	// producer and consumer spans.
	SpanKindConsumer = SpanKind(otlptrace.Span_SPAN_KIND_CONSUMER)
)
View Source
const (
	// MetricDataPointFlagsNoRecordedValue is flag for a metric aggregator which reports changes since last report time.
	MetricDataPointFlagNoRecordedValue = MetricDataPointFlag(otlpmetrics.DataPointFlags_FLAG_NO_RECORDED_VALUE)
)
View Source
const (
	// MetricDataPointFlagsNone is the default MetricDataPointFlags.
	MetricDataPointFlagsNone = MetricDataPointFlags(otlpmetrics.DataPointFlags_FLAG_NONE)
)

Variables

This section is empty.

Functions

This section is empty.

Types

type AnyValueArray

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

AnyValueArray logically represents a slice of AttributeValue.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewAnyValueArray function to create new instances. Important: zero-initialized instance is not valid for use.

func NewAnyValueArray

func NewAnyValueArray() AnyValueArray

NewAnyValueArray creates a AnyValueArray with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (AnyValueArray) AppendEmpty

func (es AnyValueArray) AppendEmpty() AttributeValue

AppendEmpty will append to the end of the slice an empty AttributeValue. It returns the newly added AttributeValue.

func (AnyValueArray) At

func (es AnyValueArray) At(ix int) AttributeValue

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (AnyValueArray) CopyTo

func (es AnyValueArray) CopyTo(dest AnyValueArray)

CopyTo copies all elements from the current slice to the dest.

func (AnyValueArray) EnsureCapacity

func (es AnyValueArray) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new AnyValueArray can be initialized:

es := NewAnyValueArray()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (AnyValueArray) Len

func (es AnyValueArray) Len() int

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewAnyValueArray()".

func (AnyValueArray) MoveAndAppendTo

func (es AnyValueArray) MoveAndAppendTo(dest AnyValueArray)

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (AnyValueArray) RemoveIf

func (es AnyValueArray) RemoveIf(f func(AttributeValue) bool)

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

type AttributeMap

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

AttributeMap stores a map of attribute keys to values.

func NewAttributeMap

func NewAttributeMap() AttributeMap

NewAttributeMap creates a AttributeMap with 0 elements.

func NewAttributeMapFromMap added in v0.34.0

func NewAttributeMapFromMap(attrMap map[string]AttributeValue) AttributeMap

NewAttributeMapFromMap creates a AttributeMap with values from the given map[string]AttributeValue.

func (AttributeMap) AsRaw added in v0.35.0

func (am AttributeMap) AsRaw() map[string]interface{}

AsRaw converts an OTLP AttributeMap to a standard go map

func (AttributeMap) Clear

func (am AttributeMap) Clear()

Clear erases any existing entries in this AttributeMap instance.

func (AttributeMap) CopyTo

func (am AttributeMap) CopyTo(dest AttributeMap)

CopyTo copies all elements from the current map to the dest.

func (AttributeMap) Delete

func (am AttributeMap) Delete(key string) bool

Delete deletes the entry associated with the key and returns true if the key was present in the map, otherwise returns false.

func (AttributeMap) EnsureCapacity

func (am AttributeMap) EnsureCapacity(capacity int)

EnsureCapacity increases the capacity of this AttributeMap instance, if necessary, to ensure that it can hold at least the number of elements specified by the capacity argument.

func (AttributeMap) Get

func (am AttributeMap) Get(key string) (AttributeValue, bool)

Get returns the AttributeValue associated with the key and true. Returned AttributeValue is not a copy, it is a reference to the value stored in this map. It is allowed to modify the returned value using AttributeValue.Set* functions. Such modification will be applied to the value stored in this map.

If the key does not exist returns an invalid instance of the KeyValue and false. Calling any functions on the returned invalid instance will cause a panic.

func (AttributeMap) InitFromMap deprecated

This method has been deprecated.
func (am AttributeMap) InitFromMap(attrMap map[string]AttributeValue) AttributeMap

InitFromMap overwrites the entire AttributeMap and reconstructs the AttributeMap with values from the given map[string]AttributeValue.

Returns the same instance to allow nicer code like:

assert.EqualValues(t, NewAttributeMap().InitFromMap(map[string]AttributeValue{...}), actual)

Deprecated: use NewAttributeMapFromMap instead.

func (AttributeMap) Insert

func (am AttributeMap) Insert(k string, v AttributeValue)

Insert adds the AttributeValue to the map when the key does not exist. No action is applied to the map where the key already exists.

Calling this function with a zero-initialized AttributeValue struct will cause a panic.

Important: this function should not be used if the caller has access to the raw value to avoid an extra allocation.

func (AttributeMap) InsertBool

func (am AttributeMap) InsertBool(k string, v bool)

InsertBool adds the bool Value to the map when the key does not exist. No action is applied to the map where the key already exists.

func (AttributeMap) InsertBytes added in v0.32.0

func (am AttributeMap) InsertBytes(k string, v []byte)

InsertBytes adds the []byte Value to the map when the key does not exist. No action is applied to the map where the key already exists. The caller must ensure the []byte passed in is not modified after the call is made, sharing the data across multiple attributes is forbidden.

func (AttributeMap) InsertDouble

func (am AttributeMap) InsertDouble(k string, v float64)

InsertDouble adds the double Value to the map when the key does not exist. No action is applied to the map where the key already exists.

func (AttributeMap) InsertInt

func (am AttributeMap) InsertInt(k string, v int64)

InsertInt adds the int Value to the map when the key does not exist. No action is applied to the map where the key already exists.

func (AttributeMap) InsertNull

func (am AttributeMap) InsertNull(k string)

InsertNull adds a null Value to the map when the key does not exist. No action is applied to the map where the key already exists.

func (AttributeMap) InsertString

func (am AttributeMap) InsertString(k string, v string)

InsertString adds the string Value to the map when the key does not exist. No action is applied to the map where the key already exists.

func (AttributeMap) Len

func (am AttributeMap) Len() int

Len returns the length of this map.

Because the AttributeMap is represented internally by a slice of pointers, and the data are comping from the wire, it is possible that when iterating using "Range" to get access to fewer elements because nil elements are skipped.

func (AttributeMap) Range

func (am AttributeMap) Range(f func(k string, v AttributeValue) bool)

Range calls f sequentially for each key and value present in the map. If f returns false, range stops the iteration.

Example:

sm.Range(func(k string, v AttributeValue) bool {
    ...
})

func (AttributeMap) Sort

func (am AttributeMap) Sort() AttributeMap

Sort sorts the entries in the AttributeMap so two instances can be compared. Returns the same instance to allow nicer code like:

assert.EqualValues(t, expected.Sort(), actual.Sort())

func (AttributeMap) Update

func (am AttributeMap) Update(k string, v AttributeValue)

Update updates an existing AttributeValue with a value. No action is applied to the map where the key does not exist.

Calling this function with a zero-initialized AttributeValue struct will cause a panic.

Important: this function should not be used if the caller has access to the raw value to avoid an extra allocation.

func (AttributeMap) UpdateBool

func (am AttributeMap) UpdateBool(k string, v bool)

UpdateBool updates an existing bool Value with a value. No action is applied to the map where the key does not exist.

func (AttributeMap) UpdateBytes added in v0.32.0

func (am AttributeMap) UpdateBytes(k string, v []byte)

UpdateBytes updates an existing []byte Value with a value. No action is applied to the map where the key does not exist. The caller must ensure the []byte passed in is not modified after the call is made, sharing the data across multiple attributes is forbidden.

func (AttributeMap) UpdateDouble

func (am AttributeMap) UpdateDouble(k string, v float64)

UpdateDouble updates an existing double Value with a value. No action is applied to the map where the key does not exist.

func (AttributeMap) UpdateInt

func (am AttributeMap) UpdateInt(k string, v int64)

UpdateInt updates an existing int Value with a value. No action is applied to the map where the key does not exist.

func (AttributeMap) UpdateString

func (am AttributeMap) UpdateString(k string, v string)

UpdateString updates an existing string Value with a value. No action is applied to the map where the key does not exist.

func (AttributeMap) Upsert

func (am AttributeMap) Upsert(k string, v AttributeValue)

Upsert performs the Insert or Update action. The AttributeValue is inserted to the map that did not originally have the key. The key/value is updated to the map where the key already existed.

Calling this function with a zero-initialized AttributeValue struct will cause a panic.

Important: this function should not be used if the caller has access to the raw value to avoid an extra allocation.

func (AttributeMap) UpsertBool

func (am AttributeMap) UpsertBool(k string, v bool)

UpsertBool performs the Insert or Update action. The bool Value is inserted to the map that did not originally have the key. The key/value is updated to the map where the key already existed.

func (AttributeMap) UpsertBytes added in v0.32.0

func (am AttributeMap) UpsertBytes(k string, v []byte)

UpsertBytes performs the Insert or Update action. The []byte Value is inserted to the map that did not originally have the key. The key/value is updated to the map where the key already existed. The caller must ensure the []byte passed in is not modified after the call is made, sharing the data across multiple attributes is forbidden.

func (AttributeMap) UpsertDouble

func (am AttributeMap) UpsertDouble(k string, v float64)

UpsertDouble performs the Insert or Update action. The double Value is inserted to the map that did not originally have the key. The key/value is updated to the map where the key already existed.

func (AttributeMap) UpsertInt

func (am AttributeMap) UpsertInt(k string, v int64)

UpsertInt performs the Insert or Update action. The int Value is inserted to the map that did not originally have the key. The key/value is updated to the map where the key already existed.

func (AttributeMap) UpsertString

func (am AttributeMap) UpsertString(k string, v string)

UpsertString performs the Insert or Update action. The AttributeValue is inserted to the map that did not originally have the key. The key/value is updated to the map where the key already existed.

type AttributeValue

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

AttributeValue is a mutable cell containing the value of an attribute. Typically used in AttributeMap. Must use one of NewAttributeValue+ functions below to create new instances.

Intended to be passed by value since internally it is just a pointer to actual value representation. For the same reason passing by value and calling setters will modify the original, e.g.:

func f1(val AttributeValue) { val.SetIntVal(234) }
func f2() {
    v := NewAttributeValueString("a string")
    f1(v)
    _ := v.Type() // this will return AttributeValueTypeInt
}

Important: zero-initialized instance is not valid for use. All AttributeValue functions below must be called only on instances that are created via NewAttributeValue+ functions.

func NewAttributeValueArray

func NewAttributeValueArray() AttributeValue

NewAttributeValueArray creates a new AttributeValue of array type.

func NewAttributeValueBool

func NewAttributeValueBool(v bool) AttributeValue

NewAttributeValueBool creates a new AttributeValue with the given bool value.

func NewAttributeValueBytes added in v0.32.0

func NewAttributeValueBytes(v []byte) AttributeValue

NewAttributeValueBytes creates a new AttributeValue with the given []byte value. The caller must ensure the []byte passed in is not modified after the call is made, sharing the data across multiple attributes is forbidden.

func NewAttributeValueDouble

func NewAttributeValueDouble(v float64) AttributeValue

NewAttributeValueDouble creates a new AttributeValue with the given float64 value.

func NewAttributeValueEmpty added in v0.35.0

func NewAttributeValueEmpty() AttributeValue

NewAttributeValueEmpty creates a new AttributeValue with an empty value.

func NewAttributeValueInt

func NewAttributeValueInt(v int64) AttributeValue

NewAttributeValueInt creates a new AttributeValue with the given int64 value.

func NewAttributeValueMap

func NewAttributeValueMap() AttributeValue

NewAttributeValueMap creates a new AttributeValue of map type.

func NewAttributeValueString

func NewAttributeValueString(v string) AttributeValue

NewAttributeValueString creates a new AttributeValue with the given string value.

func (AttributeValue) ArrayVal

func (a AttributeValue) ArrayVal() AnyValueArray

ArrayVal returns the array value associated with this AttributeValue. If the Type() is not AttributeValueTypeArray then returns an empty array. Note that modifying such empty array has no effect on this AttributeValue.

Calling this function on zero-initialized AttributeValue will cause a panic.

func (AttributeValue) AsString added in v0.34.0

func (a AttributeValue) AsString() string

AsString converts an OTLP AttributeValue object of any type to its equivalent string representation. This differs from StringVal which only returns a non-empty value if the AttributeValueType is AttributeValueTypeString.

func (AttributeValue) BoolVal

func (a AttributeValue) BoolVal() bool

BoolVal returns the bool value associated with this AttributeValue. If the Type() is not AttributeValueTypeBool then returns false. Calling this function on zero-initialized AttributeValue will cause a panic.

func (AttributeValue) BytesVal added in v0.32.0

func (a AttributeValue) BytesVal() []byte

BytesVal returns the []byte value associated with this AttributeValue. If the Type() is not AttributeValueTypeBytes then returns false. Calling this function on zero-initialized AttributeValue will cause a panic. Modifying the returned []byte in-place is forbidden.

func (AttributeValue) CopyTo

func (a AttributeValue) CopyTo(dest AttributeValue)

CopyTo copies the attribute to a destination.

func (AttributeValue) DoubleVal

func (a AttributeValue) DoubleVal() float64

DoubleVal returns the float64 value associated with this AttributeValue. If the Type() is not AttributeValueTypeDouble then returns float64(0). Calling this function on zero-initialized AttributeValue will cause a panic.

func (AttributeValue) Equal

func (a AttributeValue) Equal(av AttributeValue) bool

Equal checks for equality, it returns true if the objects are equal otherwise false.

func (AttributeValue) IntVal

func (a AttributeValue) IntVal() int64

IntVal returns the int64 value associated with this AttributeValue. If the Type() is not AttributeValueTypeInt then returns int64(0). Calling this function on zero-initialized AttributeValue will cause a panic.

func (AttributeValue) MapVal

func (a AttributeValue) MapVal() AttributeMap

MapVal returns the map value associated with this AttributeValue. If the Type() is not AttributeValueTypeMap then returns an empty map. Note that modifying such empty map has no effect on this AttributeValue.

Calling this function on zero-initialized AttributeValue will cause a panic.

func (AttributeValue) SetArrayVal added in v0.35.0

func (a AttributeValue) SetArrayVal(v AnyValueArray)

SetArrayVal replaces the AnyValueArray value associated with this AttributeValue, it also changes the type to be AttributeValueTypeArray. Calling this function on zero-initialized AttributeValue will cause a panic.

func (AttributeValue) SetBoolVal

func (a AttributeValue) SetBoolVal(v bool)

SetBoolVal replaces the bool value associated with this AttributeValue, it also changes the type to be AttributeValueTypeBool. Calling this function on zero-initialized AttributeValue will cause a panic.

func (AttributeValue) SetBytesVal added in v0.32.0

func (a AttributeValue) SetBytesVal(v []byte)

SetBytesVal replaces the []byte value associated with this AttributeValue, it also changes the type to be AttributeValueTypeBytes. Calling this function on zero-initialized AttributeValue will cause a panic. The caller must ensure the []byte passed in is not modified after the call is made, sharing the data across multiple attributes is forbidden.

func (AttributeValue) SetDoubleVal

func (a AttributeValue) SetDoubleVal(v float64)

SetDoubleVal replaces the float64 value associated with this AttributeValue, it also changes the type to be AttributeValueTypeDouble. Calling this function on zero-initialized AttributeValue will cause a panic.

func (AttributeValue) SetIntVal

func (a AttributeValue) SetIntVal(v int64)

SetIntVal replaces the int64 value associated with this AttributeValue, it also changes the type to be AttributeValueTypeInt. Calling this function on zero-initialized AttributeValue will cause a panic.

func (AttributeValue) SetMapVal added in v0.35.0

func (a AttributeValue) SetMapVal(v AttributeMap)

SetMapVal replaces the AttributeMap value associated with this AttributeValue, it also changes the type to be AttributeValueTypeMap. Calling this function on zero-initialized AttributeValue will cause a panic.

func (AttributeValue) SetStringVal

func (a AttributeValue) SetStringVal(v string)

SetStringVal replaces the string value associated with this AttributeValue, it also changes the type to be AttributeValueTypeString. Calling this function on zero-initialized AttributeValue will cause a panic.

func (AttributeValue) StringVal

func (a AttributeValue) StringVal() string

StringVal returns the string value associated with this AttributeValue. If the Type() is not AttributeValueTypeString then returns empty string. Calling this function on zero-initialized AttributeValue will cause a panic.

func (AttributeValue) Type

Type returns the type of the value for this AttributeValue. Calling this function on zero-initialized AttributeValue will cause a panic.

type AttributeValueType

type AttributeValueType int32

AttributeValueType specifies the type of AttributeValue.

const (
	AttributeValueTypeEmpty AttributeValueType = iota
	AttributeValueTypeString
	AttributeValueTypeInt
	AttributeValueTypeDouble
	AttributeValueTypeBool
	AttributeValueTypeMap
	AttributeValueTypeArray
	AttributeValueTypeBytes
)

func (AttributeValueType) String

func (avt AttributeValueType) String() string

String returns the string representation of the AttributeValueType.

type Exemplar

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

Exemplar is a sample input double measurement.

Exemplars also hold information about the environment when the measurement was recorded, for example the span and trace ID of the active span when the exemplar was recorded.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewExemplar function to create new instances. Important: zero-initialized instance is not valid for use.

func NewExemplar

func NewExemplar() Exemplar

NewExemplar creates a new empty Exemplar.

This must be used only in testing code since no "Set" method available.

func (Exemplar) CopyTo

func (ms Exemplar) CopyTo(dest Exemplar)

CopyTo copies all properties from the current struct to the dest.

func (Exemplar) DoubleVal added in v0.31.0

func (ms Exemplar) DoubleVal() float64

DoubleVal returns the doubleval associated with this Exemplar.

func (Exemplar) FilteredAttributes added in v0.33.0

func (ms Exemplar) FilteredAttributes() AttributeMap

FilteredAttributes returns the FilteredAttributes associated with this Exemplar.

func (Exemplar) IntVal added in v0.31.0

func (ms Exemplar) IntVal() int64

IntVal returns the intval associated with this Exemplar.

func (Exemplar) SetDoubleVal added in v0.31.0

func (ms Exemplar) SetDoubleVal(v float64)

SetDoubleVal replaces the doubleval associated with this Exemplar.

func (Exemplar) SetIntVal added in v0.31.0

func (ms Exemplar) SetIntVal(v int64)

SetIntVal replaces the intval associated with this Exemplar.

func (Exemplar) SetSpanID added in v0.36.0

func (ms Exemplar) SetSpanID(v SpanID)

SetSpanID replaces the spanid associated with this Exemplar.

func (Exemplar) SetTimestamp

func (ms Exemplar) SetTimestamp(v Timestamp)

SetTimestamp replaces the timestamp associated with this Exemplar.

func (Exemplar) SetTraceID added in v0.36.0

func (ms Exemplar) SetTraceID(v TraceID)

SetTraceID replaces the traceid associated with this Exemplar.

func (Exemplar) SpanID added in v0.36.0

func (ms Exemplar) SpanID() SpanID

SpanID returns the spanid associated with this Exemplar.

func (Exemplar) Timestamp

func (ms Exemplar) Timestamp() Timestamp

Timestamp returns the timestamp associated with this Exemplar.

func (Exemplar) TraceID added in v0.36.0

func (ms Exemplar) TraceID() TraceID

TraceID returns the traceid associated with this Exemplar.

func (Exemplar) Type added in v0.31.0

func (ms Exemplar) Type() MetricValueType

Type returns the type of the value for this Exemplar. Calling this function on zero-initialized Exemplar will cause a panic.

type ExemplarSlice

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

ExemplarSlice logically represents a slice of Exemplar.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewExemplarSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewExemplarSlice

func NewExemplarSlice() ExemplarSlice

NewExemplarSlice creates a ExemplarSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (ExemplarSlice) AppendEmpty

func (es ExemplarSlice) AppendEmpty() Exemplar

AppendEmpty will append to the end of the slice an empty Exemplar. It returns the newly added Exemplar.

func (ExemplarSlice) At

func (es ExemplarSlice) At(ix int) Exemplar

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (ExemplarSlice) CopyTo

func (es ExemplarSlice) CopyTo(dest ExemplarSlice)

CopyTo copies all elements from the current slice to the dest.

func (ExemplarSlice) EnsureCapacity

func (es ExemplarSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new ExemplarSlice can be initialized:

es := NewExemplarSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (ExemplarSlice) Len

func (es ExemplarSlice) Len() int

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewExemplarSlice()".

func (ExemplarSlice) MoveAndAppendTo

func (es ExemplarSlice) MoveAndAppendTo(dest ExemplarSlice)

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (ExemplarSlice) RemoveIf

func (es ExemplarSlice) RemoveIf(f func(Exemplar) bool)

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

type Gauge

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

Gauge represents the type of a double scalar metric that always exports the "current value" for every data point.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewGauge function to create new instances. Important: zero-initialized instance is not valid for use.

func NewGauge

func NewGauge() Gauge

NewGauge creates a new empty Gauge.

This must be used only in testing code since no "Set" method available.

func (Gauge) CopyTo

func (ms Gauge) CopyTo(dest Gauge)

CopyTo copies all properties from the current struct to the dest.

func (Gauge) DataPoints

func (ms Gauge) DataPoints() NumberDataPointSlice

DataPoints returns the DataPoints associated with this Gauge.

type Histogram

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

Histogram represents the type of a metric that is calculated by aggregating as a Histogram of all reported measurements over a time interval.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewHistogram function to create new instances. Important: zero-initialized instance is not valid for use.

func NewHistogram

func NewHistogram() Histogram

NewHistogram creates a new empty Histogram.

This must be used only in testing code since no "Set" method available.

func (Histogram) AggregationTemporality

func (ms Histogram) AggregationTemporality() MetricAggregationTemporality

AggregationTemporality returns the aggregationtemporality associated with this Histogram.

func (Histogram) CopyTo

func (ms Histogram) CopyTo(dest Histogram)

CopyTo copies all properties from the current struct to the dest.

func (Histogram) DataPoints

func (ms Histogram) DataPoints() HistogramDataPointSlice

DataPoints returns the DataPoints associated with this Histogram.

func (Histogram) SetAggregationTemporality

func (ms Histogram) SetAggregationTemporality(v MetricAggregationTemporality)

SetAggregationTemporality replaces the aggregationtemporality associated with this Histogram.

type HistogramDataPoint

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

HistogramDataPoint is a single data point in a timeseries that describes the time-varying values of a Histogram of values.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewHistogramDataPoint function to create new instances. Important: zero-initialized instance is not valid for use.

func NewHistogramDataPoint

func NewHistogramDataPoint() HistogramDataPoint

NewHistogramDataPoint creates a new empty HistogramDataPoint.

This must be used only in testing code since no "Set" method available.

func (HistogramDataPoint) Attributes added in v0.32.0

func (ms HistogramDataPoint) Attributes() AttributeMap

Attributes returns the Attributes associated with this HistogramDataPoint.

func (HistogramDataPoint) BucketCounts

func (ms HistogramDataPoint) BucketCounts() []uint64

BucketCounts returns the bucketcounts associated with this HistogramDataPoint.

func (HistogramDataPoint) CopyTo

func (ms HistogramDataPoint) CopyTo(dest HistogramDataPoint)

CopyTo copies all properties from the current struct to the dest.

func (HistogramDataPoint) Count

func (ms HistogramDataPoint) Count() uint64

Count returns the count associated with this HistogramDataPoint.

func (HistogramDataPoint) Exemplars

func (ms HistogramDataPoint) Exemplars() ExemplarSlice

Exemplars returns the Exemplars associated with this HistogramDataPoint.

func (HistogramDataPoint) ExplicitBounds

func (ms HistogramDataPoint) ExplicitBounds() []float64

ExplicitBounds returns the explicitbounds associated with this HistogramDataPoint.

func (HistogramDataPoint) Flags added in v0.37.0

Flags returns the flags associated with this HistogramDataPoint.

func (HistogramDataPoint) SetBucketCounts

func (ms HistogramDataPoint) SetBucketCounts(v []uint64)

SetBucketCounts replaces the bucketcounts associated with this HistogramDataPoint.

func (HistogramDataPoint) SetCount

func (ms HistogramDataPoint) SetCount(v uint64)

SetCount replaces the count associated with this HistogramDataPoint.

func (HistogramDataPoint) SetExplicitBounds

func (ms HistogramDataPoint) SetExplicitBounds(v []float64)

SetExplicitBounds replaces the explicitbounds associated with this HistogramDataPoint.

func (HistogramDataPoint) SetFlags added in v0.37.0

SetFlags replaces the flags associated with this HistogramDataPoint.

func (HistogramDataPoint) SetStartTimestamp

func (ms HistogramDataPoint) SetStartTimestamp(v Timestamp)

SetStartTimestamp replaces the starttimestamp associated with this HistogramDataPoint.

func (HistogramDataPoint) SetSum

func (ms HistogramDataPoint) SetSum(v float64)

SetSum replaces the sum associated with this HistogramDataPoint.

func (HistogramDataPoint) SetTimestamp

func (ms HistogramDataPoint) SetTimestamp(v Timestamp)

SetTimestamp replaces the timestamp associated with this HistogramDataPoint.

func (HistogramDataPoint) StartTimestamp

func (ms HistogramDataPoint) StartTimestamp() Timestamp

StartTimestamp returns the starttimestamp associated with this HistogramDataPoint.

func (HistogramDataPoint) Sum

func (ms HistogramDataPoint) Sum() float64

Sum returns the sum associated with this HistogramDataPoint.

func (HistogramDataPoint) Timestamp

func (ms HistogramDataPoint) Timestamp() Timestamp

Timestamp returns the timestamp associated with this HistogramDataPoint.

type HistogramDataPointSlice

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

HistogramDataPointSlice logically represents a slice of HistogramDataPoint.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewHistogramDataPointSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewHistogramDataPointSlice

func NewHistogramDataPointSlice() HistogramDataPointSlice

NewHistogramDataPointSlice creates a HistogramDataPointSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (HistogramDataPointSlice) AppendEmpty

AppendEmpty will append to the end of the slice an empty HistogramDataPoint. It returns the newly added HistogramDataPoint.

func (HistogramDataPointSlice) At

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (HistogramDataPointSlice) CopyTo

CopyTo copies all elements from the current slice to the dest.

func (HistogramDataPointSlice) EnsureCapacity

func (es HistogramDataPointSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new HistogramDataPointSlice can be initialized:

es := NewHistogramDataPointSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (HistogramDataPointSlice) Len

func (es HistogramDataPointSlice) Len() int

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewHistogramDataPointSlice()".

func (HistogramDataPointSlice) MoveAndAppendTo

func (es HistogramDataPointSlice) MoveAndAppendTo(dest HistogramDataPointSlice)

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (HistogramDataPointSlice) RemoveIf

func (es HistogramDataPointSlice) RemoveIf(f func(HistogramDataPoint) bool)

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

func (HistogramDataPointSlice) Sort added in v0.31.0

Sort sorts the HistogramDataPoint elements within HistogramDataPointSlice given the provided less function so that two instances of HistogramDataPointSlice can be compared.

Returns the same instance to allow nicer code like:

lessFunc := func(a, b HistogramDataPoint) bool {
  return a.Name() < b.Name() // choose any comparison here
}
assert.EqualValues(t, expected.Sort(lessFunc), actual.Sort(lessFunc))

type InstrumentationLibrary

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

InstrumentationLibrary is a message representing the instrumentation library information.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewInstrumentationLibrary function to create new instances. Important: zero-initialized instance is not valid for use.

func NewInstrumentationLibrary

func NewInstrumentationLibrary() InstrumentationLibrary

NewInstrumentationLibrary creates a new empty InstrumentationLibrary.

This must be used only in testing code since no "Set" method available.

func (InstrumentationLibrary) CopyTo

CopyTo copies all properties from the current struct to the dest.

func (InstrumentationLibrary) Name

func (ms InstrumentationLibrary) Name() string

Name returns the name associated with this InstrumentationLibrary.

func (InstrumentationLibrary) SetName

func (ms InstrumentationLibrary) SetName(v string)

SetName replaces the name associated with this InstrumentationLibrary.

func (InstrumentationLibrary) SetVersion

func (ms InstrumentationLibrary) SetVersion(v string)

SetVersion replaces the version associated with this InstrumentationLibrary.

func (InstrumentationLibrary) Version

func (ms InstrumentationLibrary) Version() string

Version returns the version associated with this InstrumentationLibrary.

type InstrumentationLibraryLogs

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

InstrumentationLibraryLogs is a collection of logs from a LibraryInstrumentation.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewInstrumentationLibraryLogs function to create new instances. Important: zero-initialized instance is not valid for use.

func NewInstrumentationLibraryLogs

func NewInstrumentationLibraryLogs() InstrumentationLibraryLogs

NewInstrumentationLibraryLogs creates a new empty InstrumentationLibraryLogs.

This must be used only in testing code since no "Set" method available.

func (InstrumentationLibraryLogs) CopyTo

CopyTo copies all properties from the current struct to the dest.

func (InstrumentationLibraryLogs) InstrumentationLibrary

func (ms InstrumentationLibraryLogs) InstrumentationLibrary() InstrumentationLibrary

InstrumentationLibrary returns the instrumentationlibrary associated with this InstrumentationLibraryLogs.

func (InstrumentationLibraryLogs) Logs

Logs returns the Logs associated with this InstrumentationLibraryLogs.

func (InstrumentationLibraryLogs) SchemaUrl added in v0.32.0

func (ms InstrumentationLibraryLogs) SchemaUrl() string

SchemaUrl returns the schemaurl associated with this InstrumentationLibraryLogs.

func (InstrumentationLibraryLogs) SetSchemaUrl added in v0.32.0

func (ms InstrumentationLibraryLogs) SetSchemaUrl(v string)

SetSchemaUrl replaces the schemaurl associated with this InstrumentationLibraryLogs.

type InstrumentationLibraryLogsSlice

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

InstrumentationLibraryLogsSlice logically represents a slice of InstrumentationLibraryLogs.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewInstrumentationLibraryLogsSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewInstrumentationLibraryLogsSlice

func NewInstrumentationLibraryLogsSlice() InstrumentationLibraryLogsSlice

NewInstrumentationLibraryLogsSlice creates a InstrumentationLibraryLogsSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (InstrumentationLibraryLogsSlice) AppendEmpty

AppendEmpty will append to the end of the slice an empty InstrumentationLibraryLogs. It returns the newly added InstrumentationLibraryLogs.

func (InstrumentationLibraryLogsSlice) At

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (InstrumentationLibraryLogsSlice) CopyTo

CopyTo copies all elements from the current slice to the dest.

func (InstrumentationLibraryLogsSlice) EnsureCapacity

func (es InstrumentationLibraryLogsSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new InstrumentationLibraryLogsSlice can be initialized:

es := NewInstrumentationLibraryLogsSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (InstrumentationLibraryLogsSlice) Len

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewInstrumentationLibraryLogsSlice()".

func (InstrumentationLibraryLogsSlice) MoveAndAppendTo

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (InstrumentationLibraryLogsSlice) RemoveIf

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

func (InstrumentationLibraryLogsSlice) Sort added in v0.31.0

Sort sorts the InstrumentationLibraryLogs elements within InstrumentationLibraryLogsSlice given the provided less function so that two instances of InstrumentationLibraryLogsSlice can be compared.

Returns the same instance to allow nicer code like:

lessFunc := func(a, b InstrumentationLibraryLogs) bool {
  return a.Name() < b.Name() // choose any comparison here
}
assert.EqualValues(t, expected.Sort(lessFunc), actual.Sort(lessFunc))

type InstrumentationLibraryMetrics

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

InstrumentationLibraryMetrics is a collection of metrics from a LibraryInstrumentation.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewInstrumentationLibraryMetrics function to create new instances. Important: zero-initialized instance is not valid for use.

func NewInstrumentationLibraryMetrics

func NewInstrumentationLibraryMetrics() InstrumentationLibraryMetrics

NewInstrumentationLibraryMetrics creates a new empty InstrumentationLibraryMetrics.

This must be used only in testing code since no "Set" method available.

func (InstrumentationLibraryMetrics) CopyTo

CopyTo copies all properties from the current struct to the dest.

func (InstrumentationLibraryMetrics) InstrumentationLibrary

func (ms InstrumentationLibraryMetrics) InstrumentationLibrary() InstrumentationLibrary

InstrumentationLibrary returns the instrumentationlibrary associated with this InstrumentationLibraryMetrics.

func (InstrumentationLibraryMetrics) Metrics

Metrics returns the Metrics associated with this InstrumentationLibraryMetrics.

func (InstrumentationLibraryMetrics) SchemaUrl added in v0.32.0

func (ms InstrumentationLibraryMetrics) SchemaUrl() string

SchemaUrl returns the schemaurl associated with this InstrumentationLibraryMetrics.

func (InstrumentationLibraryMetrics) SetSchemaUrl added in v0.32.0

func (ms InstrumentationLibraryMetrics) SetSchemaUrl(v string)

SetSchemaUrl replaces the schemaurl associated with this InstrumentationLibraryMetrics.

type InstrumentationLibraryMetricsSlice

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

InstrumentationLibraryMetricsSlice logically represents a slice of InstrumentationLibraryMetrics.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewInstrumentationLibraryMetricsSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewInstrumentationLibraryMetricsSlice

func NewInstrumentationLibraryMetricsSlice() InstrumentationLibraryMetricsSlice

NewInstrumentationLibraryMetricsSlice creates a InstrumentationLibraryMetricsSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (InstrumentationLibraryMetricsSlice) AppendEmpty

AppendEmpty will append to the end of the slice an empty InstrumentationLibraryMetrics. It returns the newly added InstrumentationLibraryMetrics.

func (InstrumentationLibraryMetricsSlice) At

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (InstrumentationLibraryMetricsSlice) CopyTo

CopyTo copies all elements from the current slice to the dest.

func (InstrumentationLibraryMetricsSlice) EnsureCapacity

func (es InstrumentationLibraryMetricsSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new InstrumentationLibraryMetricsSlice can be initialized:

es := NewInstrumentationLibraryMetricsSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (InstrumentationLibraryMetricsSlice) Len

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewInstrumentationLibraryMetricsSlice()".

func (InstrumentationLibraryMetricsSlice) MoveAndAppendTo

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (InstrumentationLibraryMetricsSlice) RemoveIf

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

func (InstrumentationLibraryMetricsSlice) Sort added in v0.31.0

Sort sorts the InstrumentationLibraryMetrics elements within InstrumentationLibraryMetricsSlice given the provided less function so that two instances of InstrumentationLibraryMetricsSlice can be compared.

Returns the same instance to allow nicer code like:

lessFunc := func(a, b InstrumentationLibraryMetrics) bool {
  return a.Name() < b.Name() // choose any comparison here
}
assert.EqualValues(t, expected.Sort(lessFunc), actual.Sort(lessFunc))

type InstrumentationLibrarySpans

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

InstrumentationLibrarySpans is a collection of spans from a LibraryInstrumentation.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewInstrumentationLibrarySpans function to create new instances. Important: zero-initialized instance is not valid for use.

func NewInstrumentationLibrarySpans

func NewInstrumentationLibrarySpans() InstrumentationLibrarySpans

NewInstrumentationLibrarySpans creates a new empty InstrumentationLibrarySpans.

This must be used only in testing code since no "Set" method available.

func (InstrumentationLibrarySpans) CopyTo

CopyTo copies all properties from the current struct to the dest.

func (InstrumentationLibrarySpans) InstrumentationLibrary

func (ms InstrumentationLibrarySpans) InstrumentationLibrary() InstrumentationLibrary

InstrumentationLibrary returns the instrumentationlibrary associated with this InstrumentationLibrarySpans.

func (InstrumentationLibrarySpans) SchemaUrl added in v0.32.0

func (ms InstrumentationLibrarySpans) SchemaUrl() string

SchemaUrl returns the schemaurl associated with this InstrumentationLibrarySpans.

func (InstrumentationLibrarySpans) SetSchemaUrl added in v0.32.0

func (ms InstrumentationLibrarySpans) SetSchemaUrl(v string)

SetSchemaUrl replaces the schemaurl associated with this InstrumentationLibrarySpans.

func (InstrumentationLibrarySpans) Spans

Spans returns the Spans associated with this InstrumentationLibrarySpans.

type InstrumentationLibrarySpansSlice

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

InstrumentationLibrarySpansSlice logically represents a slice of InstrumentationLibrarySpans.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewInstrumentationLibrarySpansSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewInstrumentationLibrarySpansSlice

func NewInstrumentationLibrarySpansSlice() InstrumentationLibrarySpansSlice

NewInstrumentationLibrarySpansSlice creates a InstrumentationLibrarySpansSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (InstrumentationLibrarySpansSlice) AppendEmpty

AppendEmpty will append to the end of the slice an empty InstrumentationLibrarySpans. It returns the newly added InstrumentationLibrarySpans.

func (InstrumentationLibrarySpansSlice) At

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (InstrumentationLibrarySpansSlice) CopyTo

CopyTo copies all elements from the current slice to the dest.

func (InstrumentationLibrarySpansSlice) EnsureCapacity

func (es InstrumentationLibrarySpansSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new InstrumentationLibrarySpansSlice can be initialized:

es := NewInstrumentationLibrarySpansSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (InstrumentationLibrarySpansSlice) Len

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewInstrumentationLibrarySpansSlice()".

func (InstrumentationLibrarySpansSlice) MoveAndAppendTo

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (InstrumentationLibrarySpansSlice) RemoveIf

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

func (InstrumentationLibrarySpansSlice) Sort added in v0.31.0

Sort sorts the InstrumentationLibrarySpans elements within InstrumentationLibrarySpansSlice given the provided less function so that two instances of InstrumentationLibrarySpansSlice can be compared.

Returns the same instance to allow nicer code like:

lessFunc := func(a, b InstrumentationLibrarySpans) bool {
  return a.Name() < b.Name() // choose any comparison here
}
assert.EqualValues(t, expected.Sort(lessFunc), actual.Sort(lessFunc))

type LogRecord

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

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewLogRecord function to create new instances. Important: zero-initialized instance is not valid for use.

func NewLogRecord

func NewLogRecord() LogRecord

NewLogRecord creates a new empty LogRecord.

This must be used only in testing code since no "Set" method available.

func (LogRecord) Attributes

func (ms LogRecord) Attributes() AttributeMap

Attributes returns the Attributes associated with this LogRecord.

func (LogRecord) Body

func (ms LogRecord) Body() AttributeValue

Body returns the body associated with this LogRecord.

func (LogRecord) CopyTo

func (ms LogRecord) CopyTo(dest LogRecord)

CopyTo copies all properties from the current struct to the dest.

func (LogRecord) DroppedAttributesCount

func (ms LogRecord) DroppedAttributesCount() uint32

DroppedAttributesCount returns the droppedattributescount associated with this LogRecord.

func (LogRecord) Flags

func (ms LogRecord) Flags() uint32

Flags returns the flags associated with this LogRecord.

func (LogRecord) Name

func (ms LogRecord) Name() string

Name returns the name associated with this LogRecord.

func (LogRecord) SetDroppedAttributesCount

func (ms LogRecord) SetDroppedAttributesCount(v uint32)

SetDroppedAttributesCount replaces the droppedattributescount associated with this LogRecord.

func (LogRecord) SetFlags

func (ms LogRecord) SetFlags(v uint32)

SetFlags replaces the flags associated with this LogRecord.

func (LogRecord) SetName

func (ms LogRecord) SetName(v string)

SetName replaces the name associated with this LogRecord.

func (LogRecord) SetSeverityNumber

func (ms LogRecord) SetSeverityNumber(v SeverityNumber)

SetSeverityNumber replaces the severitynumber associated with this LogRecord.

func (LogRecord) SetSeverityText

func (ms LogRecord) SetSeverityText(v string)

SetSeverityText replaces the severitytext associated with this LogRecord.

func (LogRecord) SetSpanID

func (ms LogRecord) SetSpanID(v SpanID)

SetSpanID replaces the spanid associated with this LogRecord.

func (LogRecord) SetTimestamp

func (ms LogRecord) SetTimestamp(v Timestamp)

SetTimestamp replaces the timestamp associated with this LogRecord.

func (LogRecord) SetTraceID

func (ms LogRecord) SetTraceID(v TraceID)

SetTraceID replaces the traceid associated with this LogRecord.

func (LogRecord) SeverityNumber

func (ms LogRecord) SeverityNumber() SeverityNumber

SeverityNumber returns the severitynumber associated with this LogRecord.

func (LogRecord) SeverityText

func (ms LogRecord) SeverityText() string

SeverityText returns the severitytext associated with this LogRecord.

func (LogRecord) SpanID

func (ms LogRecord) SpanID() SpanID

SpanID returns the spanid associated with this LogRecord.

func (LogRecord) Timestamp

func (ms LogRecord) Timestamp() Timestamp

Timestamp returns the timestamp associated with this LogRecord.

func (LogRecord) TraceID

func (ms LogRecord) TraceID() TraceID

TraceID returns the traceid associated with this LogRecord.

type LogSlice

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

LogSlice logically represents a slice of LogRecord.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewLogSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewLogSlice

func NewLogSlice() LogSlice

NewLogSlice creates a LogSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (LogSlice) AppendEmpty

func (es LogSlice) AppendEmpty() LogRecord

AppendEmpty will append to the end of the slice an empty LogRecord. It returns the newly added LogRecord.

func (LogSlice) At

func (es LogSlice) At(ix int) LogRecord

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (LogSlice) CopyTo

func (es LogSlice) CopyTo(dest LogSlice)

CopyTo copies all elements from the current slice to the dest.

func (LogSlice) EnsureCapacity

func (es LogSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new LogSlice can be initialized:

es := NewLogSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (LogSlice) Len

func (es LogSlice) Len() int

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewLogSlice()".

func (LogSlice) MoveAndAppendTo

func (es LogSlice) MoveAndAppendTo(dest LogSlice)

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (LogSlice) RemoveIf

func (es LogSlice) RemoveIf(f func(LogRecord) bool)

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

func (LogSlice) Sort added in v0.31.0

func (es LogSlice) Sort(less func(a, b LogRecord) bool) LogSlice

Sort sorts the LogRecord elements within LogSlice given the provided less function so that two instances of LogSlice can be compared.

Returns the same instance to allow nicer code like:

lessFunc := func(a, b LogRecord) bool {
  return a.Name() < b.Name() // choose any comparison here
}
assert.EqualValues(t, expected.Sort(lessFunc), actual.Sort(lessFunc))

type Logs

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

Logs is the top-level struct that is propagated through the logs pipeline.

This is a reference type (like builtin map).

Must use NewLogs functions to create new instances. Important: zero-initialized instance is not valid for use.

func LogsFromInternalRep

func LogsFromInternalRep(logs internal.LogsWrapper) Logs

LogsFromInternalRep creates the internal Logs representation from the ProtoBuf. Should not be used outside this module. This is intended to be used only by OTLP exporter and File exporter, which legitimately need to work with OTLP Protobuf structs.

func NewLogs

func NewLogs() Logs

NewLogs creates a new Logs.

func (Logs) Clone

func (ld Logs) Clone() Logs

Clone returns a copy of Logs.

func (Logs) InternalRep

func (ld Logs) InternalRep() internal.LogsWrapper

InternalRep returns internal representation of the logs. Should not be used outside this module. This is intended to be used only by OTLP exporter and File exporter, which legitimately need to work with OTLP Protobuf structs.

func (Logs) LogRecordCount

func (ld Logs) LogRecordCount() int

LogRecordCount calculates the total number of log records.

func (Logs) ResourceLogs

func (ld Logs) ResourceLogs() ResourceLogsSlice

ResourceLogs returns the ResourceLogsSlice associated with this Logs.

type LogsMarshaler

type LogsMarshaler interface {
	// MarshalLogs the given pdata.Logs into bytes.
	// If the error is not nil, the returned bytes slice cannot be used.
	MarshalLogs(ld Logs) ([]byte, error)
}

LogsMarshaler marshals pdata.Logs into bytes.

type LogsSizer added in v0.33.0

type LogsSizer interface {
	// LogsSize returns the size in bytes of a marshaled Logs.
	LogsSize(ld Logs) int
}

LogsSizer is an optional interface implemented by the LogsMarshaler, that calculates the size of a marshaled Logs.

type LogsUnmarshaler

type LogsUnmarshaler interface {
	// UnmarshalLogs the given bytes into pdata.Logs.
	// If the error is not nil, the returned pdata.Logs cannot be used.
	UnmarshalLogs(buf []byte) (Logs, error)
}

LogsUnmarshaler unmarshalls bytes into pdata.Logs.

type Metric

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

Metric represents one metric as a collection of datapoints. See Metric definition in OTLP: https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/metrics/v1/metrics.proto

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewMetric function to create new instances. Important: zero-initialized instance is not valid for use.

func NewMetric

func NewMetric() Metric

NewMetric creates a new empty Metric.

This must be used only in testing code since no "Set" method available.

func (Metric) CopyTo

func (ms Metric) CopyTo(dest Metric)

CopyTo copies all properties from the current struct to the dest.

func (Metric) DataType

func (ms Metric) DataType() MetricDataType

DataType returns the type of the data for this Metric. Calling this function on zero-initialized Metric will cause a panic.

func (Metric) Description

func (ms Metric) Description() string

Description returns the description associated with this Metric.

func (Metric) Gauge

func (ms Metric) Gauge() Gauge

Gauge returns the data as Gauge. Calling this function when DataType() != MetricDataTypeGauge will cause a panic. Calling this function on zero-initialized Metric will cause a panic.

func (Metric) Histogram

func (ms Metric) Histogram() Histogram

Histogram returns the data as Histogram. Calling this function when DataType() != MetricDataTypeHistogram will cause a panic. Calling this function on zero-initialized Metric will cause a panic.

func (Metric) Name

func (ms Metric) Name() string

Name returns the name associated with this Metric.

func (Metric) SetDataType

func (ms Metric) SetDataType(ty MetricDataType)

SetDataType clears any existing data and initialize it with an empty data of the given type. Calling this function on zero-initialized Metric will cause a panic.

func (Metric) SetDescription

func (ms Metric) SetDescription(v string)

SetDescription replaces the description associated with this Metric.

func (Metric) SetName

func (ms Metric) SetName(v string)

SetName replaces the name associated with this Metric.

func (Metric) SetUnit

func (ms Metric) SetUnit(v string)

SetUnit replaces the unit associated with this Metric.

func (Metric) Sum

func (ms Metric) Sum() Sum

Sum returns the data as Sum. Calling this function when DataType() != MetricDataTypeSum will cause a panic. Calling this function on zero-initialized Metric will cause a panic.

func (Metric) Summary

func (ms Metric) Summary() Summary

Summary returns the data as Summary. Calling this function when DataType() != MetricDataTypeSummary will cause a panic. Calling this function on zero-initialized Metric will cause a panic.

func (Metric) Unit

func (ms Metric) Unit() string

Unit returns the unit associated with this Metric.

type MetricAggregationTemporality added in v0.37.0

type MetricAggregationTemporality int32

MetricAggregationTemporality defines how a metric aggregator reports aggregated values. It describes how those values relate to the time interval over which they are aggregated.

func (MetricAggregationTemporality) String added in v0.37.0

String returns the string representation of the MetricAggregationTemporality.

type MetricDataPointFlag added in v0.37.0

type MetricDataPointFlag uint32

MetricDataPointFlag allow users to configure DataPointFlags. This is achieved via NewMetricDataPointFlags. The separation between MetricDataPointFlags and MetricDataPointFlag exists to prevent users accidentally comparing the value of individual flags with MetricDataPointFlags. Instead, users must use the HasFlag method.

type MetricDataPointFlags added in v0.37.0

type MetricDataPointFlags uint32

MetricDataPointFlags defines how a metric aggregator reports aggregated values. It describes how those values relate to the time interval over which they are aggregated.

func NewMetricDataPointFlags added in v0.37.0

func NewMetricDataPointFlags(flags ...MetricDataPointFlag) MetricDataPointFlags

NewMetricDataPointFlags returns a new MetricDataPointFlags combining the flags passed in as parameters.

func (MetricDataPointFlags) HasFlag added in v0.37.0

HasFlag returns true if the MetricDataPointFlags contains the specified flag

func (MetricDataPointFlags) String added in v0.37.0

func (d MetricDataPointFlags) String() string

String returns the string representation of the MetricDataPointFlags.

type MetricDataType

type MetricDataType int32

MetricDataType specifies the type of data in a Metric.

const (
	MetricDataTypeNone MetricDataType = iota
	MetricDataTypeGauge
	MetricDataTypeSum
	MetricDataTypeHistogram
	MetricDataTypeSummary
)

func (MetricDataType) String

func (mdt MetricDataType) String() string

String returns the string representation of the MetricDataType.

type MetricSlice

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

MetricSlice logically represents a slice of Metric.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewMetricSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewMetricSlice

func NewMetricSlice() MetricSlice

NewMetricSlice creates a MetricSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (MetricSlice) AppendEmpty

func (es MetricSlice) AppendEmpty() Metric

AppendEmpty will append to the end of the slice an empty Metric. It returns the newly added Metric.

func (MetricSlice) At

func (es MetricSlice) At(ix int) Metric

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (MetricSlice) CopyTo

func (es MetricSlice) CopyTo(dest MetricSlice)

CopyTo copies all elements from the current slice to the dest.

func (MetricSlice) EnsureCapacity

func (es MetricSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new MetricSlice can be initialized:

es := NewMetricSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (MetricSlice) Len

func (es MetricSlice) Len() int

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewMetricSlice()".

func (MetricSlice) MoveAndAppendTo

func (es MetricSlice) MoveAndAppendTo(dest MetricSlice)

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (MetricSlice) RemoveIf

func (es MetricSlice) RemoveIf(f func(Metric) bool)

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

func (MetricSlice) Sort added in v0.31.0

func (es MetricSlice) Sort(less func(a, b Metric) bool) MetricSlice

Sort sorts the Metric elements within MetricSlice given the provided less function so that two instances of MetricSlice can be compared.

Returns the same instance to allow nicer code like:

lessFunc := func(a, b Metric) bool {
  return a.Name() < b.Name() // choose any comparison here
}
assert.EqualValues(t, expected.Sort(lessFunc), actual.Sort(lessFunc))

type MetricValueType added in v0.31.0

type MetricValueType int32

MetricValueType specifies the type of NumberDataPoint.

const (
	MetricValueTypeNone MetricValueType = iota
	MetricValueTypeInt
	MetricValueTypeDouble
)

type Metrics

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

Metrics is an opaque interface that allows transition to the new internal Metrics data, but also facilitates the transition to the new components, especially for traces.

Outside of the core repository, the metrics pipeline cannot be converted to the new model since data.MetricData is part of the internal package.

func MetricsFromInternalRep

func MetricsFromInternalRep(wrapper internal.MetricsWrapper) Metrics

MetricsFromInternalRep creates Metrics from the internal representation. Should not be used outside this module.

func NewMetrics

func NewMetrics() Metrics

NewMetrics creates a new Metrics.

func (Metrics) Clone

func (md Metrics) Clone() Metrics

Clone returns a copy of MetricData.

func (Metrics) DataPointCount

func (md Metrics) DataPointCount() (dataPointCount int)

DataPointCount calculates the total number of data points.

func (Metrics) InternalRep

func (md Metrics) InternalRep() internal.MetricsWrapper

InternalRep returns internal representation of the Metrics. Should not be used outside this module.

func (Metrics) MetricCount

func (md Metrics) MetricCount() int

MetricCount calculates the total number of metrics.

func (Metrics) ResourceMetrics

func (md Metrics) ResourceMetrics() ResourceMetricsSlice

ResourceMetrics returns the ResourceMetricsSlice associated with this Metrics.

type MetricsMarshaler

type MetricsMarshaler interface {
	// MarshalMetrics the given pdata.Metrics into bytes.
	// If the error is not nil, the returned bytes slice cannot be used.
	MarshalMetrics(md Metrics) ([]byte, error)
}

MetricsMarshaler marshals pdata.Metrics into bytes.

type MetricsSizer added in v0.33.0

type MetricsSizer interface {
	// MetricsSize returns the size in bytes of a marshaled Metrics.
	MetricsSize(md Metrics) int
}

MetricsSizer is an optional interface implemented by the MetricsMarshaler, that calculates the size of a marshaled Metrics.

type MetricsUnmarshaler

type MetricsUnmarshaler interface {
	// UnmarshalMetrics the given bytes into pdata.Metrics.
	// If the error is not nil, the returned pdata.Metrics cannot be used.
	UnmarshalMetrics(buf []byte) (Metrics, error)
}

MetricsUnmarshaler unmarshalls bytes into pdata.Metrics.

type NumberDataPoint added in v0.31.0

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

NumberDataPoint is a single data point in a timeseries that describes the time-varying value of a number metric.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewNumberDataPoint function to create new instances. Important: zero-initialized instance is not valid for use.

func NewNumberDataPoint added in v0.31.0

func NewNumberDataPoint() NumberDataPoint

NewNumberDataPoint creates a new empty NumberDataPoint.

This must be used only in testing code since no "Set" method available.

func (NumberDataPoint) Attributes added in v0.32.0

func (ms NumberDataPoint) Attributes() AttributeMap

Attributes returns the Attributes associated with this NumberDataPoint.

func (NumberDataPoint) CopyTo added in v0.31.0

func (ms NumberDataPoint) CopyTo(dest NumberDataPoint)

CopyTo copies all properties from the current struct to the dest.

func (NumberDataPoint) DoubleVal added in v0.31.0

func (ms NumberDataPoint) DoubleVal() float64

DoubleVal returns the doubleval associated with this NumberDataPoint.

func (NumberDataPoint) Exemplars added in v0.31.0

func (ms NumberDataPoint) Exemplars() ExemplarSlice

Exemplars returns the Exemplars associated with this NumberDataPoint.

func (NumberDataPoint) Flags added in v0.37.0

Flags returns the flags associated with this NumberDataPoint.

func (NumberDataPoint) IntVal added in v0.31.0

func (ms NumberDataPoint) IntVal() int64

IntVal returns the intval associated with this NumberDataPoint.

func (NumberDataPoint) SetDoubleVal added in v0.31.0

func (ms NumberDataPoint) SetDoubleVal(v float64)

SetDoubleVal replaces the doubleval associated with this NumberDataPoint.

func (NumberDataPoint) SetFlags added in v0.37.0

func (ms NumberDataPoint) SetFlags(v MetricDataPointFlags)

SetFlags replaces the flags associated with this NumberDataPoint.

func (NumberDataPoint) SetIntVal added in v0.31.0

func (ms NumberDataPoint) SetIntVal(v int64)

SetIntVal replaces the intval associated with this NumberDataPoint.

func (NumberDataPoint) SetStartTimestamp added in v0.31.0

func (ms NumberDataPoint) SetStartTimestamp(v Timestamp)

SetStartTimestamp replaces the starttimestamp associated with this NumberDataPoint.

func (NumberDataPoint) SetTimestamp added in v0.31.0

func (ms NumberDataPoint) SetTimestamp(v Timestamp)

SetTimestamp replaces the timestamp associated with this NumberDataPoint.

func (NumberDataPoint) StartTimestamp added in v0.31.0

func (ms NumberDataPoint) StartTimestamp() Timestamp

StartTimestamp returns the starttimestamp associated with this NumberDataPoint.

func (NumberDataPoint) Timestamp added in v0.31.0

func (ms NumberDataPoint) Timestamp() Timestamp

Timestamp returns the timestamp associated with this NumberDataPoint.

func (NumberDataPoint) Type added in v0.31.0

func (ms NumberDataPoint) Type() MetricValueType

Type returns the type of the value for this NumberDataPoint. Calling this function on zero-initialized NumberDataPoint will cause a panic.

type NumberDataPointSlice added in v0.31.0

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

NumberDataPointSlice logically represents a slice of NumberDataPoint.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewNumberDataPointSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewNumberDataPointSlice added in v0.31.0

func NewNumberDataPointSlice() NumberDataPointSlice

NewNumberDataPointSlice creates a NumberDataPointSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (NumberDataPointSlice) AppendEmpty added in v0.31.0

func (es NumberDataPointSlice) AppendEmpty() NumberDataPoint

AppendEmpty will append to the end of the slice an empty NumberDataPoint. It returns the newly added NumberDataPoint.

func (NumberDataPointSlice) At added in v0.31.0

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (NumberDataPointSlice) CopyTo added in v0.31.0

CopyTo copies all elements from the current slice to the dest.

func (NumberDataPointSlice) EnsureCapacity added in v0.31.0

func (es NumberDataPointSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new NumberDataPointSlice can be initialized:

es := NewNumberDataPointSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (NumberDataPointSlice) Len added in v0.31.0

func (es NumberDataPointSlice) Len() int

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewNumberDataPointSlice()".

func (NumberDataPointSlice) MoveAndAppendTo added in v0.31.0

func (es NumberDataPointSlice) MoveAndAppendTo(dest NumberDataPointSlice)

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (NumberDataPointSlice) RemoveIf added in v0.31.0

func (es NumberDataPointSlice) RemoveIf(f func(NumberDataPoint) bool)

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

func (NumberDataPointSlice) Sort added in v0.31.0

Sort sorts the NumberDataPoint elements within NumberDataPointSlice given the provided less function so that two instances of NumberDataPointSlice can be compared.

Returns the same instance to allow nicer code like:

lessFunc := func(a, b NumberDataPoint) bool {
  return a.Name() < b.Name() // choose any comparison here
}
assert.EqualValues(t, expected.Sort(lessFunc), actual.Sort(lessFunc))

type Resource

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

Resource is a message representing the resource information.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewResource function to create new instances. Important: zero-initialized instance is not valid for use.

func NewResource

func NewResource() Resource

NewResource creates a new empty Resource.

This must be used only in testing code since no "Set" method available.

func (Resource) Attributes

func (ms Resource) Attributes() AttributeMap

Attributes returns the Attributes associated with this Resource.

func (Resource) CopyTo

func (ms Resource) CopyTo(dest Resource)

CopyTo copies all properties from the current struct to the dest.

type ResourceLogs

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

ResourceLogs is a collection of logs from a Resource.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewResourceLogs function to create new instances. Important: zero-initialized instance is not valid for use.

func NewResourceLogs

func NewResourceLogs() ResourceLogs

NewResourceLogs creates a new empty ResourceLogs.

This must be used only in testing code since no "Set" method available.

func (ResourceLogs) CopyTo

func (ms ResourceLogs) CopyTo(dest ResourceLogs)

CopyTo copies all properties from the current struct to the dest.

func (ResourceLogs) InstrumentationLibraryLogs

func (ms ResourceLogs) InstrumentationLibraryLogs() InstrumentationLibraryLogsSlice

InstrumentationLibraryLogs returns the InstrumentationLibraryLogs associated with this ResourceLogs.

func (ResourceLogs) Resource

func (ms ResourceLogs) Resource() Resource

Resource returns the resource associated with this ResourceLogs.

func (ResourceLogs) SchemaUrl added in v0.32.0

func (ms ResourceLogs) SchemaUrl() string

SchemaUrl returns the schemaurl associated with this ResourceLogs.

func (ResourceLogs) SetSchemaUrl added in v0.32.0

func (ms ResourceLogs) SetSchemaUrl(v string)

SetSchemaUrl replaces the schemaurl associated with this ResourceLogs.

type ResourceLogsSlice

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

ResourceLogsSlice logically represents a slice of ResourceLogs.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewResourceLogsSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewResourceLogsSlice

func NewResourceLogsSlice() ResourceLogsSlice

NewResourceLogsSlice creates a ResourceLogsSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (ResourceLogsSlice) AppendEmpty

func (es ResourceLogsSlice) AppendEmpty() ResourceLogs

AppendEmpty will append to the end of the slice an empty ResourceLogs. It returns the newly added ResourceLogs.

func (ResourceLogsSlice) At

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (ResourceLogsSlice) CopyTo

func (es ResourceLogsSlice) CopyTo(dest ResourceLogsSlice)

CopyTo copies all elements from the current slice to the dest.

func (ResourceLogsSlice) EnsureCapacity

func (es ResourceLogsSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new ResourceLogsSlice can be initialized:

es := NewResourceLogsSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (ResourceLogsSlice) Len

func (es ResourceLogsSlice) Len() int

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewResourceLogsSlice()".

func (ResourceLogsSlice) MoveAndAppendTo

func (es ResourceLogsSlice) MoveAndAppendTo(dest ResourceLogsSlice)

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (ResourceLogsSlice) RemoveIf

func (es ResourceLogsSlice) RemoveIf(f func(ResourceLogs) bool)

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

func (ResourceLogsSlice) Sort added in v0.31.0

func (es ResourceLogsSlice) Sort(less func(a, b ResourceLogs) bool) ResourceLogsSlice

Sort sorts the ResourceLogs elements within ResourceLogsSlice given the provided less function so that two instances of ResourceLogsSlice can be compared.

Returns the same instance to allow nicer code like:

lessFunc := func(a, b ResourceLogs) bool {
  return a.Name() < b.Name() // choose any comparison here
}
assert.EqualValues(t, expected.Sort(lessFunc), actual.Sort(lessFunc))

type ResourceMetrics

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

ResourceMetrics is a collection of metrics from a Resource.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewResourceMetrics function to create new instances. Important: zero-initialized instance is not valid for use.

func NewResourceMetrics

func NewResourceMetrics() ResourceMetrics

NewResourceMetrics creates a new empty ResourceMetrics.

This must be used only in testing code since no "Set" method available.

func (ResourceMetrics) CopyTo

func (ms ResourceMetrics) CopyTo(dest ResourceMetrics)

CopyTo copies all properties from the current struct to the dest.

func (ResourceMetrics) InstrumentationLibraryMetrics

func (ms ResourceMetrics) InstrumentationLibraryMetrics() InstrumentationLibraryMetricsSlice

InstrumentationLibraryMetrics returns the InstrumentationLibraryMetrics associated with this ResourceMetrics.

func (ResourceMetrics) Resource

func (ms ResourceMetrics) Resource() Resource

Resource returns the resource associated with this ResourceMetrics.

func (ResourceMetrics) SchemaUrl added in v0.32.0

func (ms ResourceMetrics) SchemaUrl() string

SchemaUrl returns the schemaurl associated with this ResourceMetrics.

func (ResourceMetrics) SetSchemaUrl added in v0.32.0

func (ms ResourceMetrics) SetSchemaUrl(v string)

SetSchemaUrl replaces the schemaurl associated with this ResourceMetrics.

type ResourceMetricsSlice

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

ResourceMetricsSlice logically represents a slice of ResourceMetrics.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewResourceMetricsSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewResourceMetricsSlice

func NewResourceMetricsSlice() ResourceMetricsSlice

NewResourceMetricsSlice creates a ResourceMetricsSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (ResourceMetricsSlice) AppendEmpty

func (es ResourceMetricsSlice) AppendEmpty() ResourceMetrics

AppendEmpty will append to the end of the slice an empty ResourceMetrics. It returns the newly added ResourceMetrics.

func (ResourceMetricsSlice) At

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (ResourceMetricsSlice) CopyTo

CopyTo copies all elements from the current slice to the dest.

func (ResourceMetricsSlice) EnsureCapacity

func (es ResourceMetricsSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new ResourceMetricsSlice can be initialized:

es := NewResourceMetricsSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (ResourceMetricsSlice) Len

func (es ResourceMetricsSlice) Len() int

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewResourceMetricsSlice()".

func (ResourceMetricsSlice) MoveAndAppendTo

func (es ResourceMetricsSlice) MoveAndAppendTo(dest ResourceMetricsSlice)

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (ResourceMetricsSlice) RemoveIf

func (es ResourceMetricsSlice) RemoveIf(f func(ResourceMetrics) bool)

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

func (ResourceMetricsSlice) Sort added in v0.31.0

Sort sorts the ResourceMetrics elements within ResourceMetricsSlice given the provided less function so that two instances of ResourceMetricsSlice can be compared.

Returns the same instance to allow nicer code like:

lessFunc := func(a, b ResourceMetrics) bool {
  return a.Name() < b.Name() // choose any comparison here
}
assert.EqualValues(t, expected.Sort(lessFunc), actual.Sort(lessFunc))

type ResourceSpans

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

ResourceSpans is a collection of spans from a Resource.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewResourceSpans function to create new instances. Important: zero-initialized instance is not valid for use.

func NewResourceSpans

func NewResourceSpans() ResourceSpans

NewResourceSpans creates a new empty ResourceSpans.

This must be used only in testing code since no "Set" method available.

func (ResourceSpans) CopyTo

func (ms ResourceSpans) CopyTo(dest ResourceSpans)

CopyTo copies all properties from the current struct to the dest.

func (ResourceSpans) InstrumentationLibrarySpans

func (ms ResourceSpans) InstrumentationLibrarySpans() InstrumentationLibrarySpansSlice

InstrumentationLibrarySpans returns the InstrumentationLibrarySpans associated with this ResourceSpans.

func (ResourceSpans) Resource

func (ms ResourceSpans) Resource() Resource

Resource returns the resource associated with this ResourceSpans.

func (ResourceSpans) SchemaUrl added in v0.32.0

func (ms ResourceSpans) SchemaUrl() string

SchemaUrl returns the schemaurl associated with this ResourceSpans.

func (ResourceSpans) SetSchemaUrl added in v0.32.0

func (ms ResourceSpans) SetSchemaUrl(v string)

SetSchemaUrl replaces the schemaurl associated with this ResourceSpans.

type ResourceSpansSlice

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

ResourceSpansSlice logically represents a slice of ResourceSpans.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewResourceSpansSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewResourceSpansSlice

func NewResourceSpansSlice() ResourceSpansSlice

NewResourceSpansSlice creates a ResourceSpansSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (ResourceSpansSlice) AppendEmpty

func (es ResourceSpansSlice) AppendEmpty() ResourceSpans

AppendEmpty will append to the end of the slice an empty ResourceSpans. It returns the newly added ResourceSpans.

func (ResourceSpansSlice) At

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (ResourceSpansSlice) CopyTo

func (es ResourceSpansSlice) CopyTo(dest ResourceSpansSlice)

CopyTo copies all elements from the current slice to the dest.

func (ResourceSpansSlice) EnsureCapacity

func (es ResourceSpansSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new ResourceSpansSlice can be initialized:

es := NewResourceSpansSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (ResourceSpansSlice) Len

func (es ResourceSpansSlice) Len() int

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewResourceSpansSlice()".

func (ResourceSpansSlice) MoveAndAppendTo

func (es ResourceSpansSlice) MoveAndAppendTo(dest ResourceSpansSlice)

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (ResourceSpansSlice) RemoveIf

func (es ResourceSpansSlice) RemoveIf(f func(ResourceSpans) bool)

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

func (ResourceSpansSlice) Sort added in v0.31.0

func (es ResourceSpansSlice) Sort(less func(a, b ResourceSpans) bool) ResourceSpansSlice

Sort sorts the ResourceSpans elements within ResourceSpansSlice given the provided less function so that two instances of ResourceSpansSlice can be compared.

Returns the same instance to allow nicer code like:

lessFunc := func(a, b ResourceSpans) bool {
  return a.Name() < b.Name() // choose any comparison here
}
assert.EqualValues(t, expected.Sort(lessFunc), actual.Sort(lessFunc))

type SeverityNumber

type SeverityNumber int32

SeverityNumber is the public alias of otlplogs.SeverityNumber from internal package.

func (SeverityNumber) String

func (sn SeverityNumber) String() string

String returns the string representation of the SeverityNumber.

type Span

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

Span represents a single operation within a trace. See Span definition in OTLP: https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/trace/v1/trace.proto

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewSpan function to create new instances. Important: zero-initialized instance is not valid for use.

func NewSpan

func NewSpan() Span

NewSpan creates a new empty Span.

This must be used only in testing code since no "Set" method available.

func (Span) Attributes

func (ms Span) Attributes() AttributeMap

Attributes returns the Attributes associated with this Span.

func (Span) CopyTo

func (ms Span) CopyTo(dest Span)

CopyTo copies all properties from the current struct to the dest.

func (Span) DroppedAttributesCount

func (ms Span) DroppedAttributesCount() uint32

DroppedAttributesCount returns the droppedattributescount associated with this Span.

func (Span) DroppedEventsCount

func (ms Span) DroppedEventsCount() uint32

DroppedEventsCount returns the droppedeventscount associated with this Span.

func (Span) DroppedLinksCount

func (ms Span) DroppedLinksCount() uint32

DroppedLinksCount returns the droppedlinkscount associated with this Span.

func (Span) EndTimestamp

func (ms Span) EndTimestamp() Timestamp

EndTimestamp returns the endtimestamp associated with this Span.

func (Span) Events

func (ms Span) Events() SpanEventSlice

Events returns the Events associated with this Span.

func (Span) Kind

func (ms Span) Kind() SpanKind

Kind returns the kind associated with this Span.

func (ms Span) Links() SpanLinkSlice

Links returns the Links associated with this Span.

func (Span) Name

func (ms Span) Name() string

Name returns the name associated with this Span.

func (Span) ParentSpanID

func (ms Span) ParentSpanID() SpanID

ParentSpanID returns the parentspanid associated with this Span.

func (Span) SetDroppedAttributesCount

func (ms Span) SetDroppedAttributesCount(v uint32)

SetDroppedAttributesCount replaces the droppedattributescount associated with this Span.

func (Span) SetDroppedEventsCount

func (ms Span) SetDroppedEventsCount(v uint32)

SetDroppedEventsCount replaces the droppedeventscount associated with this Span.

func (Span) SetDroppedLinksCount

func (ms Span) SetDroppedLinksCount(v uint32)

SetDroppedLinksCount replaces the droppedlinkscount associated with this Span.

func (Span) SetEndTimestamp

func (ms Span) SetEndTimestamp(v Timestamp)

SetEndTimestamp replaces the endtimestamp associated with this Span.

func (Span) SetKind

func (ms Span) SetKind(v SpanKind)

SetKind replaces the kind associated with this Span.

func (Span) SetName

func (ms Span) SetName(v string)

SetName replaces the name associated with this Span.

func (Span) SetParentSpanID

func (ms Span) SetParentSpanID(v SpanID)

SetParentSpanID replaces the parentspanid associated with this Span.

func (Span) SetSpanID

func (ms Span) SetSpanID(v SpanID)

SetSpanID replaces the spanid associated with this Span.

func (Span) SetStartTimestamp

func (ms Span) SetStartTimestamp(v Timestamp)

SetStartTimestamp replaces the starttimestamp associated with this Span.

func (Span) SetTraceID

func (ms Span) SetTraceID(v TraceID)

SetTraceID replaces the traceid associated with this Span.

func (Span) SetTraceState

func (ms Span) SetTraceState(v TraceState)

SetTraceState replaces the tracestate associated with this Span.

func (Span) SpanID

func (ms Span) SpanID() SpanID

SpanID returns the spanid associated with this Span.

func (Span) StartTimestamp

func (ms Span) StartTimestamp() Timestamp

StartTimestamp returns the starttimestamp associated with this Span.

func (Span) Status

func (ms Span) Status() SpanStatus

Status returns the status associated with this Span.

func (Span) TraceID

func (ms Span) TraceID() TraceID

TraceID returns the traceid associated with this Span.

func (Span) TraceState

func (ms Span) TraceState() TraceState

TraceState returns the tracestate associated with this Span.

type SpanEvent

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

SpanEvent is a time-stamped annotation of the span, consisting of user-supplied text description and key-value pairs. See OTLP for event definition.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewSpanEvent function to create new instances. Important: zero-initialized instance is not valid for use.

func NewSpanEvent

func NewSpanEvent() SpanEvent

NewSpanEvent creates a new empty SpanEvent.

This must be used only in testing code since no "Set" method available.

func (SpanEvent) Attributes

func (ms SpanEvent) Attributes() AttributeMap

Attributes returns the Attributes associated with this SpanEvent.

func (SpanEvent) CopyTo

func (ms SpanEvent) CopyTo(dest SpanEvent)

CopyTo copies all properties from the current struct to the dest.

func (SpanEvent) DroppedAttributesCount

func (ms SpanEvent) DroppedAttributesCount() uint32

DroppedAttributesCount returns the droppedattributescount associated with this SpanEvent.

func (SpanEvent) Name

func (ms SpanEvent) Name() string

Name returns the name associated with this SpanEvent.

func (SpanEvent) SetDroppedAttributesCount

func (ms SpanEvent) SetDroppedAttributesCount(v uint32)

SetDroppedAttributesCount replaces the droppedattributescount associated with this SpanEvent.

func (SpanEvent) SetName

func (ms SpanEvent) SetName(v string)

SetName replaces the name associated with this SpanEvent.

func (SpanEvent) SetTimestamp

func (ms SpanEvent) SetTimestamp(v Timestamp)

SetTimestamp replaces the timestamp associated with this SpanEvent.

func (SpanEvent) Timestamp

func (ms SpanEvent) Timestamp() Timestamp

Timestamp returns the timestamp associated with this SpanEvent.

type SpanEventSlice

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

SpanEventSlice logically represents a slice of SpanEvent.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewSpanEventSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewSpanEventSlice

func NewSpanEventSlice() SpanEventSlice

NewSpanEventSlice creates a SpanEventSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (SpanEventSlice) AppendEmpty

func (es SpanEventSlice) AppendEmpty() SpanEvent

AppendEmpty will append to the end of the slice an empty SpanEvent. It returns the newly added SpanEvent.

func (SpanEventSlice) At

func (es SpanEventSlice) At(ix int) SpanEvent

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (SpanEventSlice) CopyTo

func (es SpanEventSlice) CopyTo(dest SpanEventSlice)

CopyTo copies all elements from the current slice to the dest.

func (SpanEventSlice) EnsureCapacity

func (es SpanEventSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new SpanEventSlice can be initialized:

es := NewSpanEventSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (SpanEventSlice) Len

func (es SpanEventSlice) Len() int

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewSpanEventSlice()".

func (SpanEventSlice) MoveAndAppendTo

func (es SpanEventSlice) MoveAndAppendTo(dest SpanEventSlice)

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (SpanEventSlice) RemoveIf

func (es SpanEventSlice) RemoveIf(f func(SpanEvent) bool)

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

func (SpanEventSlice) Sort added in v0.31.0

func (es SpanEventSlice) Sort(less func(a, b SpanEvent) bool) SpanEventSlice

Sort sorts the SpanEvent elements within SpanEventSlice given the provided less function so that two instances of SpanEventSlice can be compared.

Returns the same instance to allow nicer code like:

lessFunc := func(a, b SpanEvent) bool {
  return a.Name() < b.Name() // choose any comparison here
}
assert.EqualValues(t, expected.Sort(lessFunc), actual.Sort(lessFunc))

type SpanID

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

SpanID is an alias of OTLP SpanID data type.

func InvalidSpanID

func InvalidSpanID() SpanID

InvalidSpanID returns an empty (all zero bytes) SpanID.

func NewSpanID

func NewSpanID(bytes [8]byte) SpanID

NewSpanID returns a new SpanID from the given byte array.

func (SpanID) Bytes

func (t SpanID) Bytes() [8]byte

Bytes returns the byte array representation of the SpanID.

func (SpanID) HexString

func (t SpanID) HexString() string

HexString returns hex representation of the SpanID.

func (SpanID) IsEmpty

func (t SpanID) IsEmpty() bool

IsEmpty returns true if id doesn't contain at least one non-zero byte.

type SpanKind

type SpanKind int32

SpanKind is the type of span. Can be used to specify additional relationships between spans in addition to a parent/child relationship.

func (SpanKind) String

func (sk SpanKind) String() string

String returns the string representation of the SpanKind.

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

SpanLink is a pointer from the current span to another span in the same trace or in a different trace. See Link definition in OTLP: https://github.com/open-telemetry/opentelemetry-proto/blob/main/opentelemetry/proto/trace/v1/trace.proto

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewSpanLink function to create new instances. Important: zero-initialized instance is not valid for use.

func NewSpanLink() SpanLink

NewSpanLink creates a new empty SpanLink.

This must be used only in testing code since no "Set" method available.

func (SpanLink) Attributes

func (ms SpanLink) Attributes() AttributeMap

Attributes returns the Attributes associated with this SpanLink.

func (SpanLink) CopyTo

func (ms SpanLink) CopyTo(dest SpanLink)

CopyTo copies all properties from the current struct to the dest.

func (SpanLink) DroppedAttributesCount

func (ms SpanLink) DroppedAttributesCount() uint32

DroppedAttributesCount returns the droppedattributescount associated with this SpanLink.

func (SpanLink) SetDroppedAttributesCount

func (ms SpanLink) SetDroppedAttributesCount(v uint32)

SetDroppedAttributesCount replaces the droppedattributescount associated with this SpanLink.

func (SpanLink) SetSpanID

func (ms SpanLink) SetSpanID(v SpanID)

SetSpanID replaces the spanid associated with this SpanLink.

func (SpanLink) SetTraceID

func (ms SpanLink) SetTraceID(v TraceID)

SetTraceID replaces the traceid associated with this SpanLink.

func (SpanLink) SetTraceState

func (ms SpanLink) SetTraceState(v TraceState)

SetTraceState replaces the tracestate associated with this SpanLink.

func (SpanLink) SpanID

func (ms SpanLink) SpanID() SpanID

SpanID returns the spanid associated with this SpanLink.

func (SpanLink) TraceID

func (ms SpanLink) TraceID() TraceID

TraceID returns the traceid associated with this SpanLink.

func (SpanLink) TraceState

func (ms SpanLink) TraceState() TraceState

TraceState returns the tracestate associated with this SpanLink.

type SpanLinkSlice

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

SpanLinkSlice logically represents a slice of SpanLink.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewSpanLinkSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewSpanLinkSlice

func NewSpanLinkSlice() SpanLinkSlice

NewSpanLinkSlice creates a SpanLinkSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (SpanLinkSlice) AppendEmpty

func (es SpanLinkSlice) AppendEmpty() SpanLink

AppendEmpty will append to the end of the slice an empty SpanLink. It returns the newly added SpanLink.

func (SpanLinkSlice) At

func (es SpanLinkSlice) At(ix int) SpanLink

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (SpanLinkSlice) CopyTo

func (es SpanLinkSlice) CopyTo(dest SpanLinkSlice)

CopyTo copies all elements from the current slice to the dest.

func (SpanLinkSlice) EnsureCapacity

func (es SpanLinkSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new SpanLinkSlice can be initialized:

es := NewSpanLinkSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (SpanLinkSlice) Len

func (es SpanLinkSlice) Len() int

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewSpanLinkSlice()".

func (SpanLinkSlice) MoveAndAppendTo

func (es SpanLinkSlice) MoveAndAppendTo(dest SpanLinkSlice)

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (SpanLinkSlice) RemoveIf

func (es SpanLinkSlice) RemoveIf(f func(SpanLink) bool)

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

func (SpanLinkSlice) Sort added in v0.31.0

func (es SpanLinkSlice) Sort(less func(a, b SpanLink) bool) SpanLinkSlice

Sort sorts the SpanLink elements within SpanLinkSlice given the provided less function so that two instances of SpanLinkSlice can be compared.

Returns the same instance to allow nicer code like:

lessFunc := func(a, b SpanLink) bool {
  return a.Name() < b.Name() // choose any comparison here
}
assert.EqualValues(t, expected.Sort(lessFunc), actual.Sort(lessFunc))

type SpanSlice

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

SpanSlice logically represents a slice of Span.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewSpanSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewSpanSlice

func NewSpanSlice() SpanSlice

NewSpanSlice creates a SpanSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (SpanSlice) AppendEmpty

func (es SpanSlice) AppendEmpty() Span

AppendEmpty will append to the end of the slice an empty Span. It returns the newly added Span.

func (SpanSlice) At

func (es SpanSlice) At(ix int) Span

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (SpanSlice) CopyTo

func (es SpanSlice) CopyTo(dest SpanSlice)

CopyTo copies all elements from the current slice to the dest.

func (SpanSlice) EnsureCapacity

func (es SpanSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new SpanSlice can be initialized:

es := NewSpanSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (SpanSlice) Len

func (es SpanSlice) Len() int

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewSpanSlice()".

func (SpanSlice) MoveAndAppendTo

func (es SpanSlice) MoveAndAppendTo(dest SpanSlice)

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (SpanSlice) RemoveIf

func (es SpanSlice) RemoveIf(f func(Span) bool)

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

func (SpanSlice) Sort added in v0.31.0

func (es SpanSlice) Sort(less func(a, b Span) bool) SpanSlice

Sort sorts the Span elements within SpanSlice given the provided less function so that two instances of SpanSlice can be compared.

Returns the same instance to allow nicer code like:

lessFunc := func(a, b Span) bool {
  return a.Name() < b.Name() // choose any comparison here
}
assert.EqualValues(t, expected.Sort(lessFunc), actual.Sort(lessFunc))

type SpanStatus

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

SpanStatus is an optional final status for this span. Semantically, when Status was not set, that means the span ended without errors and to assume Status.Ok (code = 0).

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewSpanStatus function to create new instances. Important: zero-initialized instance is not valid for use.

func NewSpanStatus

func NewSpanStatus() SpanStatus

NewSpanStatus creates a new empty SpanStatus.

This must be used only in testing code since no "Set" method available.

func (SpanStatus) Code

func (ms SpanStatus) Code() StatusCode

Code returns the code associated with this SpanStatus.

func (SpanStatus) CopyTo

func (ms SpanStatus) CopyTo(dest SpanStatus)

CopyTo copies all properties from the current struct to the dest.

func (SpanStatus) Message

func (ms SpanStatus) Message() string

Message returns the message associated with this SpanStatus.

func (SpanStatus) SetCode

func (ms SpanStatus) SetCode(v StatusCode)

SetCode replaces the code associated with this SpanStatus.

func (SpanStatus) SetMessage

func (ms SpanStatus) SetMessage(v string)

SetMessage replaces the message associated with this SpanStatus.

type StatusCode

type StatusCode int32

StatusCode mirrors the codes defined at https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/trace/api.md#set-status

func (StatusCode) String

func (sc StatusCode) String() string

String returns the string representation of the StatusCode.

type Sum

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

Sum represents the type of a numeric double scalar metric that is calculated as a sum of all reported measurements over a time interval.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewSum function to create new instances. Important: zero-initialized instance is not valid for use.

func NewSum

func NewSum() Sum

NewSum creates a new empty Sum.

This must be used only in testing code since no "Set" method available.

func (Sum) AggregationTemporality

func (ms Sum) AggregationTemporality() MetricAggregationTemporality

AggregationTemporality returns the aggregationtemporality associated with this Sum.

func (Sum) CopyTo

func (ms Sum) CopyTo(dest Sum)

CopyTo copies all properties from the current struct to the dest.

func (Sum) DataPoints

func (ms Sum) DataPoints() NumberDataPointSlice

DataPoints returns the DataPoints associated with this Sum.

func (Sum) IsMonotonic

func (ms Sum) IsMonotonic() bool

IsMonotonic returns the ismonotonic associated with this Sum.

func (Sum) SetAggregationTemporality

func (ms Sum) SetAggregationTemporality(v MetricAggregationTemporality)

SetAggregationTemporality replaces the aggregationtemporality associated with this Sum.

func (Sum) SetIsMonotonic

func (ms Sum) SetIsMonotonic(v bool)

SetIsMonotonic replaces the ismonotonic associated with this Sum.

type Summary

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

Summary represents the type of a metric that is calculated by aggregating as a Summary of all reported double measurements over a time interval.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewSummary function to create new instances. Important: zero-initialized instance is not valid for use.

func NewSummary

func NewSummary() Summary

NewSummary creates a new empty Summary.

This must be used only in testing code since no "Set" method available.

func (Summary) CopyTo

func (ms Summary) CopyTo(dest Summary)

CopyTo copies all properties from the current struct to the dest.

func (Summary) DataPoints

func (ms Summary) DataPoints() SummaryDataPointSlice

DataPoints returns the DataPoints associated with this Summary.

type SummaryDataPoint

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

SummaryDataPoint is a single data point in a timeseries that describes the time-varying values of a Summary of double values.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewSummaryDataPoint function to create new instances. Important: zero-initialized instance is not valid for use.

func NewSummaryDataPoint

func NewSummaryDataPoint() SummaryDataPoint

NewSummaryDataPoint creates a new empty SummaryDataPoint.

This must be used only in testing code since no "Set" method available.

func (SummaryDataPoint) Attributes added in v0.32.0

func (ms SummaryDataPoint) Attributes() AttributeMap

Attributes returns the Attributes associated with this SummaryDataPoint.

func (SummaryDataPoint) CopyTo

func (ms SummaryDataPoint) CopyTo(dest SummaryDataPoint)

CopyTo copies all properties from the current struct to the dest.

func (SummaryDataPoint) Count

func (ms SummaryDataPoint) Count() uint64

Count returns the count associated with this SummaryDataPoint.

func (SummaryDataPoint) Flags added in v0.37.0

Flags returns the flags associated with this SummaryDataPoint.

func (SummaryDataPoint) QuantileValues

func (ms SummaryDataPoint) QuantileValues() ValueAtQuantileSlice

QuantileValues returns the QuantileValues associated with this SummaryDataPoint.

func (SummaryDataPoint) SetCount

func (ms SummaryDataPoint) SetCount(v uint64)

SetCount replaces the count associated with this SummaryDataPoint.

func (SummaryDataPoint) SetFlags added in v0.37.0

func (ms SummaryDataPoint) SetFlags(v MetricDataPointFlags)

SetFlags replaces the flags associated with this SummaryDataPoint.

func (SummaryDataPoint) SetStartTimestamp

func (ms SummaryDataPoint) SetStartTimestamp(v Timestamp)

SetStartTimestamp replaces the starttimestamp associated with this SummaryDataPoint.

func (SummaryDataPoint) SetSum

func (ms SummaryDataPoint) SetSum(v float64)

SetSum replaces the sum associated with this SummaryDataPoint.

func (SummaryDataPoint) SetTimestamp

func (ms SummaryDataPoint) SetTimestamp(v Timestamp)

SetTimestamp replaces the timestamp associated with this SummaryDataPoint.

func (SummaryDataPoint) StartTimestamp

func (ms SummaryDataPoint) StartTimestamp() Timestamp

StartTimestamp returns the starttimestamp associated with this SummaryDataPoint.

func (SummaryDataPoint) Sum

func (ms SummaryDataPoint) Sum() float64

Sum returns the sum associated with this SummaryDataPoint.

func (SummaryDataPoint) Timestamp

func (ms SummaryDataPoint) Timestamp() Timestamp

Timestamp returns the timestamp associated with this SummaryDataPoint.

type SummaryDataPointSlice

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

SummaryDataPointSlice logically represents a slice of SummaryDataPoint.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewSummaryDataPointSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewSummaryDataPointSlice

func NewSummaryDataPointSlice() SummaryDataPointSlice

NewSummaryDataPointSlice creates a SummaryDataPointSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (SummaryDataPointSlice) AppendEmpty

func (es SummaryDataPointSlice) AppendEmpty() SummaryDataPoint

AppendEmpty will append to the end of the slice an empty SummaryDataPoint. It returns the newly added SummaryDataPoint.

func (SummaryDataPointSlice) At

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (SummaryDataPointSlice) CopyTo

CopyTo copies all elements from the current slice to the dest.

func (SummaryDataPointSlice) EnsureCapacity

func (es SummaryDataPointSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new SummaryDataPointSlice can be initialized:

es := NewSummaryDataPointSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (SummaryDataPointSlice) Len

func (es SummaryDataPointSlice) Len() int

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewSummaryDataPointSlice()".

func (SummaryDataPointSlice) MoveAndAppendTo

func (es SummaryDataPointSlice) MoveAndAppendTo(dest SummaryDataPointSlice)

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (SummaryDataPointSlice) RemoveIf

func (es SummaryDataPointSlice) RemoveIf(f func(SummaryDataPoint) bool)

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

func (SummaryDataPointSlice) Sort added in v0.31.0

Sort sorts the SummaryDataPoint elements within SummaryDataPointSlice given the provided less function so that two instances of SummaryDataPointSlice can be compared.

Returns the same instance to allow nicer code like:

lessFunc := func(a, b SummaryDataPoint) bool {
  return a.Name() < b.Name() // choose any comparison here
}
assert.EqualValues(t, expected.Sort(lessFunc), actual.Sort(lessFunc))

type Timestamp

type Timestamp uint64

Timestamp is a time specified as UNIX Epoch time in nanoseconds since 00:00:00 UTC on 1 January 1970.

func NewTimestampFromTime added in v0.34.0

func NewTimestampFromTime(t time.Time) Timestamp

NewTimestampFromTime constructs a new Timestamp from the provided time.Time.

func (Timestamp) AsTime

func (ts Timestamp) AsTime() time.Time

AsTime converts this to a time.Time.

func (Timestamp) String

func (ts Timestamp) String() string

String returns the string representation of this in UTC.

type TraceID

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

TraceID is an alias of OTLP TraceID data type.

func InvalidTraceID

func InvalidTraceID() TraceID

InvalidTraceID returns an empty (all zero bytes) TraceID.

func NewTraceID

func NewTraceID(bytes [16]byte) TraceID

NewTraceID returns a new TraceID from the given byte array.

func (TraceID) Bytes

func (t TraceID) Bytes() [16]byte

Bytes returns the byte array representation of the TraceID.

func (TraceID) HexString

func (t TraceID) HexString() string

HexString returns hex representation of the TraceID.

func (TraceID) IsEmpty

func (t TraceID) IsEmpty() bool

IsEmpty returns true if id doesn't contain at least one non-zero byte.

type TraceState

type TraceState string

TraceState is a string representing the tracestate in w3c-trace-context format: https://www.w3.org/TR/trace-context/#tracestate-header

const (
	// TraceStateEmpty represents the empty TraceState.
	TraceStateEmpty TraceState = ""
)

type Traces

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

Traces is the top-level struct that is propagated through the traces pipeline.

func NewTraces

func NewTraces() Traces

NewTraces creates a new Traces.

func TracesFromInternalRep

func TracesFromInternalRep(wrapper internal.TracesWrapper) Traces

TracesFromInternalRep creates Traces from the internal representation. Should not be used outside this module.

func (Traces) Clone

func (td Traces) Clone() Traces

Clone returns a copy of Traces.

func (Traces) InternalRep

func (td Traces) InternalRep() internal.TracesWrapper

InternalRep returns internal representation of the Traces. Should not be used outside this module.

func (Traces) ResourceSpans

func (td Traces) ResourceSpans() ResourceSpansSlice

ResourceSpans returns the ResourceSpansSlice associated with this Metrics.

func (Traces) SpanCount

func (td Traces) SpanCount() int

SpanCount calculates the total number of spans.

type TracesMarshaler

type TracesMarshaler interface {
	// MarshalTraces the given pdata.Traces into bytes.
	// If the error is not nil, the returned bytes slice cannot be used.
	MarshalTraces(td Traces) ([]byte, error)
}

TracesMarshaler marshals pdata.Traces into bytes.

type TracesSizer added in v0.33.0

type TracesSizer interface {
	// TracesSize returns the size in bytes of a marshaled Traces.
	TracesSize(td Traces) int
}

TracesSizer is an optional interface implemented by the TracesMarshaler, that calculates the size of a marshaled Traces.

type TracesUnmarshaler

type TracesUnmarshaler interface {
	// UnmarshalTraces the given bytes into pdata.Traces.
	// If the error is not nil, the returned pdata.Traces cannot be used.
	UnmarshalTraces(buf []byte) (Traces, error)
}

TracesUnmarshaler unmarshalls bytes into pdata.Traces.

type ValueAtQuantile

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

ValueAtQuantile is a quantile value within a Summary data point.

This is a reference type, if passed by value and callee modifies it the caller will see the modification.

Must use NewValueAtQuantile function to create new instances. Important: zero-initialized instance is not valid for use.

func NewValueAtQuantile

func NewValueAtQuantile() ValueAtQuantile

NewValueAtQuantile creates a new empty ValueAtQuantile.

This must be used only in testing code since no "Set" method available.

func (ValueAtQuantile) CopyTo

func (ms ValueAtQuantile) CopyTo(dest ValueAtQuantile)

CopyTo copies all properties from the current struct to the dest.

func (ValueAtQuantile) Quantile

func (ms ValueAtQuantile) Quantile() float64

Quantile returns the quantile associated with this ValueAtQuantile.

func (ValueAtQuantile) SetQuantile

func (ms ValueAtQuantile) SetQuantile(v float64)

SetQuantile replaces the quantile associated with this ValueAtQuantile.

func (ValueAtQuantile) SetValue

func (ms ValueAtQuantile) SetValue(v float64)

SetValue replaces the value associated with this ValueAtQuantile.

func (ValueAtQuantile) Value

func (ms ValueAtQuantile) Value() float64

Value returns the value associated with this ValueAtQuantile.

type ValueAtQuantileSlice

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

ValueAtQuantileSlice logically represents a slice of ValueAtQuantile.

This is a reference type. If passed by value and callee modifies it, the caller will see the modification.

Must use NewValueAtQuantileSlice function to create new instances. Important: zero-initialized instance is not valid for use.

func NewValueAtQuantileSlice

func NewValueAtQuantileSlice() ValueAtQuantileSlice

NewValueAtQuantileSlice creates a ValueAtQuantileSlice with 0 elements. Can use "EnsureCapacity" to initialize with a given capacity.

func (ValueAtQuantileSlice) AppendEmpty

func (es ValueAtQuantileSlice) AppendEmpty() ValueAtQuantile

AppendEmpty will append to the end of the slice an empty ValueAtQuantile. It returns the newly added ValueAtQuantile.

func (ValueAtQuantileSlice) At

At returns the element at the given index.

This function is used mostly for iterating over all the values in the slice:

for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    ... // Do something with the element
}

func (ValueAtQuantileSlice) CopyTo

CopyTo copies all elements from the current slice to the dest.

func (ValueAtQuantileSlice) EnsureCapacity

func (es ValueAtQuantileSlice) EnsureCapacity(newCap int)

EnsureCapacity is an operation that ensures the slice has at least the specified capacity. 1. If the newCap <= cap then no change in capacity. 2. If the newCap > cap then the slice capacity will be expanded to equal newCap.

Here is how a new ValueAtQuantileSlice can be initialized:

es := NewValueAtQuantileSlice()
es.EnsureCapacity(4)
for i := 0; i < 4; i++ {
    e := es.AppendEmpty()
    // Here should set all the values for e.
}

func (ValueAtQuantileSlice) Len

func (es ValueAtQuantileSlice) Len() int

Len returns the number of elements in the slice.

Returns "0" for a newly instance created with "NewValueAtQuantileSlice()".

func (ValueAtQuantileSlice) MoveAndAppendTo

func (es ValueAtQuantileSlice) MoveAndAppendTo(dest ValueAtQuantileSlice)

MoveAndAppendTo moves all elements from the current slice and appends them to the dest. The current slice will be cleared.

func (ValueAtQuantileSlice) RemoveIf

func (es ValueAtQuantileSlice) RemoveIf(f func(ValueAtQuantile) bool)

RemoveIf calls f sequentially for each element present in the slice. If f returns true, the element is removed from the slice.

func (ValueAtQuantileSlice) Sort added in v0.31.0

Sort sorts the ValueAtQuantile elements within ValueAtQuantileSlice given the provided less function so that two instances of ValueAtQuantileSlice can be compared.

Returns the same instance to allow nicer code like:

lessFunc := func(a, b ValueAtQuantile) bool {
  return a.Name() < b.Name() // choose any comparison here
}
assert.EqualValues(t, expected.Sort(lessFunc), actual.Sort(lessFunc))

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
t or T : Toggle theme light dark auto
y or Y : Canonical URL