go.opentelemetry.io/collector/pdata

🛑 Breaking changes 🛑

• config: Remove already deprecates config.Service. (#6395)

• pdata: Change output of String() method of the following enum types to more a concise form: (#6251)

  • plog.SeverityNumber
  • ptrace.SpanKind
  • ptrace.StatusCode

• config: Remove already deprecates config.Config. (#6394)

• pdata: Remove deprecated code from pdata (#6417)

  • p[trace|metric|log]otlp.[Request|Response]
  • p[trace|metric|log]otlp.New[Request|Response]
  • p[trace|metric|log]otlp.NewRequestFrom[Traces|Metrics|Logs]
  • p[trace|metric|log]otlp.NewClient
  • p[trace|metric|log]New[JSON|Proto][Marshaler|Unmarshaler]

• extension: Splitting ballast/zpages extension into their own modules (#6191) The import path for the extension modules can now be accessed directly:

  • go.opentelemetry.io/collector/extension/ballastextension
  • go.opentelemetry.io/collector/extension/zpagesextension

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

  • gomod: go.opentelemetry.io/collector/extension/ballastextension v0.64.0

• processor: Splitting batch/memorylimiter processors into their own modules (#6188, #6192, #6193) The import path for the processor modules can now be access directly:

  • go.opentelemetry.io/collector/processor/batchprocessor
  • go.opentelemetry.io/collector/processor/memorylimiter

  If using this processor, modify your Collector builder configuration to use gomod directly, such as:

  • gomod: go.opentelemetry.io/collector/processor/batchprocessor v0.64.0

• otlpreceiver: Splitting otlp receiver into its own module (#6190) The import path for the OTLP receiver can now be access directly:

  • go.opentelemetry.io/collector/receiver/otlpreceiver

  If using this receiver, modify your Collector builder configuration to use gomod directly, such as:

  • gomod: go.opentelemetry.io/collector/receiver/otlpreceiver v0.64.0

• confmap: Remove unused public member sync.Mutex from confmap.Resolver. (#6489) This is an exception from the deprecation rule since this is not used anywhere and it is very unlikely that is used by external users.

🚩 Deprecations 🚩

• config: Deprecate multiple types and funcs in config package (#6422)

  • config.ComponentID => component.ID
  • config.Type => component.Type
  • config.DataType => component.DataType
  • config.[Traces|Metrics|Logs]DataType => component.DataType[Traces|Metrics|Logs]
  • config.Receiver => component.ReceiverConfig
  • config.UnmarshalReceiver => component.UnmarshalReceiverConfig
  • config.Processor => component.ProcessorConfig
  • config.UnmarshalProcessor => component.UnmarshalProcessorConfig
  • config.Exporter => component.ExporterConfig
  • config.UnmarshalExporter => component.UnmarshalExporterConfig
  • config.Extension => component.ExtensionConfig
  • config.UnmarshalExtension => component.UnmarshalExtensionConfig

• obsreport: deprecate obsreport.New[Receiver|Scraper|Processor|Exporter] in favor of obsreport.MustNew[Receiver|Scraper|Processor|Exporter] (#6458)

• config/configgrpc: Provide better helpers for configgrpc, consistent with confighttp (#6441)

  • Deprecate GRPCClientSettings.ToDialOptions in favor of GRPCClientSettings.ToClientConn.
  • Deprecate GRPCServerSettings.ToServerOption in favor of GRPCServerSettings.ToServer.

• featuregates: Removing Gates being configurable externally to the Registry (#6167)

  • Deprecate Gate.ID in favour of Registry.RegisterID
  • Deprecate Gate.Enabled in favour of Gate.IsEnabled()
  • Deprecate Gate.Description in favour of WithRegisterDescription to be used with Registry.RegisterID
  • Deprecate Registry.Register in favour of Registry.RegisterID
  • Deprecate Registry.MustRegister in favour of Registry.MustRegisterID

💡 Enhancements 💡

• service/telemetry: Allow to configure sampling config for logs. (#4554)
• featuregates: Extend feature gate definition to include support for issue links and expected deprecated version (#6167)
• receiver/otlp: Add warning when using unspecified (0.0.0.0) address on HTTP or gRPC servers (#6151)
• obsreport: Instrument obsreport.Exporter metrics with otel-go (#6346)
• config: Add validation for empty address [telemetry::metrics::address] (#5661)

🧰 Bug fixes 🧰

• cgroups: split line into exactly 3 parts while parsing /proc/{pid}/cgroup (#6389)
• cgroups: Use int64 for cgroup v1 parsing (#6443)

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