go.opentelemetry.io/collector/pdata

🧰 Bug fixes 🧰

• service: Fix running collector as a windows service. (#6433)

🛑 Breaking changes 🛑

• pdata: JSON marshaler emits enums as ints per spec requirements. This may be a breaking change if receivers were not confirming with the spec. (#6338)

• confmap: Remove deprecated confmap.Conf.UnmarshalExact API in 0.62.0 (#6315)

• pdata: Remove API deprecated in 0.62.0 (#6314)

  • Remove deprecated pcommon.NewValueString
  • Remove deprecated pcommon.Map.PutString
  • Remove deprecated plog.SeverityNumberUndefined
  • Remove deprecated p[metric|log|trace]otlp.RegisterServer
  • Remove deprecated pmetric.[Default]?MetricDataPointFlags
  • Remove deprecated pmetric.MetricAggregationTemporality*
  • Remove deprecated pmetric.MetricTypeNone
  • Remove deprecated pmetric.NumberDataPointValueTypeNone
  • Remove deprecated pmetric.ExemplarValueTypeNone
  • Remove deprecated pmetric.[New]?Buckets
  • Remove deprecated pmetric.[New]?ValueAtQuantile
  • Remove deprecated pmetric.[New]?ValueAtQuantileSlice
  • Remove deprecated ptrace.[New]?SpanStatus

• exporter: Splitting otlp, otlphttp and logging exporters into their own modules (#6343) The import path for these exporters can now be access directly:

  • go.opentelemetry.io/collector/exporter/loggingexporter
  • go.opentelemetry.io/collector/exporter/otlpexporter
  • go.opentelemetry.io/collector/exporter/otlphttpexporter

  If using these exporters, modify your Collector builder configuration to use gomod directly, such as:

  • gomod: go.opentelemetry.io/collector/exporter/otlpexporter v0.63.0

🚩 Deprecations 🚩

• overwritepropertiesconverter: Deprecate overwritepropertiesconverter, only used by non builder distributions. (#6294)

• pdata: Add Export prefix to p[trace|metric|log]otlp.[Request|Response] (#6365)

  • Deprecate p[trace|metric|log]otlp.[Request|Response] in favor of p[trace|metric|log]otlp.Export[Request|Response]
  • Deprecate p[trace|metric|log]otlp.New[Request|Response] in favor of p[trace|metric|log]otlp.NewExport[Request|Response]
  • Deprecate p[trace|metric|log]otlp.NewRequestFrom[Traces|Metrics|Logs] in favor of p[trace|metric|log]otlp.NewExportRequestFrom[Traces|Metrics|Logs]

• pdata: Deprecate p[trace|metric|log]otlp.NewClient in favor of p[trace|metric|log]otlp.NewGRPCClient (#6350)

• exporter/logging: Deprecate 'loglevel' in favor of 'verbosity' option (#5878)

• pdata: Deprecate New[JSON|Proto][Marshaler|Unmarshaler] in favor of exposing the underlying structs (#6340)

💡 Enhancements 💡

• pdata: Introduce partial success fields in ExportResponse. (#5815, #5816, #6365)
• obsreport: Instrument obsreport.Receiver metrics with otel-go (#6222)
• service/telemetry: Move logging and tracing initialization to service/telemetry (#5564)
• confmap: Fail fast when a resolver has URIs with unsupported schemes. (#6274)
• service: Use the same prometheus.Registry for the OpenCensus and OpenTelemetry Go prometheus exporters to act as a bridge for internal telemetry (#6297)

🧰 Bug fixes 🧰

• pdata: Because of wrong deprecation/rename in proto, services still send the fake 1000 proto id. See https://github.com/open-telemetry/opentelemetry-proto/issues/431 (#6342)
• confmap: When a sub-config implements Unmarshaler, do not reinitialized it unless necessary. (#6392)
• pdata: Enable enums as ints for otlp messages, switch to jsoniter for responses. (#6345)
• collector: Fixed collector service not cleaning up if it failed during Start (#6352)

• Fix support for new line in config URI location. (#6306)

🛑 Breaking changes 🛑

• Delete deprecated go.opentelemetry.io/collector/service/featuregate. (#6178)
• Delete deprecated pmetric.OptionalType. (#6178)
• Delete deprecated ptrace.Span[Link]?.TraceStateStruct. (#6178)
• Delete deprecated pcommon.NewValueBytesEmpty. (#6178)
• Delete deprecated pmetric.MetricDataType. (#6178)
• Delete deprecated pmetric.Metric.DataType(). (#6178)
• Delete deprecated pmetric.NumberDataPoint.[Set]?[Int|Double]Val(). (#6178)
• Delete deprecated pmetric.Exemplar.[Set]?[Int|Double]Val(). (#6178)
• Delete deprecated p[metric|log|trace]otlp.[Client|Server]. (#6178)
• Delete deprecated pdata Clone methods. (#6178)
• Delete deprecated pcommon.Value getter/setter methods with Val suffix. (#6178)
• Delete deprecated StringVal and SetStringVal methods. (#6178)
• Delete deprecated ValueTypeString method. (#6178)
• Change AggregationTemporality.String to simpler, easier to read. (#6117)
• Update pcommon.ValueType.String output to string representation of corresponding type identifiers. The following values will be returned: (#6247)
  • ValueTypeEmpty.String() -> "Empty"
  • ValueTypeStr.String() -> "Str"
  • ValueTypeBool.String() -> "Bool"
  • ValueTypeInt.String() -> "Int"
  • ValueTypeDouble.String() -> "Double"
  • ValueTypeMap.String() -> "Map"
  • ValueTypeSlice.String() -> "Slice"
  • ValueTypeBytes.String() -> "Bytes"
• Rename output of [MetricType|NumberDataPointValueType|ExemplarValueType].String() for zero values from "None" to "Empty" (#6270)

🚩 Deprecations 🚩

• Deprecate p[metric|log|trace]otlp.RegisterServer in favor of p[metric|log|trace]otlp.RegisterGRPCServer (#6182)
• Deprecate pcommon.Map.PutString in favor of pcommon.Map.PutStr (#6210)
• Deprecate pcommon.NewValueString in favor of pcommon.NewValueStr (#6209)
• Deprecate pmetric.MetricAggregationTemporality enum type in favor of pmetric.AggregationTemporality (#6253)
• Deprecate confmap.Conf.UnmarshalExact in favor of confmap.Conf.Unmarshal(.., WithErrorUnused) (#6231)
• Deprecate pmetric.[Default]?MetricDataPointFlags favor of pmetric.[Default]?DataPointFlags (#6259)
• Deprecate ptrace.[New]?SpanStatus favor of ptrace.[New]?Status (#6258)
• Deprecate pmetric.[New]?Buckets in favor of pmetric.[New]?ExponentialHistogramDataPointBuckets (#6261)
• Deprecate plog.SeverityNumberUndefined in favor of plog.SeverityNumberUnspecified (#6269)
• Deprecate pmetric.[New]?ValueAtQuantile[Slice]? in favor of pmetric.[New]?SummaryDataPointValueAtQuantile[Slice]? (#6262)
• Deprecate enum zero constants ending with None (#6270)
  • Deprecate pmetric.MetricTypeNone in favor of pmetric.MetricTypeEmpty
  • Deprecate pmetric.NumberDataPointValueTypeNone in favor of pmetric.NumberDataPointValueTypeEmpty
  • Deprecate pmetric.ExemplarValueTypeNone in favor of pmetric.ExemplarValueTypeEmpty

💡 Enhancements 💡

• Add config marshaler (#5566)
• Add semantic conventions for specification v1.10-v1.13 (#6213)
• receiver/otlp: Make logs related to gRCPC and HTTP server startup clearer (#6174)
• Add prometheus metric prefix to Collector's own telemetry when using OpenTelemetry for internal telemetry (#6223)
• exporter/logging: Apply consistent rendering of map values (#6244)
• Add support in the confmap.Resolver to expand embedded config URIs inside configuration. (#6276)

🧰 Bug fixes 🧰

• Fixed bug where telemetryInitializer is not cleaned up when newService errors (#6239)

🛑 Breaking changes 🛑

• Change ptrace.Span[Link]?.TraceState signature to match ptrace.Span[Link]?.TraceStateStruct (#6085)
• Delete deprecated pmetric.NewMetricDataPointFlagsImmutable func. (#6097)
• Delete deprecated pmetric.*DataPoint.[Set]FlagsImmutable() funcs. (#6097)
• Delete deprecated config.Unmarshalable interface. (#6084)
• Delete deprecated p[metric|log|trace].MarshalerSizer interfaces (#6083)
• Delete deprecated pcommon.Map.Insert* funcs. (#6088)
• Delete deprecated pcommon.Map.Upsert* funcs. (#6088)
• Delete deprecated pcommon.Map.Update* funcs. (#6088)
• Change pcommon.NewValueBytes signature to match pcommon.NewValueBytesEmpty. (#6088)
• Delete deprecated pcommon.Empty[Trace|Span]ID. (#6098)
• Delete deprecated pcommon.[Trace|Span]ID.Bytes(). (#6098)
• Delete deprecated pcommon.New[Trace|Span]ID(). (#6098)
• Delete deprecated pcommon.Value.SetBytesVal. (#6088)
• Delete deprecated pmetric.Metric.SetDataType. (#6095)
• Delete deprecated plog.LogRecord.[Set]FlagStruct funcs. (#6100)
• Delete deprecated pcommon.ImmutableByteSlice and pcommon.NewImmutableByteSlice. (#6107)
• Delete deprecated pcommon.ImmutableFloat64Slice and pcommon.NewImmutableFloat64Slice. (#6107)
• Delete deprecated pcommon.ImmutableUInt64Slice and pcommon.NewImmutableUInt64Slice. (#6107)
• Delete deprecated *DataPoint.SetBucketCounts and *DataPoint.SetExplicitBounds. (#6108)

🚩 Deprecations 🚩

• Deprecate go.opentelemetry.io/collector/service/featuregate in favor of go.opentelemetry.io/collector/featuregate. (#6094)
• Deprecate pmetric.OptionalType, unused enum type. (#6096)
• Deprecate ptrace.Span[Link]?.TraceStateStruct in favor of ptrace.Span[Link]?.TraceState (#6085)
• Deprecate pcommon.NewValueBytesEmpty in favor of pcommon.NewValueBytes that now has the same signature. (#6105)
• Deprecate pmetric.MetricDataType and related constants in favor of pmetric.MetricType. (#6127)
• Deprecate pmetric.Metric.DataType() in favor of pmetric.Metric.Type(). (#6127)
• Deprecate pmetric.NumberDataPoint.[Set]?[Int|Double]Val() in favor of pmetric.NumberDataPoint.[Set]?[Int|Double]Value(). (#6134)
• Deprecate pmetric.Exemplar.[Set]?[Int|Double]Val() in favor of pmetric.Exemplar.[Set]?[Int|Double]Value(). (#6134)
• Deprecate p[metric|log|trace]otlp.[Client|Server] in favor of p[metric|log|trace]otlp.GRPC[Client|Server] (#6165)
• Deprecate pdata Clone methods in favor of CopyTo for consistency with other pdata structs (#6164)
  • pmetric.Metrics.Clone is deprecated in favor of pmetric.Metrics.CopyTo
  • ptrace.Traces.Clone is deprecated in favor of pmetric.Traces.CopyTo
  • plog.Logs.Clone is deprecated in favor of plogs.Logs.CopyTo
• Rename all pcommon.Value getter/setter methods by removing Val suffix. (#6092)
  • Old methods with Val suffix are deprecated.
  • StringVal and SetStringVal are deprecated in favor of Str and SetStr to avoid implementing fmt.Stringer interface.
  • Therefore, ValueTypeString is deprecated in favour of ValueTypeStr for consistency.

💡 Enhancements 💡

• Add AppendEmpty and EnsureCapacity method to primitive pdata slices (#6060)
• Expose AsRaw and FromRaw pcommon.Value methods (#6090)
• Convert ValueTypeBytes attributes in logging exporter (#6153)
• service.name Resource attribute is added to Collector's own telemetry, defaults to the value of BuildInfo.Command and can be overridden in the config (#6152)
• Updated how telemetryInitializer is created so it's instanced per Collector instance rather than global to the process (#6138)

🛑 Breaking changes 🛑

• Replace deprecated *DataPoint.Flags() with *DataPoint.[Set]FlagsImmutable(). (#6017)
• Remove deprecated MetricDataPointFlagsStruct struct and NewMetricDataPointFlagsStruct func. (#6017)
• Replace deprecated MetricDataPointFlags with MetricDataPointFlagsImmutable. (#6017)
• Replace deprecated LogRecord.[Set]Flags() with LogRecord.[Set]FlagsStruct(). (#6007)
• Remove deprecated components helpers funcs (#6006)
  • exporterhelper.New[Traces|Metrics|Logs]ExporterWithContext
  • processorhelper.New[Traces|Metrics|Logs]ProcessorWithCreateSettings
  • component.NewExtensionFactoryWithStabilityLevel
• Remove deprecated pcommon.InvalidTraceID and pcommon.InvalidSpanID funcs (#6008)
• Remove deprecated pcommon.Map methods: Update, Upsert, InsertNull (#6019)

🚩 Deprecations 🚩

• Deprecate pmetric.Metric.SetDataType, in favor of empty setters for each type. (#5979)
• Deprecate p[metric|log|trace].MarshalerSizer in favor of p[metric|log|trace].MarshalSizer. (#6033)
• Deprecate pcommon.Map.Update+ in favor of pcommon.Map.Get + pcommon.Value.Set+ (#6013)
• Deprecate pcommon.Empty[Trace|Span]ID in favor of pcommon.New[Trace|Span]IDEmpty (#6008)
• Deprecate pcommon.[Trace|Span]ID.Bytes in favor direct conversion. (#6008)
• Deprecate pcommon.New[Trace|Span]ID in favor direct conversion. (#6008)
• Deprecate MetricDataPointFlagsImmutable type. (#6017)
• Deprecate *DataPoint.[Set]FlagsImmutable() funcs in favor of *DataPoint.[Set]Flags(). (#6017)
• Deprecate LogRecord.FlagsStruct() and LogRecord.SetFlagsStruct() in favor of LogRecord.Flags() and LogRecord.SetFlags(). (#6007)
• Deprecate config.Unmarshallable in favor of confmap.Unmarshaler. (#6031)
• Primitive slice wrapper are now mutable (#5971):
  • pcommon.ImmutableByteSlice is deprecated in favor of pcommon.ByteSlice
  • pcommon.ImmutableFloat64Slice is deprecated in favor of pcommon.Float64Slice
  • pcommon.ImmutableUInt64Slice is deprecated in favor of pcommon.UInt64Slice
  • Temporarily deprecate pcommon.NewValueBytes that will be replaced with pcommon.NewValueBytesEmpty in 0.60.0
  • Deprecate pcommon.Map.UpsertBytes in favor of pcommon.Map.PutEmptyBytes (#6064)
  • Deprecate pcommon.Value.SetBytesVal in favor of pcommon.Value.SetEmptyBytesVal
  • Deprecate pcommon.New[Slice|Map]FromRaw functions in favor of New[Slice|Map]().FromRaw (#6045)
• Deprecate pcommon.Map.Insert* methods (#6051)
• Deprecate pcommon.Map.Upsert* methods in favor of pcommon.Map.Put* (#6064)
• Deprecate ptrace.TraceState in favor of pcommon.TraceState. (#6052)
  • ptrace.Span.TraceState in favor of ptrace.Span.TraceStateStruct().AsRaw()
  • ptrace.Span.SetTraceState in favor of ptrace.Span.TraceStateStruct().FromRaw
  • ptrace.SpanLink.TraceState in favor of ptrace.SpanLink.TraceStateStruct().AsRaw()
  • ptrace.SpanLink.SetTraceState in favor of ptrace.SpanLink.TraceStateStruct().FromRaw
  • TraceStateStruct is a temporary name that will be replaced back to TraceState in the next release.

💡 Enhancements 💡

• Add skip-get-modules builder flag to support isolated environment executions (#6009)
  • Skip unnecessary Go binary path validation when the builder is used with skip-compilation and skip-get-modules flags (#6026)
• Make the otlpreceiver support to use jsoniter to unmarshal JSON payloads. (#6040)
• Add mapstructure hook function for confmap.Unmarshaler interface (#6029)
• Add CopyTo and MoveTo methods to primitive slices (#6044)
• Add support to unmarshalls bytes into plogs.Logs with jsoniter in jsonUnmarshaler (#6021)
• Instead of exiting, ocb now generates a default Collector when no build configuration is supplied (#5752)

🧰 Bug fixes 🧰

• otlpjson: Correctly skip unknown JSON value types. (#6038)
• Fix reading resource attributes from trace JSON. (#6023)