DataPoint Context

[!NOTE] This documentation applies only to version 0.120.0 and later. For information on earlier versions, please refer to the previous documentation.

The DataPoint Context is a Context implementation for pdata DataPoints, the collector's internal representation for OTLP metric data points. This Context should be used when interacting with individual OTLP data points.

Paths

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

The following paths are supported.

path	field accessed	type
datapoint.cache	the value of the current transform context's temporary cache. cache can be used as a temporary placeholder for data during complex transformations	pcommon.Map
datapoint.cache[""]	the value of an item in cache. Supports multiple indexes to access nested fields.	string, bool, int64, float64, pcommon.Map, pcommon.Slice, []byte or nil
resource	resource of the data point being processed	pcommon.Resource
resource.attributes	resource attributes of the data point being processed	pcommon.Map
resource.attributes[""]	the value of the resource attribute of the data point being processed. Supports multiple indexes to access nested fields.	string, bool, int64, float64, pcommon.Map, pcommon.Slice, []byte or nil
resource.dropped_attributes_count	number of dropped attributes of the resource of the data point being processed	int64
instrumentation_scope	instrumentation scope of the data point being processed	pcommon.InstrumentationScope
instrumentation_scope.name	name of the instrumentation scope of the data point being processed	string
instrumentation_scope.version	version of the instrumentation scope of the data point being processed	string
instrumentation_scope.dropped_attributes_count	number of dropped attributes of the instrumentation scope of the data point being processed	int64
instrumentation_scope.attributes	instrumentation scope attributes of the data point being processed	pcommon.Map
instrumentation_scope.attributes[""]	the value of the instrumentation scope attribute of the data point being processed. Supports multiple indexes to access nested fields.	string, bool, int64, float64, pcommon.Map, pcommon.Slice, []byte or nil
datapoint.attributes	attributes of the data point being processed	pcommon.Map
datapoint.attributes[""]	the value of the attribute of the data point being processed. Supports multiple indexes to access nested fields.	string, bool, int64, float64, pcommon.Map, pcommon.Slice, []byte or nil
metric	the metric to which the data point being processed belongs	pmetric.Metric
metric.*	All fields exposed by the ottlmetric context can accessed via metric.	varies
datapoint.positive	the positive buckets of the data point being processed	pmetric.ExponentialHistogramDataPoint
datapoint.positive.offset	the offset of the positive buckets of the data point being processed	int64
datapoint.positive.bucket_counts	the bucket_counts of the positive buckets of the data point being processed	uint64
datapoint.negative	the negative buckets of the data point being processed	pmetric.ExponentialHistogramDataPoint
datapoint.negative.offset	the offset of the negative buckets of the data point being processed	int64
datapoint.negative.bucket_counts	the bucket_counts of the negative buckets of the data point being processed	uint64
datapoint.start_time_unix_nano	the start time in unix nano of the data point being processed	int64
datapoint.time	the time in time.Time of the data point being processed	time.Time
datapoint.start_time	the start time in time.Time of the data point being processed	time.Time
datapoint.time_unix_nano	the time in unix nano of the data point being processed	int64
datapoint.value_double	the double value of the data point being processed	float64
datapoint.value_int	the int value of the data point being processed	int64
datapoint.exemplars	the exemplars of the data point being processed	pmetric.ExemplarSlice
datapoint.flags	the flags of the data point being processed	int64
datapoint.count	the count of the data point being processed	int64
datapoint.sum	the sum of the data point being processed	float64
datapoint.bucket_counts	the bucket counts of the data point being processed	[]uint64
datapoint.explicit_bounds	the explicit bounds of the data point being processed	[]float64
datapoint.scale	the scale of the data point being processed	int64
datapoint.zero_count	the zero_count of the data point being processed	int64
datapoint.quantile_values	the quantile_values of the data point being processed	pmetric.SummaryDataPointValueAtQuantileSlice

Enums

The DataPoint Context supports the enum names from the metrics proto.

In addition, it also supports an enum for metrics data type, with the numeric value being defined by pdata.

Enum Symbol	Value
FLAG_NONE	0
FLAG_NO_RECORDED_VALUE	1
AGGREGATION_TEMPORALITY_UNSPECIFIED	0
AGGREGATION_TEMPORALITY_DELTA	1
AGGREGATION_TEMPORALITY_CUMULATIVE	2
METRIC_DATA_TYPE_NONE	0
METRIC_DATA_TYPE_GAUGE	1
METRIC_DATA_TYPE_SUM	2
METRIC_DATA_TYPE_HISTOGRAM	3
METRIC_DATA_TYPE_EXPONENTIAL_HISTOGRAM	4
METRIC_DATA_TYPE_SUMMARY	5