v1.14.0/v0.108.0

Images and binaries here: https://github.com/open-telemetry/opentelemetry-collector-releases/releases/tag/v0.108.0

End User Changelog

🛑 Breaking changes 🛑

• all: Added support for go1.23, bumped the minimum version to 1.22 (#10869)
• otelcol: Remove deprecated ConfmapProvider interface. (#10934)
• confmap: Mark confmap.strictlyTypedInput as stable (#10552)

💡 Enhancements 💡

• exporter/otlp: Add batching option to otlp exporter (#8122)
• builder: Add a --skip-new-go-module flag to skip creating a module in the output directory. (#9252)
• component: Add TelemetrySettings.LeveledMeterProvider func to replace MetricsLevel in the near future (#10931)
• mdatagen: Add LeveledMeter method to mdatagen (#10933)
• service: Adds level configuration option to service::telemetry::trace to allow users to disable the default TracerProvider (#10892)
  This replaces the feature gate service.noopTracerProvider introduced in v0.107.0
• componentstatus: Add new Reporter interface to define how to report a status via a component.Host implementation (#10852)
• mdatagen: support using a different github project in mdatagen README issues list (#10484)
• mdatagen: Updates mdatagen's usage to output a complete command line example, including the metadata.yaml file. (#10886)
• extension: Add ModuleInfo to extension.Settings to allow extensions to access component go module information. (#10876)
• confmap: Mark module as stable (#9379)

🧰 Bug fixes 🧰

• batchprocessor: Update units for internal telemetry (#10652)
• confmap: Fix bug where an unset env var used with a non-string field resulted in a panic (#10950)
• service: Fix memory leaks during service package shutdown (#9165)
• mdatagen: Update generated telemetry template to only include context import when there are async metrics. (#10883)
• mdatagen: Fixed bug in which setting SkipLifecycle & SkipShutdown to true would result in a generated file with an unused import confmaptest (#10866)
• confmap: Use string representation for field types where all primitive types are strings. (#10937)
• otelcol: Preserve internal representation when unmarshaling component configs (#10552)

API Changes

🛑 Breaking changes 🛑

• extensions: Remove StatusWatcher interface. Use componentstatus.Watcher instead. (#10777)
• component: Removed Status related types and functions. Use componentstatus instead. (#10777)
• component: Remove ReportStatus from TelemetrySettings. Use componentstatus.ReportStatus instead. (#10777)
• componentstatus: Make componentstatus.InstanceID immutable. (#10494)

🚩 Deprecations 🚩

• scraperhelper: deprecate NewObsReport, ObsReport, ObsReportSettings, scrapers should use NewScraperControllerReceiver (#10959)
• mdatagen: Deprecating generated Meter func in favour of LeveledMeter (#10939)
• connector: Deprecate connector.Builder, and move it into an internal package of the service module (#10784)
• exporter: Deprecate exporter.Builder, and move it into an internal package of the service module (#10783)
• extension: Deprecate extension.Builder, and move it into an internal package of the service module (#10785)
• processor: Deprecate processor.Builder, and move it into an internal package of the service module (#10782)
• receiver: Deprecate receiver.Builder, and move it into an internal package of the service module (#10781)

v1.13.0/v0.107.0

Images and binaries here: https://github.com/open-telemetry/opentelemetry-collector-releases/releases/tag/v0.107.0

End User Changelog

v1.13.0/v0.107.0

🛑 Breaking changes 🛑

• service: Remove OpenCensus bridge completely, mark feature gate as stable. (#10414)
• confmap: Set the confmap.unifyEnvVarExpansion feature gate to Stable. Expansion of $FOO env vars is no longer supported. Use ${FOO} or ${env:FOO} instead. (#10508)
• service: Remove otelcol from Prometheus configuration. This means that any metric that isn't explicitly prefixed with otelcol_ no longer have that prefix. (#9759)

💡 Enhancements 💡

• mdatagen: export ScopeName in internal/metadata package (#10845)
  This can be used by components that need to set their scope name manually. Will save component owners from having to store a variable, which may diverge from the scope name used by the component for emitting its own telemetry.

• semconv: Add v1.26.0 semantic conventions package (#10249, #10829)

• mdatagen: Expose a setting on tests::host to set up your own host initialization code (#10765)
  Some receivers require a host that has additional capabilities such as exposing exporters.
  For those, we can expose a setting that allows them to place a different host in the generated code.

• confmap: Allow using any YAML structure as a string when loading configuration. (#10800)
  Previous to this change, slices could not be used as strings in configuration.

• ocb: migrate build and release of ocb binaries to opentelemetry-collector-releases repository (#10710)
  ocb binaries will now be released under open-telemetry/opentelemetry-collector-releases tagged as "cmd/builder/vX.XXX.X"

• semconv: Add semantic conventions version v1.27.0 (#10837)

• client: Mark module as stable. (#10775)

🧰 Bug fixes 🧰

• configtelemetry: Add 10s read header timeout on the configtelemetry Prometheus HTTP server. (#5699)

• service: Allow users to disable the tracer provider via the feature gate service.noopTracerProvider (#10858)
  The service is returning an instance of a SDK tracer provider regardless of whether there were any processors configured causing resources to be consumed unnecessarily.

• processorhelper: Fix processor metrics not being reported initially with 0 values. (#10855)

• service: Implement the temporality_preference setting for internal telemetry exported via OTLP (#10745)

• configauth: Fix unmarshaling of authentication in HTTP servers. (#10750)

• confmap: If loading an invalid YAML string through a provider, use it verbatim instead of erroring out. (#10759)
  This makes the ${env:ENV} syntax closer to how ${ENV} worked before unifying syntaxes.

• component: Allow component names of up to 1024 characters in length. (#10816)

• confmap: Remove original string representation if invalid. (#10787)

Go API Changelog

v1.13.0/v0.107.0

🛑 Breaking changes 🛑

• otelcol: Delete deprecated NewCommandMustSetProvider (#10778)
• component: Removes the deprecated Host.GetFactory method. (#10771)
• otelcoltest: The otelcol.LoadConfig method no longer sets the expandconverter. (#10510)
• ocb: Collectors built with OCB will no longer include the expandconverter (#10510)
• exporterhelper: Delete deprecated exporterhelper.ObsReport and exporterhelper.NewObsReport (#10779, #10592)

🚩 Deprecations 🚩

• expandconverter: Deprecate expandconverter. (#10510)

🚀 New components 🚀

• componentstatus: Adds new componentstatus module that will soon replace status content in component. (#10730)
• connector/connectorprofiles: Allow handling profiles in connector. (#10703)
• exporter/exporterprofiles: Allow handling profiles in exporter. (#10702)
• processor/processorprofiles: Allow handling profiles in processor. (#10691)
• receiver/receiverprofiles: Allow handling profiles in receiver. (#10690)

💡 Enhancements 💡

• confmap: Check that providers have a correct scheme when building a confmap.Resolver. (#10786)
• confighttp: Add NewDefaultCORSConfig function to initialize the default confighttp.CORSConfig (#9655)

v0.106.1

Images and binaries here: https://github.com/open-telemetry/opentelemetry-collector-releases/releases/tag/v0.106.1

End User Changelog

v0.106.1

🧰 Bug fixes 🧰

• configauth: Fix unmarshaling of authentication in HTTP servers. (#10750)

cmd/builder/v0.106.1

Images and binaries here: https://github.com/open-telemetry/opentelemetry-collector-releases/releases/tag/v0.106.1

v0.106.0

Images and binaries here: https://github.com/open-telemetry/opentelemetry-collector-releases/releases/tag/v0.106.0

End User Changelog

v0.106.0

🛑 Breaking changes 🛑

• service: Update all metrics to include otelcol_ prefix to ensure consistency across OTLP and Prometheus metrics (#9759)
  This change is marked as a breaking change as anyone that was using OTLP for metrics will
  see the new prefix which was not present before. Prometheus generated metrics remain
  unchanged.

• confighttp: Delete ClientConfig.CustomRoundTripper (#8627)
  Set (*http.Client).Transport on the *http.Client returned from ToClient to configure this.

• confmap: When passing configuration for a string field using any provider, use the verbatim string representation as the value. (#10605, #10405)
  This matches the behavior of ${ENV} syntax prior to the promotion of the confmap.unifyEnvVarExpansion feature gate
  to beta. It changes the behavior of the ${env:ENV} syntax with escaped strings.

• component: Adds restrictions on the character set for component.ID name. (#10673)

• processor/memorylimiter: The memory limiter processor will no longer account for ballast size. (#10696)
  If you are already using GOMEMLIMIT instead of the ballast extension this does not affect you.

• extension/memorylimiter: The memory limiter extension will no longer account for ballast size. (#10696)
  If you are already using GOMEMLIMIT instead of the ballast extension this does not affect you.

• service: The service will no longer be able to get a ballast size from the deprecated ballast extension. (#10696)
  If you are already using GOMEMLIMIT instead of the ballast extension this does not affect you.

🚀 New components 🚀

• client: Create a new go module go.opentelemetry.io/collector/client (#9804)
  This module contains generic representations of clients connecting to different receivers.

💡 Enhancements 💡

• exporterhelper: Add data_type attribute to otelcol_exporter_queue_size metric to report the type of data being processed. (#9943)
• confighttp: Add option to include query params in auth context (#4806)
• configgrpc: gRPC auth errors now return gRPC status code UNAUTHENTICATED (16) (#7646)
• httpprovider, httpsprovider: Validate URIs in HTTP and HTTPS providers before fetching. (#10468)

🧰 Bug fixes 🧰

• processorhelper: update units for internal telemetry (#10647)
• confmap: Increase the amount of recursion and URI expansions allowed in a single line (#10712)
• exporterhelper: There is no guarantee that after the exporterhelper sends the plog/pmetric/ptrace data downstream that the data won't be mutated in some way. (e.g by the batch_sender) This mutation could result in the proceeding call to req.ItemsCount() to provide inaccurate information to be logged. (#10033)
• exporterhelper: Update units for internal telemetry (#10648)
• receiverhelper: Update units for internal telemetry (#10650)
• scraperhelper: Update units for internal telemetry (#10649)
• service: Use Command/Version to populate service name/version attributes (#10644)

Go API Changelog

v0.106.0

🛑 Breaking changes 🛑

• configauth: removing deprecated methods GetServerAuthenticatorContext and GetClientAuthenticatorContext (#9808)

• connector,exporter,receiver,extension,processor: Remove deprecated funcs/structs (#10423)
  Remove the following funcs & structs:

  • connector.CreateSettings -> connector.Settings
  • connectortest.NewNopCreateSettings -> connectortest.NewNopSettings
  • exporter.CreateSettings -> exporter.Settings
  • exportertest.NewNopCreateSettings -> exportertest.NewNopSettings
  • extension.CreateSettings -> extension.Settings
  • extensiontest.NewNopCreateSettings -> extensiontest.NewNopSettings
  • processor.CreateSettings -> processor.Settings
  • processortest.NewNopCreateSettings -> processortest.NewNopSettings
  • receiver.CreateSettings -> receiver.Settings
  • receivertest.NewNopCreateSettings -> receivertest.NewNopSettings

• component/componenttest: Add optional ...attribute.KeyValue argument to TestTelemetry.CheckExporterMetricGauge. (#10593)

• confighttp: Auth data type signature has changed (#4806)
  As part of the linked PR, the auth attribute was moved from configauth.Authentication
  to a new AuthConfig, which contains a configauth.Authentication. For end-users, this
  is a non-breaking change. For users of the API, create a new AuthConfig using the
  configauth.Authentication instance that was being used before.

• mdatagen: Remove WithAttributes option from the telemetry builder constructor. (#10608)
  Attribute sets for async instruments now can be set as options to callback setters and async instruments initializers.
  This allows each async instrument to have its own attribute set.

• service/extensions: Adds Options to extensions.New. (#10728)
  This is only a breaking change if you are depending on extensions.New's signature. Calls to extensions.New are not broken.

🚩 Deprecations 🚩

• component: Deprecates Host.GetFactory. (#10709)

🚀 New components 🚀

• component/componentprofiles: Add componentprofiles module. (#10525)

💡 Enhancements 💡

• exporter, processor, receiver: Document factory functions. (#9323)
• component: Document status enums and New constructors (#9822)
• confighttp, configgrpc: Remove the experimental comment on IncludeMetadata in confighttp and configgrpc (#9381)
• confighttp: Add confighttp.NewDefaultServerConfig() to instantiate the default HTTP server configuration (#9655)
• consumer/consumertest: Allow testing profiles with consumertest. (#10692)

🧰 Bug fixes 🧰

• confmap: Fix wrong expansion of environment variables escaped with $$, e.g. $${ENV_VAR} and $$ENV_VAR. (#10713)
  This change fixes the issue where environment variables escaped with $$ were expanded.
  The collector now converts $${ENV_VAR} to ${ENV_VAR} and $$ENV_VAR to $ENV_VAR without further expansion.

cmd/builder/v0.106.0

Images and binaries here: https://github.com/open-telemetry/opentelemetry-collector-releases/releases/tag/v0.106.0

v1.12.0/v0.105.0

Images and binaries here: https://github.com/open-telemetry/opentelemetry-collector-releases/releases/tag/v0.105.0

End User Changelog

v1.12.0/v0.105.0

🛑 Breaking changes 🛑

• service: add service.disableOpenCensusBridge feature gate which is enabled by default to remove the dependency on OpenCensus (#10414)
• confmap: Promote confmap.strictlyTypedInput feature gate to beta. (#10552)
  This feature gate changes the following:
  • Configurations relying on the implicit type casting behaviors listed on #9532 will start to fail.
  • Configurations using URI expansion (i.e. field: ${env:ENV}) for string-typed fields will use the value passed in ENV verbatim without intermediate type casting.

💡 Enhancements 💡

• configtls: Mark module as stable. (#9377)
• confmap: Remove extra closing parenthesis in sub-config error (#10480)
• configgrpc: Update the default load balancer strategy to round_robin (#10319)
  To restore the behavior that was previously the default, set balancer_name to pick_first.
• cmd/builder: Add go module info the builder generated code. (#10570)
• otelcol: Add go module to components subcommand. (#10570)
• confmap: Add explanation to errors related to confmap.strictlyTypedInput feature gate. (#9532)
• confmap: Allow using map[string]any values in string interpolation (#10605)

🧰 Bug fixes 🧰

• builder: provide context when a module in the config is missing its gomod value (#10474)
• confmap: Fixes issue where confmap could not escape $$ when confmap.unifyEnvVarExpansion is enabled. (#10560)
• mdatagen: fix generated comp test for extensions and unused imports in templates (#10477)
• otlpreceiver: Fixes a bug where the otlp receiver's http response was not properly translating grpc error codes to http status codes. (#10574)
• exporterhelper: Fix incorrect deduplication of otelcol_exporter_queue_size and otelcol_exporter_queue_capacity metrics if multiple exporters are used. (#10444)
• service/telemetry: Add ability to set service.name for spans emitted by the Collector (#10489)
• internal/localhostgate: Correctly log info message when component.UseLocalHostAsDefaultHost is enabled (#8510)

Go API Changelog

v1.12.0/v0.105.0

🛑 Breaking changes 🛑

• otelcol: Obtain the Collector's effective config from otelcol.Config (#10139)
  otelcol.Collector will now marshal confmap.Conf objects from otelcol.Config itself.
• otelcoltest: Remove deprecated methods LoadConfigWithSettings and LoadConfigAndValidateWithSettings (#10512)

🚩 Deprecations 🚩

• configauth: Deprecated Authentication.GetClientAuthenticatorContext and Authentication.GetServerAuthenticatorContext (#10578)
• otelcol: Deprecate otelcol.ConfmapProvider (#10139)
  otelcol.Collector will now marshal confmap.Conf objects from otelcol.Config itself.
• otelcol: Deprecate (*otelcol.ConfigProvider).GetConfmap (#10139)
  Call (*confmap.Conf).Marshal(*otelcol.Config) to get the Collector's configuration.
• exporterhelper: Deprecate the obsreport API in the exporterhelper package. (#10592)

🚀 New components 🚀

• consumer/consumerprofiles: Allow handling profiles in consumer. (#10464)

cmd/builder/v0.105.0

Images and binaries here: https://github.com/open-telemetry/opentelemetry-collector-releases/releases/tag/v0.105.0

v1.11.0/v0.104.0

Images and binaries here: https://github.com/open-telemetry/opentelemetry-collector-releases/releases/tag/v0.104.0

⚠️ This release includes 2 very important breaking changes.

1. The otlpreceiver now uses localhost by default instead of 0.0.0.0. This may break the receiver in containerized environments like Kubernetes. If you depend on 0.0.0.0 disable the component.UseLocalHostAsDefaultHost feature gate or explicitly set the endpoint to 0.0.0.0.
2. Expansion of BASH-style environment variables, such as $FOO is no longer supported by default. If you depend on this syntax, disable the confmap.unifyEnvVarExpansion feature gate, but know that the feature will be removed in the future in favor of ${env:FOO}.

End User Changelog

🛑 Breaking changes 🛑

• filter: Remove deprecated filter.CombinedFilter (#10348)
• otelcol: By default, otelcol.NewCommand and otelcol.NewCommandMustSetProvider will set the DefaultScheme to env. (#10435)
• expandconverter: By default expandconverter will now error if it is about to expand $FOO syntax. Update configuration to use ${env:FOO} instead or disable the confmap.unifyEnvVarExpansion feature gate. (#10435)
• otlpreceiver: Switch to localhost as the default for all endpoints. (#8510)
  Disable the component.UseLocalHostAsDefaultHost feature gate to temporarily get the previous default.

💡 Enhancements 💡

• confighttp: Add support for cookies in HTTP clients with cookies::enabled. (#10175)
  The method confighttp.ToClient will return a client with a cookiejar.Jar which will reuse cookies from server responses in subsequent requests.
• exporter/debug: In normal verbosity, display one line of text for each telemetry record (log, data point, span) (#7806)
• exporter/debug: Add option use_internal_logger (#10226)
• configretry: Mark module as stable. (#10279)
• debugexporter: Print Span.TraceState() when present. (#10421)
  Enables viewing sampling threshold information (as by OTEP 235 samplers).
• processorhelper: Add "inserted" metrics for processors. (#10353)
  This includes the following metrics for processors:
  • processor_inserted_spans
  • processor_inserted_metric_points
  • processor_inserted_log_records

🧰 Bug fixes 🧰

• otlpexporter: Update validation to support both dns:// and dns:/// (#10449)
• service: Fixed a bug that caused otel-collector to fail to start with ipv6 metrics endpoint service telemetry. (#10011)

Go API Changelog

🛑 Breaking changes 🛑

• otelcol: The otelcol.NewCommand now requires at least one provider be set. (#10436)
• component/componenttest: Added additional "inserted" count to TestTelemetry.CheckProcessor* methods. (#10353)

🚩 Deprecations 🚩

• otelcoltest: Deprecates LoadConfigWithSettings and LoadConfigAndValidateWithSettings. Use LoadConfig and LoadConfigAndValidate instead. (#10417)
• otelcol: The otelcol.NewCommandMustSetProvider is deprecated. Use otelcol.NewCommand instead. (#10436)

🚀 New components 🚀

• otelcoltest: Split off go.opentelemetry.io/collector/otelcol/otelcoltest into its own module (#10417)

💡 Enhancements 💡

• pdata/pprofile: Add pprofile wrapper to convert proto into pprofile. (#10401)
• pdata/testdata: Add pdata testdata for profiles. (#10401)

cmd/builder/v0.104.0

Images and binaries here: https://github.com/open-telemetry/opentelemetry-collector-releases/releases/tag/v0.104.0