pdata

package
v0.29.0 Latest Latest
Warning

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

Go to latest
Published: Jun 22, 2021 License: Apache-2.0 Imports: 13 Imported by: 0

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 (
	// AggregationTemporalityUnspecified is the default AggregationTemporality, it MUST NOT be used.
	AggregationTemporalityUnspecified = AggregationTemporality(otlpmetrics.AggregationTemporality_AGGREGATION_TEMPORALITY_UNSPECIFIED)
	// AggregationTemporalityDelta is an AggregationTemporality for a metric aggregator which reports changes since last report time.
	AggregationTemporalityDelta = AggregationTemporality(otlpmetrics.AggregationTemporality_AGGREGATION_TEMPORALITY_DELTA)
	// AggregationTemporalityCumulative is an AggregationTemporality for a metric aggregator which reports changes since a fixed start time.
	AggregationTemporalityCumulative = AggregationTemporality(otlpmetrics.AggregationTemporality_AGGREGATION_TEMPORALITY_CUMULATIVE)
)
View Source
const (
	// SpanKindUnspecified represents that the SpanKind is unspecified, it MUST NOT be used.
	SpanKindUnspecified = SpanKind(0)
	// 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)
)

Variables

This section is empty.

Functions

func NewErrIncompatibleType added in v0.29.0

func NewErrIncompatibleType(expected, given interface{}) error

NewErrIncompatibleType returns errIncompatibleType instance

Types

type AggregationTemporality added in v0.10.0

type AggregationTemporality int32

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

func (AggregationTemporality) String added in v0.10.0

func (at AggregationTemporality) String() string

String returns the string representation of the AggregationTemporality.

type AnyValueArray added in v0.9.0

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 added in v0.9.0

func NewAnyValueArray() AnyValueArray

NewAnyValueArray creates a AnyValueArray with 0 elements. Can use "Resize" to initialize with a given length.

func (AnyValueArray) Append added in v0.9.0

func (es AnyValueArray) Append(e AttributeValue)

Append will increase the length of the AnyValueArray by one and set the given AttributeValue at that new position. The original AttributeValue could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (AnyValueArray) AppendEmpty added in v0.26.0

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 added in v0.9.0

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 added in v0.9.0

func (es AnyValueArray) CopyTo(dest AnyValueArray)

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

func (AnyValueArray) Len added in v0.9.0

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 added in v0.9.0

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 added in v0.26.0

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.

func (AnyValueArray) Resize added in v0.9.0

func (es AnyValueArray) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new AnyValueArray can be initialized:

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

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 (AttributeMap) Clear added in v0.25.0

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 added in v0.25.0

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

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]string.

Returns the same instance to allow nicer code like:

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

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) 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 added in v0.5.0

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 added in v0.25.0

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:

it := sm.Range(func(k string, v AttributeValue) {
    ...
})

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) 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 insert 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 insert 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) UpsertDouble

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

UpsertDouble performs the Insert or Update action. The double Value is insert 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 insert 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 insert 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 represents a 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.:

function f1(val AttributeValue) { val.SetIntVal(234) }
function 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 added in v0.9.0

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 NewAttributeValueDouble

func NewAttributeValueDouble(v float64) AttributeValue

NewAttributeValueDouble creates a new AttributeValue with the given float64 value.

func NewAttributeValueInt

func NewAttributeValueInt(v int64) AttributeValue

NewAttributeValueInt creates a new AttributeValue with the given int64 value.

func NewAttributeValueMap added in v0.5.0

func NewAttributeValueMap() AttributeValue

NewAttributeValueMap creates a new AttributeValue of map type.

func NewAttributeValueNull added in v0.5.0

func NewAttributeValueNull() AttributeValue

NewAttributeValueNull creates a new AttributeValue with a null value.

func NewAttributeValueString

func NewAttributeValueString(v string) AttributeValue

NewAttributeValueString creates a new AttributeValue with the given string value.

func (AttributeValue) ArrayVal added in v0.9.0

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) 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) 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 added in v0.5.0

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) 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) 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) 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 (
	AttributeValueTypeNull AttributeValueType = iota
	AttributeValueTypeString
	AttributeValueTypeInt
	AttributeValueTypeDouble
	AttributeValueTypeBool
	AttributeValueTypeMap
	AttributeValueTypeArray
)

func (AttributeValueType) String

func (avt AttributeValueType) String() string

String returns the string representation of the AttributeValueType.

type DoubleDataPoint

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

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

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

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

func NewDoubleDataPoint

func NewDoubleDataPoint() DoubleDataPoint

NewDoubleDataPoint creates a new empty DoubleDataPoint.

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

func (DoubleDataPoint) CopyTo

func (ms DoubleDataPoint) CopyTo(dest DoubleDataPoint)

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

func (DoubleDataPoint) Exemplars added in v0.10.0

func (ms DoubleDataPoint) Exemplars() ExemplarSlice

Exemplars returns the Exemplars associated with this DoubleDataPoint.

func (DoubleDataPoint) LabelsMap

func (ms DoubleDataPoint) LabelsMap() StringMap

LabelsMap returns the Labels associated with this DoubleDataPoint.

func (DoubleDataPoint) SetStartTimestamp added in v0.24.0

func (ms DoubleDataPoint) SetStartTimestamp(v Timestamp)

SetStartTimestamp replaces the starttimestamp associated with this DoubleDataPoint.

func (DoubleDataPoint) SetTimestamp

func (ms DoubleDataPoint) SetTimestamp(v Timestamp)

SetTimestamp replaces the timestamp associated with this DoubleDataPoint.

func (DoubleDataPoint) SetValue

func (ms DoubleDataPoint) SetValue(v float64)

SetValue replaces the value associated with this DoubleDataPoint.

func (DoubleDataPoint) StartTimestamp added in v0.24.0

func (ms DoubleDataPoint) StartTimestamp() Timestamp

StartTimestamp returns the starttimestamp associated with this DoubleDataPoint.

func (DoubleDataPoint) Timestamp

func (ms DoubleDataPoint) Timestamp() Timestamp

Timestamp returns the timestamp associated with this DoubleDataPoint.

func (DoubleDataPoint) Value

func (ms DoubleDataPoint) Value() float64

Value returns the value associated with this DoubleDataPoint.

type DoubleDataPointSlice

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

DoubleDataPointSlice logically represents a slice of DoubleDataPoint.

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

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

func NewDoubleDataPointSlice

func NewDoubleDataPointSlice() DoubleDataPointSlice

NewDoubleDataPointSlice creates a DoubleDataPointSlice with 0 elements. Can use "Resize" to initialize with a given length.

func (DoubleDataPointSlice) Append added in v0.5.0

Append will increase the length of the DoubleDataPointSlice by one and set the given DoubleDataPoint at that new position. The original DoubleDataPoint could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (DoubleDataPointSlice) AppendEmpty added in v0.26.0

func (es DoubleDataPointSlice) AppendEmpty() DoubleDataPoint

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

func (DoubleDataPointSlice) 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 (DoubleDataPointSlice) CopyTo

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

func (DoubleDataPointSlice) Len

func (es DoubleDataPointSlice) Len() int

Len returns the number of elements in the slice.

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

func (DoubleDataPointSlice) MoveAndAppendTo

func (es DoubleDataPointSlice) MoveAndAppendTo(dest DoubleDataPointSlice)

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

func (DoubleDataPointSlice) RemoveIf added in v0.26.0

func (es DoubleDataPointSlice) RemoveIf(f func(DoubleDataPoint) bool)

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

func (DoubleDataPointSlice) Resize

func (es DoubleDataPointSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new DoubleDataPointSlice can be initialized:

es := NewDoubleDataPointSlice()
es.Resize(4)
for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    // Here should set all the values for e.
}

type DoubleGauge added in v0.10.0

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

DoubleGauge 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 NewDoubleGauge function to create new instances. Important: zero-initialized instance is not valid for use.

func NewDoubleGauge added in v0.10.0

func NewDoubleGauge() DoubleGauge

NewDoubleGauge creates a new empty DoubleGauge.

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

func (DoubleGauge) CopyTo added in v0.10.0

func (ms DoubleGauge) CopyTo(dest DoubleGauge)

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

func (DoubleGauge) DataPoints added in v0.10.0

func (ms DoubleGauge) DataPoints() DoubleDataPointSlice

DataPoints returns the DataPoints associated with this DoubleGauge.

type DoubleSum added in v0.10.0

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

DoubleSum 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 NewDoubleSum function to create new instances. Important: zero-initialized instance is not valid for use.

func NewDoubleSum added in v0.10.0

func NewDoubleSum() DoubleSum

NewDoubleSum creates a new empty DoubleSum.

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

func (DoubleSum) AggregationTemporality added in v0.10.0

func (ms DoubleSum) AggregationTemporality() AggregationTemporality

AggregationTemporality returns the aggregationtemporality associated with this DoubleSum.

func (DoubleSum) CopyTo added in v0.10.0

func (ms DoubleSum) CopyTo(dest DoubleSum)

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

func (DoubleSum) DataPoints added in v0.10.0

func (ms DoubleSum) DataPoints() DoubleDataPointSlice

DataPoints returns the DataPoints associated with this DoubleSum.

func (DoubleSum) IsMonotonic added in v0.10.0

func (ms DoubleSum) IsMonotonic() bool

IsMonotonic returns the ismonotonic associated with this DoubleSum.

func (DoubleSum) SetAggregationTemporality added in v0.10.0

func (ms DoubleSum) SetAggregationTemporality(v AggregationTemporality)

SetAggregationTemporality replaces the aggregationtemporality associated with this DoubleSum.

func (DoubleSum) SetIsMonotonic added in v0.10.0

func (ms DoubleSum) SetIsMonotonic(v bool)

SetIsMonotonic replaces the ismonotonic associated with this DoubleSum.

type Exemplar added in v0.24.0

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 added in v0.24.0

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 added in v0.24.0

func (ms Exemplar) CopyTo(dest Exemplar)

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

func (Exemplar) FilteredLabels added in v0.24.0

func (ms Exemplar) FilteredLabels() StringMap

FilteredLabels returns the FilteredLabels associated with this Exemplar.

func (Exemplar) SetTimestamp added in v0.24.0

func (ms Exemplar) SetTimestamp(v Timestamp)

SetTimestamp replaces the timestamp associated with this Exemplar.

func (Exemplar) SetValue added in v0.24.0

func (ms Exemplar) SetValue(v float64)

SetValue replaces the value associated with this Exemplar.

func (Exemplar) Timestamp added in v0.24.0

func (ms Exemplar) Timestamp() Timestamp

Timestamp returns the timestamp associated with this Exemplar.

func (Exemplar) Value added in v0.24.0

func (ms Exemplar) Value() float64

Value returns the value associated with this Exemplar.

type ExemplarSlice added in v0.24.0

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 added in v0.24.0

func NewExemplarSlice() ExemplarSlice

NewExemplarSlice creates a ExemplarSlice with 0 elements. Can use "Resize" to initialize with a given length.

func (ExemplarSlice) Append added in v0.24.0

func (es ExemplarSlice) Append(e Exemplar)

Append will increase the length of the ExemplarSlice by one and set the given Exemplar at that new position. The original Exemplar could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (ExemplarSlice) AppendEmpty added in v0.26.0

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 added in v0.24.0

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 added in v0.24.0

func (es ExemplarSlice) CopyTo(dest ExemplarSlice)

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

func (ExemplarSlice) Len added in v0.24.0

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 added in v0.24.0

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 added in v0.26.0

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.

func (ExemplarSlice) Resize added in v0.24.0

func (es ExemplarSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new ExemplarSlice can be initialized:

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

type FromLogsTranslator added in v0.29.0

type FromLogsTranslator interface {
	// FromLogs translates pdata.Logs into protocol-specific data model.
	// If the error is not nil, the returned pdata.Logs cannot be used.
	FromLogs(ld Logs) (interface{}, error)
}

FromLogsTranslator is an interface to translate pdata.Logs into protocol-specific data model.

type FromMetricsTranslator added in v0.29.0

type FromMetricsTranslator interface {
	// FromMetrics translates pdata.Metrics into protocol-specific data model.
	// If the error is not nil, the returned pdata.Metrics cannot be used.
	FromMetrics(md Metrics) (interface{}, error)
}

FromMetricsTranslator is an interface to translate pdata.Metrics into protocol-specific data model.

type FromTracesTranslator added in v0.29.0

type FromTracesTranslator interface {
	// FromTraces translates pdata.Traces into protocol-specific data model.
	// If the error is not nil, the returned pdata.Traces cannot be used.
	FromTraces(td Traces) (interface{}, error)
}

FromTracesTranslator is an interface to translate pdata.Traces into protocol-specific data model.

type Histogram added in v0.24.0

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 added in v0.24.0

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 added in v0.24.0

func (ms Histogram) AggregationTemporality() AggregationTemporality

AggregationTemporality returns the aggregationtemporality associated with this Histogram.

func (Histogram) CopyTo added in v0.24.0

func (ms Histogram) CopyTo(dest Histogram)

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

func (Histogram) DataPoints added in v0.24.0

func (ms Histogram) DataPoints() HistogramDataPointSlice

DataPoints returns the DataPoints associated with this Histogram.

func (Histogram) SetAggregationTemporality added in v0.24.0

func (ms Histogram) SetAggregationTemporality(v AggregationTemporality)

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) BucketCounts added in v0.24.0

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 added in v0.24.0

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) LabelsMap

func (ms HistogramDataPoint) LabelsMap() StringMap

LabelsMap returns the Labels associated with this HistogramDataPoint.

func (HistogramDataPoint) SetBucketCounts added in v0.24.0

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) SetStartTimestamp added in v0.24.0

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 added in v0.24.0

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 "Resize" to initialize with a given length.

func (HistogramDataPointSlice) Append added in v0.5.0

Append will increase the length of the HistogramDataPointSlice by one and set the given HistogramDataPoint at that new position. The original HistogramDataPoint could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (HistogramDataPointSlice) AppendEmpty added in v0.26.0

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) 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 added in v0.26.0

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) Resize

func (es HistogramDataPointSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new HistogramDataPointSlice can be initialized:

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

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 added in v0.7.0

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 added in v0.7.0

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 added in v0.7.0

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

func (InstrumentationLibraryLogs) InstrumentationLibrary added in v0.7.0

func (ms InstrumentationLibraryLogs) InstrumentationLibrary() InstrumentationLibrary

InstrumentationLibrary returns the instrumentationlibrary associated with this InstrumentationLibraryLogs.

func (InstrumentationLibraryLogs) Logs added in v0.7.0

Logs returns the Logs associated with this InstrumentationLibraryLogs.

type InstrumentationLibraryLogsSlice added in v0.7.0

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 added in v0.7.0

func NewInstrumentationLibraryLogsSlice() InstrumentationLibraryLogsSlice

NewInstrumentationLibraryLogsSlice creates a InstrumentationLibraryLogsSlice with 0 elements. Can use "Resize" to initialize with a given length.

func (InstrumentationLibraryLogsSlice) Append added in v0.7.0

Append will increase the length of the InstrumentationLibraryLogsSlice by one and set the given InstrumentationLibraryLogs at that new position. The original InstrumentationLibraryLogs could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (InstrumentationLibraryLogsSlice) AppendEmpty added in v0.26.0

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

func (InstrumentationLibraryLogsSlice) At added in v0.7.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 (InstrumentationLibraryLogsSlice) CopyTo added in v0.7.0

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

func (InstrumentationLibraryLogsSlice) Len added in v0.7.0

Len returns the number of elements in the slice.

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

func (InstrumentationLibraryLogsSlice) MoveAndAppendTo added in v0.7.0

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

func (InstrumentationLibraryLogsSlice) RemoveIf added in v0.26.0

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

func (InstrumentationLibraryLogsSlice) Resize added in v0.7.0

func (es InstrumentationLibraryLogsSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new InstrumentationLibraryLogsSlice can be initialized:

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

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.

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 "Resize" to initialize with a given length.

func (InstrumentationLibraryMetricsSlice) Append added in v0.5.0

Append will increase the length of the InstrumentationLibraryMetricsSlice by one and set the given InstrumentationLibraryMetrics at that new position. The original InstrumentationLibraryMetrics could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (InstrumentationLibraryMetricsSlice) AppendEmpty added in v0.26.0

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) 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 added in v0.26.0

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

func (InstrumentationLibraryMetricsSlice) Resize

func (es InstrumentationLibraryMetricsSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new InstrumentationLibraryMetricsSlice can be initialized:

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

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) 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 "Resize" to initialize with a given length.

func (InstrumentationLibrarySpansSlice) Append added in v0.5.0

Append will increase the length of the InstrumentationLibrarySpansSlice by one and set the given InstrumentationLibrarySpans at that new position. The original InstrumentationLibrarySpans could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (InstrumentationLibrarySpansSlice) AppendEmpty added in v0.26.0

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) 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 added in v0.26.0

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

func (InstrumentationLibrarySpansSlice) Resize

func (es InstrumentationLibrarySpansSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new InstrumentationLibrarySpansSlice can be initialized:

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

type IntDataPoint added in v0.10.0

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

IntDataPoint is a single data point in a timeseries that describes the time-varying values of a scalar int metric.

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

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

func NewIntDataPoint added in v0.10.0

func NewIntDataPoint() IntDataPoint

NewIntDataPoint creates a new empty IntDataPoint.

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

func (IntDataPoint) CopyTo added in v0.10.0

func (ms IntDataPoint) CopyTo(dest IntDataPoint)

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

func (IntDataPoint) Exemplars added in v0.10.0

func (ms IntDataPoint) Exemplars() IntExemplarSlice

Exemplars returns the Exemplars associated with this IntDataPoint.

func (IntDataPoint) LabelsMap added in v0.10.0

func (ms IntDataPoint) LabelsMap() StringMap

LabelsMap returns the Labels associated with this IntDataPoint.

func (IntDataPoint) SetStartTimestamp added in v0.24.0

func (ms IntDataPoint) SetStartTimestamp(v Timestamp)

SetStartTimestamp replaces the starttimestamp associated with this IntDataPoint.

func (IntDataPoint) SetTimestamp added in v0.10.0

func (ms IntDataPoint) SetTimestamp(v Timestamp)

SetTimestamp replaces the timestamp associated with this IntDataPoint.

func (IntDataPoint) SetValue added in v0.10.0

func (ms IntDataPoint) SetValue(v int64)

SetValue replaces the value associated with this IntDataPoint.

func (IntDataPoint) StartTimestamp added in v0.24.0

func (ms IntDataPoint) StartTimestamp() Timestamp

StartTimestamp returns the starttimestamp associated with this IntDataPoint.

func (IntDataPoint) Timestamp added in v0.10.0

func (ms IntDataPoint) Timestamp() Timestamp

Timestamp returns the timestamp associated with this IntDataPoint.

func (IntDataPoint) Value added in v0.10.0

func (ms IntDataPoint) Value() int64

Value returns the value associated with this IntDataPoint.

type IntDataPointSlice added in v0.10.0

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

IntDataPointSlice logically represents a slice of IntDataPoint.

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

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

func NewIntDataPointSlice added in v0.10.0

func NewIntDataPointSlice() IntDataPointSlice

NewIntDataPointSlice creates a IntDataPointSlice with 0 elements. Can use "Resize" to initialize with a given length.

func (IntDataPointSlice) Append added in v0.10.0

func (es IntDataPointSlice) Append(e IntDataPoint)

Append will increase the length of the IntDataPointSlice by one and set the given IntDataPoint at that new position. The original IntDataPoint could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (IntDataPointSlice) AppendEmpty added in v0.26.0

func (es IntDataPointSlice) AppendEmpty() IntDataPoint

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

func (IntDataPointSlice) At added in v0.10.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 (IntDataPointSlice) CopyTo added in v0.10.0

func (es IntDataPointSlice) CopyTo(dest IntDataPointSlice)

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

func (IntDataPointSlice) Len added in v0.10.0

func (es IntDataPointSlice) Len() int

Len returns the number of elements in the slice.

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

func (IntDataPointSlice) MoveAndAppendTo added in v0.10.0

func (es IntDataPointSlice) MoveAndAppendTo(dest IntDataPointSlice)

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

func (IntDataPointSlice) RemoveIf added in v0.26.0

func (es IntDataPointSlice) RemoveIf(f func(IntDataPoint) bool)

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

func (IntDataPointSlice) Resize added in v0.10.0

func (es IntDataPointSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new IntDataPointSlice can be initialized:

es := NewIntDataPointSlice()
es.Resize(4)
for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    // Here should set all the values for e.
}

type IntExemplar added in v0.10.0

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

IntExemplar is a sample input int 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 NewIntExemplar function to create new instances. Important: zero-initialized instance is not valid for use.

func NewIntExemplar added in v0.10.0

func NewIntExemplar() IntExemplar

NewIntExemplar creates a new empty IntExemplar.

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

func (IntExemplar) CopyTo added in v0.10.0

func (ms IntExemplar) CopyTo(dest IntExemplar)

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

func (IntExemplar) FilteredLabels added in v0.10.0

func (ms IntExemplar) FilteredLabels() StringMap

FilteredLabels returns the FilteredLabels associated with this IntExemplar.

func (IntExemplar) SetTimestamp added in v0.10.0

func (ms IntExemplar) SetTimestamp(v Timestamp)

SetTimestamp replaces the timestamp associated with this IntExemplar.

func (IntExemplar) SetValue added in v0.10.0

func (ms IntExemplar) SetValue(v int64)

SetValue replaces the value associated with this IntExemplar.

func (IntExemplar) Timestamp added in v0.10.0

func (ms IntExemplar) Timestamp() Timestamp

Timestamp returns the timestamp associated with this IntExemplar.

func (IntExemplar) Value added in v0.10.0

func (ms IntExemplar) Value() int64

Value returns the value associated with this IntExemplar.

type IntExemplarSlice added in v0.10.0

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

IntExemplarSlice logically represents a slice of IntExemplar.

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

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

func NewIntExemplarSlice added in v0.10.0

func NewIntExemplarSlice() IntExemplarSlice

NewIntExemplarSlice creates a IntExemplarSlice with 0 elements. Can use "Resize" to initialize with a given length.

func (IntExemplarSlice) Append added in v0.10.0

func (es IntExemplarSlice) Append(e IntExemplar)

Append will increase the length of the IntExemplarSlice by one and set the given IntExemplar at that new position. The original IntExemplar could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (IntExemplarSlice) AppendEmpty added in v0.26.0

func (es IntExemplarSlice) AppendEmpty() IntExemplar

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

func (IntExemplarSlice) At added in v0.10.0

func (es IntExemplarSlice) At(ix int) IntExemplar

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 (IntExemplarSlice) CopyTo added in v0.10.0

func (es IntExemplarSlice) CopyTo(dest IntExemplarSlice)

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

func (IntExemplarSlice) Len added in v0.10.0

func (es IntExemplarSlice) Len() int

Len returns the number of elements in the slice.

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

func (IntExemplarSlice) MoveAndAppendTo added in v0.10.0

func (es IntExemplarSlice) MoveAndAppendTo(dest IntExemplarSlice)

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

func (IntExemplarSlice) RemoveIf added in v0.26.0

func (es IntExemplarSlice) RemoveIf(f func(IntExemplar) bool)

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

func (IntExemplarSlice) Resize added in v0.10.0

func (es IntExemplarSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new IntExemplarSlice can be initialized:

es := NewIntExemplarSlice()
es.Resize(4)
for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    // Here should set all the values for e.
}

type IntGauge added in v0.10.0

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

IntGauge represents the type of a int 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 NewIntGauge function to create new instances. Important: zero-initialized instance is not valid for use.

func NewIntGauge added in v0.10.0

func NewIntGauge() IntGauge

NewIntGauge creates a new empty IntGauge.

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

func (IntGauge) CopyTo added in v0.10.0

func (ms IntGauge) CopyTo(dest IntGauge)

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

func (IntGauge) DataPoints added in v0.10.0

func (ms IntGauge) DataPoints() IntDataPointSlice

DataPoints returns the DataPoints associated with this IntGauge.

type IntHistogram added in v0.10.0

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

IntHistogram represents the type of a metric that is calculated by aggregating as a Histogram 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 NewIntHistogram function to create new instances. Important: zero-initialized instance is not valid for use.

func NewIntHistogram added in v0.10.0

func NewIntHistogram() IntHistogram

NewIntHistogram creates a new empty IntHistogram.

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

func (IntHistogram) AggregationTemporality added in v0.10.0

func (ms IntHistogram) AggregationTemporality() AggregationTemporality

AggregationTemporality returns the aggregationtemporality associated with this IntHistogram.

func (IntHistogram) CopyTo added in v0.10.0

func (ms IntHistogram) CopyTo(dest IntHistogram)

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

func (IntHistogram) DataPoints added in v0.10.0

func (ms IntHistogram) DataPoints() IntHistogramDataPointSlice

DataPoints returns the DataPoints associated with this IntHistogram.

func (IntHistogram) SetAggregationTemporality added in v0.10.0

func (ms IntHistogram) SetAggregationTemporality(v AggregationTemporality)

SetAggregationTemporality replaces the aggregationtemporality associated with this IntHistogram.

type IntHistogramDataPoint added in v0.10.0

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

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

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

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

func NewIntHistogramDataPoint added in v0.10.0

func NewIntHistogramDataPoint() IntHistogramDataPoint

NewIntHistogramDataPoint creates a new empty IntHistogramDataPoint.

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

func (IntHistogramDataPoint) BucketCounts added in v0.10.0

func (ms IntHistogramDataPoint) BucketCounts() []uint64

BucketCounts returns the bucketcounts associated with this IntHistogramDataPoint.

func (IntHistogramDataPoint) CopyTo added in v0.10.0

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

func (IntHistogramDataPoint) Count added in v0.10.0

func (ms IntHistogramDataPoint) Count() uint64

Count returns the count associated with this IntHistogramDataPoint.

func (IntHistogramDataPoint) Exemplars added in v0.10.0

func (ms IntHistogramDataPoint) Exemplars() IntExemplarSlice

Exemplars returns the Exemplars associated with this IntHistogramDataPoint.

func (IntHistogramDataPoint) ExplicitBounds added in v0.10.0

func (ms IntHistogramDataPoint) ExplicitBounds() []float64

ExplicitBounds returns the explicitbounds associated with this IntHistogramDataPoint.

func (IntHistogramDataPoint) LabelsMap added in v0.10.0

func (ms IntHistogramDataPoint) LabelsMap() StringMap

LabelsMap returns the Labels associated with this IntHistogramDataPoint.

func (IntHistogramDataPoint) SetBucketCounts added in v0.10.0

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

SetBucketCounts replaces the bucketcounts associated with this IntHistogramDataPoint.

func (IntHistogramDataPoint) SetCount added in v0.10.0

func (ms IntHistogramDataPoint) SetCount(v uint64)

SetCount replaces the count associated with this IntHistogramDataPoint.

func (IntHistogramDataPoint) SetExplicitBounds added in v0.10.0

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

SetExplicitBounds replaces the explicitbounds associated with this IntHistogramDataPoint.

func (IntHistogramDataPoint) SetStartTimestamp added in v0.24.0

func (ms IntHistogramDataPoint) SetStartTimestamp(v Timestamp)

SetStartTimestamp replaces the starttimestamp associated with this IntHistogramDataPoint.

func (IntHistogramDataPoint) SetSum added in v0.10.0

func (ms IntHistogramDataPoint) SetSum(v int64)

SetSum replaces the sum associated with this IntHistogramDataPoint.

func (IntHistogramDataPoint) SetTimestamp added in v0.10.0

func (ms IntHistogramDataPoint) SetTimestamp(v Timestamp)

SetTimestamp replaces the timestamp associated with this IntHistogramDataPoint.

func (IntHistogramDataPoint) StartTimestamp added in v0.24.0

func (ms IntHistogramDataPoint) StartTimestamp() Timestamp

StartTimestamp returns the starttimestamp associated with this IntHistogramDataPoint.

func (IntHistogramDataPoint) Sum added in v0.10.0

func (ms IntHistogramDataPoint) Sum() int64

Sum returns the sum associated with this IntHistogramDataPoint.

func (IntHistogramDataPoint) Timestamp added in v0.10.0

func (ms IntHistogramDataPoint) Timestamp() Timestamp

Timestamp returns the timestamp associated with this IntHistogramDataPoint.

type IntHistogramDataPointSlice added in v0.10.0

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

IntHistogramDataPointSlice logically represents a slice of IntHistogramDataPoint.

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

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

func NewIntHistogramDataPointSlice added in v0.10.0

func NewIntHistogramDataPointSlice() IntHistogramDataPointSlice

NewIntHistogramDataPointSlice creates a IntHistogramDataPointSlice with 0 elements. Can use "Resize" to initialize with a given length.

func (IntHistogramDataPointSlice) Append added in v0.10.0

Append will increase the length of the IntHistogramDataPointSlice by one and set the given IntHistogramDataPoint at that new position. The original IntHistogramDataPoint could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (IntHistogramDataPointSlice) AppendEmpty added in v0.26.0

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

func (IntHistogramDataPointSlice) At added in v0.10.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 (IntHistogramDataPointSlice) CopyTo added in v0.10.0

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

func (IntHistogramDataPointSlice) Len added in v0.10.0

Len returns the number of elements in the slice.

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

func (IntHistogramDataPointSlice) MoveAndAppendTo added in v0.10.0

func (es IntHistogramDataPointSlice) MoveAndAppendTo(dest IntHistogramDataPointSlice)

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

func (IntHistogramDataPointSlice) RemoveIf added in v0.26.0

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

func (IntHistogramDataPointSlice) Resize added in v0.10.0

func (es IntHistogramDataPointSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new IntHistogramDataPointSlice can be initialized:

es := NewIntHistogramDataPointSlice()
es.Resize(4)
for i := 0; i < es.Len(); i++ {
    e := es.At(i)
    // Here should set all the values for e.
}

type IntSum added in v0.10.0

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

IntSum represents the type of a numeric int 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 NewIntSum function to create new instances. Important: zero-initialized instance is not valid for use.

func NewIntSum added in v0.10.0

func NewIntSum() IntSum

NewIntSum creates a new empty IntSum.

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

func (IntSum) AggregationTemporality added in v0.10.0

func (ms IntSum) AggregationTemporality() AggregationTemporality

AggregationTemporality returns the aggregationtemporality associated with this IntSum.

func (IntSum) CopyTo added in v0.10.0

func (ms IntSum) CopyTo(dest IntSum)

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

func (IntSum) DataPoints added in v0.10.0

func (ms IntSum) DataPoints() IntDataPointSlice

DataPoints returns the DataPoints associated with this IntSum.

func (IntSum) IsMonotonic added in v0.10.0

func (ms IntSum) IsMonotonic() bool

IsMonotonic returns the ismonotonic associated with this IntSum.

func (IntSum) SetAggregationTemporality added in v0.10.0

func (ms IntSum) SetAggregationTemporality(v AggregationTemporality)

SetAggregationTemporality replaces the aggregationtemporality associated with this IntSum.

func (IntSum) SetIsMonotonic added in v0.10.0

func (ms IntSum) SetIsMonotonic(v bool)

SetIsMonotonic replaces the ismonotonic associated with this IntSum.

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 added in v0.7.0

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 added in v0.7.0

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 "Resize" to initialize with a given length.

func (LogSlice) Append added in v0.5.0

func (es LogSlice) Append(e LogRecord)

Append will increase the length of the LogSlice by one and set the given LogRecord at that new position. The original LogRecord could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (LogSlice) AppendEmpty added in v0.26.0

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) 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 added in v0.26.0

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) Resize

func (es LogSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new LogSlice can be initialized:

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

type Logs added in v0.8.0

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 added in v0.11.0

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 LogsFromOtlpProtoBytes added in v0.23.0

func LogsFromOtlpProtoBytes(data []byte) (Logs, error)

LogsFromOtlpProtoBytes converts OTLP Collector ExportLogsServiceRequest ProtoBuf bytes to the internal Logs.

Returns an invalid Logs instance if error is not nil.

func NewLogs added in v0.8.0

func NewLogs() Logs

NewLogs creates a new Logs.

func (Logs) Clone added in v0.8.0

func (ld Logs) Clone() Logs

Clone returns a copy of Logs.

func (Logs) InternalRep added in v0.11.0

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 added in v0.8.0

func (ld Logs) LogRecordCount() int

LogRecordCount calculates the total number of log records.

func (Logs) OtlpProtoSize added in v0.23.0

func (ld Logs) OtlpProtoSize() int

OtlpProtoSize returns the size in bytes of this Logs encoded as OTLP Collector ExportLogsServiceRequest ProtoBuf bytes.

func (Logs) ResourceLogs added in v0.8.0

func (ld Logs) ResourceLogs() ResourceLogsSlice

ResourceLogs returns the ResourceLogsSlice associated with this Logs.

func (Logs) ToOtlpProtoBytes added in v0.11.0

func (ld Logs) ToOtlpProtoBytes() ([]byte, error)

ToOtlpProtoBytes converts this Logs to the OTLP Collector ExportLogsServiceRequest ProtoBuf bytes.

Returns an nil byte-array if error is not nil.

type LogsDecoder added in v0.29.0

type LogsDecoder interface {
	// DecodeLogs decodes bytes into protocol-specific data model.
	// If the error is not nil, the returned interface cannot be used.
	DecodeLogs(buf []byte) (interface{}, error)
}

LogsDecoder is an interface to decode bytes into protocol-specific data model.

type LogsEncoder added in v0.29.0

type LogsEncoder interface {
	// EncodeLogs encodes protocol-specific data model into bytes.
	// If the error is not nil, the returned bytes slice cannot be used.
	EncodeLogs(model interface{}) ([]byte, error)
}

LogsEncoder is an interface to encode protocol-specific data model into bytes.

type LogsMarshaler added in v0.29.0

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

LogsMarshaler marshals pdata.Logs into bytes.

func NewLogsMarshaler added in v0.29.0

func NewLogsMarshaler(encoder LogsEncoder, translator FromLogsTranslator) LogsMarshaler

NewLogsMarshaler returns a new LogsMarshaler.

type LogsUnmarshaler added in v0.29.0

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

LogsUnmarshaler unmarshalls bytes into pdata.Logs.

func NewLogsUnmarshaler added in v0.29.0

func NewLogsUnmarshaler(decoder LogsDecoder, translator ToLogsTranslator) LogsUnmarshaler

NewLogsUnmarshaler returns a new LogsUnmarshaler.

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 added in v0.10.0

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 added in v0.10.0

func (ms Metric) Description() string

Description returns the description associated with this Metric.

func (Metric) DoubleGauge added in v0.10.0

func (ms Metric) DoubleGauge() DoubleGauge

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

func (Metric) DoubleSum added in v0.10.0

func (ms Metric) DoubleSum() DoubleSum

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

func (Metric) Histogram added in v0.24.0

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) IntGauge added in v0.10.0

func (ms Metric) IntGauge() IntGauge

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

func (Metric) IntHistogram added in v0.10.0

func (ms Metric) IntHistogram() IntHistogram

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

func (Metric) IntSum added in v0.10.0

func (ms Metric) IntSum() IntSum

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

func (Metric) Name added in v0.10.0

func (ms Metric) Name() string

Name returns the name associated with this Metric.

func (Metric) SetDataType added in v0.10.0

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 added in v0.10.0

func (ms Metric) SetDescription(v string)

SetDescription replaces the description associated with this Metric.

func (Metric) SetName added in v0.10.0

func (ms Metric) SetName(v string)

SetName replaces the name associated with this Metric.

func (Metric) SetUnit added in v0.10.0

func (ms Metric) SetUnit(v string)

SetUnit replaces the unit associated with this Metric.

func (Metric) Summary added in v0.24.0

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 added in v0.10.0

func (ms Metric) Unit() string

Unit returns the unit associated with this Metric.

type MetricDataType added in v0.10.0

type MetricDataType int32

MetricDataType specifies the type of data in a Metric.

const (
	MetricDataTypeNone MetricDataType = iota
	MetricDataTypeIntGauge
	MetricDataTypeDoubleGauge
	MetricDataTypeIntSum
	MetricDataTypeDoubleSum
	MetricDataTypeIntHistogram
	MetricDataTypeHistogram
	MetricDataTypeSummary
)

func (MetricDataType) String added in v0.10.0

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 "Resize" to initialize with a given length.

func (MetricSlice) Append added in v0.5.0

func (es MetricSlice) Append(e Metric)

Append will increase the length of the MetricSlice by one and set the given Metric at that new position. The original Metric could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (MetricSlice) AppendEmpty added in v0.26.0

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) 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 added in v0.26.0

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) Resize

func (es MetricSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new MetricSlice can be initialized:

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

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 added in v0.23.0

func MetricsFromInternalRep(wrapper internal.MetricsWrapper) Metrics

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

func MetricsFromOtlpProtoBytes added in v0.23.0

func MetricsFromOtlpProtoBytes(data []byte) (Metrics, error)

MetricsFromOtlpProtoBytes converts the OTLP Collector ExportMetricsServiceRequest ProtoBuf bytes to Metrics.

Returns an invalid Metrics instance if error is not nil.

func NewMetrics added in v0.10.0

func NewMetrics() Metrics

NewMetrics creates a new Metrics.

func (Metrics) Clone added in v0.10.0

func (md Metrics) Clone() Metrics

Clone returns a copy of MetricData.

func (Metrics) InternalRep added in v0.23.0

func (md Metrics) InternalRep() internal.MetricsWrapper

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

func (Metrics) MetricAndDataPointCount added in v0.10.0

func (md Metrics) MetricAndDataPointCount() (metricCount int, dataPointCount int)

MetricAndDataPointCount calculates the total number of metrics and data points.

func (Metrics) MetricCount added in v0.10.0

func (md Metrics) MetricCount() int

MetricCount calculates the total number of metrics.

func (Metrics) OtlpProtoSize added in v0.23.0

func (md Metrics) OtlpProtoSize() int

OtlpProtoSize returns the size in bytes of this Metrics encoded as OTLP Collector ExportMetricsServiceRequest ProtoBuf bytes.

func (Metrics) ResourceMetrics added in v0.10.0

func (md Metrics) ResourceMetrics() ResourceMetricsSlice

ResourceMetrics returns the ResourceMetricsSlice associated with this Metrics.

func (Metrics) ToOtlpProtoBytes added in v0.11.0

func (md Metrics) ToOtlpProtoBytes() ([]byte, error)

ToOtlpProtoBytes converts this Metrics to the OTLP Collector ExportMetricsServiceRequest ProtoBuf bytes.

Returns an nil byte-array if error is not nil.

type MetricsDecoder added in v0.29.0

type MetricsDecoder interface {
	// DecodeMetrics decodes bytes into protocol-specific data model.
	// If the error is not nil, the returned interface cannot be used.
	DecodeMetrics(buf []byte) (interface{}, error)
}

MetricsDecoder is an interface to decode bytes into protocol-specific data model.

type MetricsEncoder added in v0.29.0

type MetricsEncoder interface {
	// EncodeMetrics encodes protocol-specific data model into bytes.
	// If the error is not nil, the returned bytes slice cannot be used.
	EncodeMetrics(model interface{}) ([]byte, error)
}

MetricsEncoder is an interface to encode protocol-specific data model into bytes.

type MetricsMarshaler added in v0.29.0

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

MetricsMarshaler marshals pdata.Metrics into bytes.

func NewMetricsMarshaler added in v0.29.0

func NewMetricsMarshaler(encoder MetricsEncoder, translator FromMetricsTranslator) MetricsMarshaler

NewMetricsMarshaler returns a new MetricsMarshaler.

type MetricsUnmarshaler added in v0.29.0

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

MetricsUnmarshaler unmarshalls bytes into pdata.Metrics.

func NewMetricsUnmarshaler added in v0.29.0

func NewMetricsUnmarshaler(decoder MetricsDecoder, translator ToMetricsTranslator) MetricsUnmarshaler

NewMetricsUnmarshaler returns a new MetricsUnmarshaler.

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 added in v0.7.0

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.

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 "Resize" to initialize with a given length.

func (ResourceLogsSlice) Append added in v0.5.0

func (es ResourceLogsSlice) Append(e ResourceLogs)

Append will increase the length of the ResourceLogsSlice by one and set the given ResourceLogs at that new position. The original ResourceLogs could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (ResourceLogsSlice) AppendEmpty added in v0.26.0

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) 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 added in v0.26.0

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) Resize

func (es ResourceLogsSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new ResourceLogsSlice can be initialized:

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

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.

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 "Resize" to initialize with a given length.

func (ResourceMetricsSlice) Append added in v0.5.0

Append will increase the length of the ResourceMetricsSlice by one and set the given ResourceMetrics at that new position. The original ResourceMetrics could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (ResourceMetricsSlice) AppendEmpty added in v0.26.0

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) 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 added in v0.26.0

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) Resize

func (es ResourceMetricsSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new ResourceMetricsSlice can be initialized:

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

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.

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 "Resize" to initialize with a given length.

func (ResourceSpansSlice) Append added in v0.5.0

func (es ResourceSpansSlice) Append(e ResourceSpans)

Append will increase the length of the ResourceSpansSlice by one and set the given ResourceSpans at that new position. The original ResourceSpans could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (ResourceSpansSlice) AppendEmpty added in v0.26.0

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) 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 added in v0.26.0

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) Resize

func (es ResourceSpansSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new ResourceSpansSlice can be initialized:

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

type SeverityNumber added in v0.8.0

type SeverityNumber int32

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

func (SeverityNumber) String added in v0.23.0

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 added in v0.24.0

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 added in v0.24.0

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 added in v0.24.0

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 added in v0.24.0

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 "Resize" to initialize with a given length.

func (SpanEventSlice) Append added in v0.5.0

func (es SpanEventSlice) Append(e SpanEvent)

Append will increase the length of the SpanEventSlice by one and set the given SpanEvent at that new position. The original SpanEvent could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (SpanEventSlice) AppendEmpty added in v0.26.0

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) 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 added in v0.26.0

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) Resize

func (es SpanEventSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new SpanEventSlice can be initialized:

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

type SpanID

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

SpanID is an alias of OTLP SpanID data type.

func InvalidSpanID added in v0.14.0

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 added in v0.12.0

func (t SpanID) HexString() string

HexString returns hex representation of the SpanID.

func (SpanID) IsEmpty added in v0.18.0

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 "Resize" to initialize with a given length.

func (SpanLinkSlice) Append added in v0.5.0

func (es SpanLinkSlice) Append(e SpanLink)

Append will increase the length of the SpanLinkSlice by one and set the given SpanLink at that new position. The original SpanLink could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (SpanLinkSlice) AppendEmpty added in v0.26.0

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) 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 added in v0.26.0

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) Resize

func (es SpanLinkSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new SpanLinkSlice can be initialized:

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

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 "Resize" to initialize with a given length.

func (SpanSlice) Append added in v0.5.0

func (es SpanSlice) Append(e Span)

Append will increase the length of the SpanSlice by one and set the given Span at that new position. The original Span could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (SpanSlice) AppendEmpty added in v0.26.0

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) 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 added in v0.26.0

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) Resize

func (es SpanSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new SpanSlice can be initialized:

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

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 StringMap

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

StringMap stores a map of attribute keys to values.

func NewStringMap

func NewStringMap() StringMap

NewStringMap creates a StringMap with 0 elements.

func (StringMap) Clear added in v0.25.0

func (sm StringMap) Clear()

Clear erases any existing entries in this StringMap instance.

func (StringMap) CopyTo

func (sm StringMap) CopyTo(dest StringMap)

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

func (StringMap) Delete

func (sm StringMap) Delete(k 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 (StringMap) EnsureCapacity added in v0.25.0

func (sm StringMap) EnsureCapacity(capacity int)

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

func (StringMap) Get

func (sm StringMap) Get(k string) (string, bool)

Get returns the StringValue associated with the key and true, otherwise an invalid instance of the StringKeyValue and false. Calling any functions on the returned invalid instance will cause a panic.

func (StringMap) InitFromMap

func (sm StringMap) InitFromMap(attrMap map[string]string) StringMap

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

Returns the same instance to allow nicer code like:

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

func (StringMap) Insert

func (sm StringMap) Insert(k, v string)

Insert 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 (StringMap) Len

func (sm StringMap) 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 (StringMap) Range added in v0.25.0

func (sm StringMap) Range(f func(k string, v string) bool)

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

Example:

it := sm.Range(func(k string, v StringValue) {
    ...
})

func (StringMap) Sort

func (sm StringMap) Sort() StringMap

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

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

func (StringMap) Update

func (sm StringMap) Update(k, v string)

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

func (StringMap) Upsert

func (sm StringMap) Upsert(k, v string)

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

type Summary added in v0.24.0

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 added in v0.24.0

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 added in v0.24.0

func (ms Summary) CopyTo(dest Summary)

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

func (Summary) DataPoints added in v0.24.0

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) 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) LabelsMap

func (ms SummaryDataPoint) LabelsMap() StringMap

LabelsMap returns the Labels associated with this SummaryDataPoint.

func (SummaryDataPoint) QuantileValues added in v0.24.0

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) SetStartTimestamp added in v0.24.0

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 added in v0.24.0

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 "Resize" to initialize with a given length.

func (SummaryDataPointSlice) Append added in v0.5.0

Append will increase the length of the SummaryDataPointSlice by one and set the given SummaryDataPoint at that new position. The original SummaryDataPoint could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (SummaryDataPointSlice) AppendEmpty added in v0.26.0

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) 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 added in v0.26.0

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) Resize

func (es SummaryDataPointSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new SummaryDataPointSlice can be initialized:

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

type Timestamp added in v0.22.0

type Timestamp uint64

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

func TimestampFromTime added in v0.22.0

func TimestampFromTime(t time.Time) Timestamp

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

func (Timestamp) AsTime added in v0.22.0

func (ts Timestamp) AsTime() time.Time

AsTime converts this to a time.Time.

func (Timestamp) String added in v0.22.0

func (ts Timestamp) String() string

String returns the string representation of this in UTC.

type ToLogsTranslator added in v0.29.0

type ToLogsTranslator interface {
	// ToLogs translates a protocol-specific data model into pdata.Logs.
	// If the error is not nil, the returned pdata.Logs cannot be used.
	ToLogs(src interface{}) (Logs, error)
}

ToLogsTranslator is an interface to translate a protocol-specific data model into pdata.Traces.

type ToMetricsTranslator added in v0.29.0

type ToMetricsTranslator interface {
	// ToMetrics translates a protocol-specific data model into pdata.Metrics.
	// If the error is not nil, the returned pdata.Metrics cannot be used.
	ToMetrics(src interface{}) (Metrics, error)
}

ToMetricsTranslator is an interface to translate a protocol-specific data model into pdata.Traces.

type ToTracesTranslator added in v0.29.0

type ToTracesTranslator interface {
	// ToTraces translates a protocol-specific data model into pdata.Traces.
	// If the error is not nil, the returned pdata.Traces cannot be used.
	ToTraces(src interface{}) (Traces, error)
}

ToTracesTranslator is an interface to translate a protocol-specific data model into pdata.Traces.

type TraceID

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

TraceID is an alias of OTLP TraceID data type.

func InvalidTraceID added in v0.14.0

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 added in v0.12.0

func (t TraceID) HexString() string

HexString returns hex representation of the TraceID.

func (TraceID) IsEmpty added in v0.18.0

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 added in v0.23.0

func TracesFromInternalRep(wrapper internal.TracesWrapper) Traces

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

func TracesFromOtlpProtoBytes added in v0.23.0

func TracesFromOtlpProtoBytes(data []byte) (Traces, error)

TracesFromOtlpProtoBytes converts OTLP Collector ExportTraceServiceRequest ProtoBuf bytes to the internal Traces.

Returns an invalid Traces instance if error is not nil.

func (Traces) Clone

func (td Traces) Clone() Traces

Clone returns a copy of Traces.

func (Traces) InternalRep added in v0.23.0

func (td Traces) InternalRep() internal.TracesWrapper

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

func (Traces) OtlpProtoSize added in v0.23.0

func (td Traces) OtlpProtoSize() int

OtlpProtoSize returns the size in bytes of this Traces encoded as OTLP Collector ExportTraceServiceRequest ProtoBuf bytes.

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.

func (Traces) ToOtlpProtoBytes added in v0.11.0

func (td Traces) ToOtlpProtoBytes() ([]byte, error)

ToOtlpProtoBytes converts this Traces to the OTLP Collector ExportTraceServiceRequest ProtoBuf bytes.

Returns an nil byte-array if error is not nil.

type TracesDecoder added in v0.29.0

type TracesDecoder interface {
	// DecodeTraces decodes bytes into protocol-specific data model.
	// If the error is not nil, the returned interface cannot be used.
	DecodeTraces(buf []byte) (interface{}, error)
}

TracesDecoder is an interface to decode bytes into protocol-specific data model.

type TracesEncoder added in v0.29.0

type TracesEncoder interface {
	// EncodeTraces encodes protocol-specific data model into bytes.
	// If the error is not nil, the returned bytes slice cannot be used.
	EncodeTraces(model interface{}) ([]byte, error)
}

TracesEncoder is an interface to encode protocol-specific data model into bytes.

type TracesMarshaler added in v0.29.0

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

TracesMarshaler marshals pdata.Traces into bytes.

func NewTracesMarshaler added in v0.29.0

func NewTracesMarshaler(encoder TracesEncoder, translator FromTracesTranslator) TracesMarshaler

NewTracesMarshaler returns a new TracesMarshaler.

type TracesUnmarshaler added in v0.29.0

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

TracesUnmarshaler unmarshalls bytes into pdata.Traces.

func NewTracesUnmarshaler added in v0.29.0

func NewTracesUnmarshaler(decoder TracesDecoder, translator ToTracesTranslator) TracesUnmarshaler

NewTracesUnmarshaler returns a new TracesUnmarshaler.

type ValueAtQuantile added in v0.15.0

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 added in v0.15.0

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 added in v0.15.0

func (ms ValueAtQuantile) CopyTo(dest ValueAtQuantile)

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

func (ValueAtQuantile) Quantile added in v0.15.0

func (ms ValueAtQuantile) Quantile() float64

Quantile returns the quantile associated with this ValueAtQuantile.

func (ValueAtQuantile) SetQuantile added in v0.15.0

func (ms ValueAtQuantile) SetQuantile(v float64)

SetQuantile replaces the quantile associated with this ValueAtQuantile.

func (ValueAtQuantile) SetValue added in v0.15.0

func (ms ValueAtQuantile) SetValue(v float64)

SetValue replaces the value associated with this ValueAtQuantile.

func (ValueAtQuantile) Value added in v0.15.0

func (ms ValueAtQuantile) Value() float64

Value returns the value associated with this ValueAtQuantile.

type ValueAtQuantileSlice added in v0.15.0

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 added in v0.15.0

func NewValueAtQuantileSlice() ValueAtQuantileSlice

NewValueAtQuantileSlice creates a ValueAtQuantileSlice with 0 elements. Can use "Resize" to initialize with a given length.

func (ValueAtQuantileSlice) Append added in v0.15.0

Append will increase the length of the ValueAtQuantileSlice by one and set the given ValueAtQuantile at that new position. The original ValueAtQuantile could still be referenced so do not reuse it after passing it to this method. Deprecated: Use AppendEmpty.

func (ValueAtQuantileSlice) AppendEmpty added in v0.26.0

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 added in v0.15.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 (ValueAtQuantileSlice) CopyTo added in v0.15.0

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

func (ValueAtQuantileSlice) Len added in v0.15.0

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 added in v0.15.0

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 added in v0.26.0

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) Resize added in v0.15.0

func (es ValueAtQuantileSlice) Resize(newLen int)

Resize is an operation that resizes the slice: 1. If the newLen <= len then equivalent with slice[0:newLen:cap]. 2. If the newLen > len then (newLen - cap) empty elements will be appended to the slice.

Here is how a new ValueAtQuantileSlice can be initialized:

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

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL