60 KiB
Go API Changelog
This changelog includes only developer-facing changes. If you are looking for user-facing changes, check out CHANGELOG.md.
v1.29.0/v0.123.0
🛑 Breaking changes 🛑
-
otlpreceiver/otlpexporter/otlphttpexporter: Avoid using go embedded messages in Config (#12718) -
exporterqueue: Move Queue interface to internal, disallow alternative implementations (#12680) -
extensionauth, configauth: Remove deprecated types and functions fromextensionauthandconfigauthpackages. (#12672) This includes:extensionauth.NewClient,extensionauth.ClientOptionand all its implementations,extensionauth.NewServer,extensionauth.ServerOptionand all its implementations andconfigauth.Authenticator.GetClientAuthenticator.
-
exporterhelper: Remove deprecated converter types from exporterhelper (#12686) -
exporterbatch: Remove deprecated fieldsmin_size_itemsandmax_size_itemsfrom batch config. (#12684)
🚩 Deprecations 🚩
exporterhelper: Deprecate BatcherConfig, SizeConfig and WithBatcher in favor of the new QueueBatchConfig. (#12748)exporterbatcher: Deprecated Config, SizeConfig, SizerType, SizerType[Requests|Items|Bytes], NewDefaultConfig. Use alias from exporterhelper. (#12707)exporterqueue: Deprecated Config, NewDefaultConfig, Encoding, ErrQueueFull. Use alias from exporterhelper. (#12706)exporterhelper: Deprecate exporterhelper WithRequestQueue in favor of WithQueueBatch (#12679)exporterhelper: DeprecateQueueConfigin favor ofQueueBatchConfig. (#12746)
💡 Enhancements 💡
extensionauth: Mark module as stable (#11006)processor: Mark module as stable. (#12677)processorhelper: Split processorhelper into a separate module. (#12678)
v1.28.1/v0.122.1
v1.28.0/v0.122.0
🛑 Breaking changes 🛑
-
auth, authtest: Remove deprecated modules extension/auth and extension/auth/authtest (#12543) Use extension/extensionauth and extension/extensionauth/extensionauthtest instead. -
extensionauth: Remove deprecated methods from theFunctypes. (#12547) -
extensiontest, connectortest, processortest, receivertest, scrapertest, exportertest: Remove deprecatedNewNopSettingsWithTypefunctions, useNewNopSettingsinstead. (#12221) -
extensionauthtest: Remove theextensionauthtest.MockClientstruct. (#12567)- Use
extensionauthtest.NewNopClientto create a client with a noop implementation. - Use
extensionauthtest.NewErrorClientto create a client that always returns an error. - Implement the
extensionauthinterfaces for custom mock client implementations.
- Use
-
component/componenttest: Remove the deprecated componenttest.TestTelemetry in favor of componenttest.Telemetry (#12419) -
exporterhelper: Remove the Request.Export function in favor of an equivalent request consume func in the New[Traces|Metrics|Logs|Profiles]Request (#12637)
🚩 Deprecations 🚩
-
exporterhelper: Deprecate per signal converter in favor of generic version (#12631) -
extensionauth: Deprecateextensionauth.NewClientandextensionauth.NewServer. (#12574)- Manually implement the interfaces instead.
-
configauth: Deprecateconfigauth.Authenticator.GetClientAuthenticator. (#12574)- Use the per-protocol methods instead.
🚀 New components 🚀
receiverhelper: Splitreceiverhelperinto a separate module (#28328)
💡 Enhancements 💡
cmd/mdatagen: AddsupportsSignalfunc forMetadatatype inmdatagen. (#12640)receiver: Mark module as stable (#12513)pdata/pcommon: IntroduceEqual()method for comparison equality toValue,ByteSlice,Float64Slice,Int32Slice,Int64Slice,StringSlice,Uint64Slice,MapandSlice(#12594)pdata: Add iterator All method to pdata slices and map types. (#11982)pdata/pprofile: Introduce AddAttribute helper method to modify the content of attributable records (#12206)
v1.27.0/v0.121.0
🛑 Breaking changes 🛑
-
exporterqueue: Remove exporterqueue.Factory in favor of the NewQueue function, and merge configs for memory and persistent. (#12509) As a side effect of this change, no alternative implementation of the queue are supported and the Queue interface will be hidden. -
exporterhelper: Update MergeSplit function signature to use the new SizeConfig (#12486) -
extension, connector, processor, receiver, exporter, scraper: Remove deprecatedCreate*methods fromCreate*Functypes. (#12305) Thexconnector.CreateMetricsToProfilesFunc.CreateMetricsToProfilesmethod has been removed without a deprecation. -
component: Remove deprecated function and interfaceConfigValidatorandValidateConfig. (#11524)- Use
xconfmap.Validatorandxconfmap.Validateinstead.
- Use
-
receiver, scraper, processor, exporter, extension: Remove deprecated MakeFactoryMap functions in favor of generic implementation (#12222) -
exporterhelper: Change the signature of the exporterhelper.WithQueueRequest to accept Encoding instead of the Factory. (#12509) -
component/componenttest: Removing the deprecatedCheckReceiverMetricsandCheckReceiverTracesfunctions. (#12185)
🚩 Deprecations 🚩
componenttest: Deprecated componenttest.TestTelemetry in favor of componenttest.Telemetry (#12419)connector, exporter, extension, processor, receiver, scraper: Add type parameter toNewNopSettingsand deprecateNewNopSettingsWithType(#12305)exporterhelper: Deprecate MinSizeConfig and MaxSizeItems. (#12486)extension/extensionauth: Deprecate methods on*Functypes. (#12480)extension/auth, extension/auth/authtest: Deprecate extension/auth and the related test module in favor of extension/extensionauth (#12478)
🚀 New components 🚀
service/hostcapabilities: createservice/hostcapabilitiesmodule (#12296, #12375) Removes getExporters interface in service/internal/graph. Removes getModuleInfos interface in service/internal/graph. Creates interface ExposeExporters in service/hostcapabilities to expose GetExporters function. Creates interface ModuleInfo in service/hostcapabilities to expose GetModuleInfos function.
💡 Enhancements 💡
exporterhelper: Adds the config API to support serialized bytes based batching (#3262)configauth: Add theomitemptymapstructure tag to struct fields (#12191) This results in unset fields not being rendered when marshaling.confighttp: Add theomitemptymapstructure tag to struct fields (#12191) This results in unset fields not being rendered when marshaling.otelcol: Converters are now available in thecomponentscommand. (#11900, #12385)extension: Mark module as stable (#11005)pcommon.Map: preallocate go map in Map.AsRaw() (#12406)exporterhelper: Stabilize exporter.UsePullingBasedExporterQueueBatcher and remove old batch sender (#12425)service: Add theomitemptymapstructure tag to struct fields (#12191) This results in unset fields not being rendered when marshaling.
🧰 Bug fixes 🧰
mdatagen: Fix broken imports in the generated files. (#12298)processor, connector, exporter, receiver: Explicitly error out at component creation time if there is a type mismatch. (#12305)
v1.26.0/v0.120.0
🛑 Breaking changes 🛑
-
configauth: Remove NewDefaultAuthentication (#12223) The value returned by this function will always cause an error on startup. Inconfiggrpc.Client/ServerConfig.Auth,nilshould be used instead to disable authentication. -
otelcol: Make theConfigProviderinterface a struct (#12297) Calls toNewConfigProviderwill now return*ConfigProvider, but will otherwise work the same as before. -
extension: Removeextension.Settings.ModuleInfo(#12296)- The functionality is now available as an optional, hidden interface on
service's implementation of theHost
- The functionality is now available as an optional, hidden interface on
-
component: Remove deprecated fieldcomponent.TelemetrySettings.MetricsLevel. (#11061) -
confighttp: AddToClientOptiontype and add it to signature ofToClientmethod. (#12353)- This has no use for now, it may be used in the future.
-
mdatagen: Remove unused not_component config for mdatagen (#12237)
🚩 Deprecations 🚩
component/componenttest: Deprecate CheckReceiverMetrics in componenttest (#12185) Use themetadatatest.AssertEqualMetricseries of functions instead ofobsreporttest.CheckReceiverMetricscomponent/componenttest: Deprecate CheckReceiverTraces in componenttest (#12185) Use themetadatatest.AssertEqualMetricseries of functions instead ofobsreporttest.CheckReceiverTracescomponent: DeprecateConfigValidatorandValidateConfig(#11524) Please useValidatorandValidaterespectively fromxconfmap.receiver, scraper, processor, exporter, extension: Deprecate existing MakeFactoryMap functions in favor of generic implementation (#12222)extension, connector, processor, receiver, exporter, scraper: DeprecateCreate*methods fromCreate*Functypes. (#12305)extensiontest, connectortest, processortest, receivertest, exportertest, scrapertest: Deprecate*test.NewNopSettingsin favor of*test.NewNopSettingsWithType(#12305)
🚀 New components 🚀
xconfmap: Create the xconfmap module and add theValidatorinterface andValidatefunction to facilitate config validation (#11524)
💡 Enhancements 💡
configgrpc: Add theomitemptymapstructure tag to struct fields (#12191) This results in unset fields not being rendered when marshaling.confignet: Add theomitemptymapstructure tag to struct fields (#12191) This results in unset fields not being rendered when marshaling.configtls: Add theomitemptymapstructure tag to struct fields (#12191) This results in unset fields not being rendered when marshaling.consumer: Clarify that data cannot be accessed after Consume* func is called. (#12284)pdata/pprofile: Introduce aggregation temporality constants (#12253)
🧰 Bug fixes 🧰
-
configgrpc: Apply configured Headers automatically (#12307) configgrpc now calls metadata.AppendToOutgoingContext automatically in an interceptor. Components that were manually using metadata.NewOutgoingContext as a workaround no longer need to do so, unless they are overwriting or adding header keys. -
configgrpc: Set Auth to nil in NewDefaultClientConfig/NewDefaultServerConfig (#12223) The value that was used previously would always cause an error on startup. -
exporterqueue: Fix async queue to propagate cancellation all they way to the queue (#12282) -
otlpreceiver: Fix OTLP http receiver to correctly set Retry-After (#12367) -
extension: Explicitly error out at extension creation time if there is a type mismatch. (#12305)
v1.25.0/v0.119.0
🛑 Breaking changes 🛑
exporterhelper: Change queue to embed the async consumers. (#12242)exporterqueue: Change Queue interface to return a callback instead of an index (#8122)cmd/mdatagen: Allow passing OTel Metric SDK options to the generatedSetupTelemetryfunction. (#12166)exporterhelper: Rename exporter span signal specific attributes (e.g. "sent_spans" / "send_failed_span") to "items.sent" / "items.failed". (#12165)component: Change underlying type forcomponent.Kindto be a struct. (#12214)extension: Changeextension.Extensionto be an interface that embedscomponent.Componentinstead of an alias (#11443)component/componenttest: Remove deprecatedCheckScraperMetricsfunctions (#12183)scraperhelper: Remove deprecated ScrapperControllerOption and NewScraperControllerMetrics from scraperhelper. (#12147)
🚩 Deprecations 🚩
-
metadatatest: Deprecate metadatatest.Telemetry in favor of componenttest.Telemetry (#12218) metadatatest.Telemetry -> componenttest.Telemetry | metadatatest.SetupTelemetry -> componenttest.NewTelemetry | metadatatest.Telemetry.NewSettings -> metadatatest.NewSettings | metadatatest.Telemetry.AssertMetrics -> metadatatest.AssertEqual* | -
component/componenttest: DeprecateCheckExporterEnqueue*functions in componenttest (#12185) Use themetadatatest.AssertEqualMetricseries of functions instead ofobsreporttest.CheckExporterEnqueue*functions. -
component/componenttest: Deprecate CheckExporterLogs in componenttest (#12185) Use themetadatatest.AssertEqualMetricseries of functions instead ofobsreporttest.CheckExporterLogs -
component/componenttest: Deprecate CheckExporterMetricGauge in componenttest (#12185) Use themetadatatest.AssertEqualMetricseries of functions instead ofobsreporttest.CheckReceiverMetricGauge -
component/componenttest: Deprecate CheckExporterMetrics in componenttest (#12185) Use themetadatatest.AssertEqualMetricseries of functions instead ofobsreporttest.CheckExporterMetrics -
component/componenttest: Deprecate CheckExporterTraces in componenttest (#12185) Use themetadatatest.AssertEqualMetricseries of functions instead ofobsreporttest.CheckExporterTraces -
component/componenttest: Deprecate CheckReceiverLogs in componenttest (#12185) Use themetadatatest.AssertEqualMetricseries of functions instead ofobsreporttest.CheckReceiverLogs -
mdatagen: Make registration of callback for async metric always optional. (#12204) Deprecatemetadata.TelemetryBuilder.Init*andmetadata.With*Callbackin favor ofmetadata.TelemetryBuilder.Register*Callback -
component: Deprecatecomponent.TelemetrySettings.MetricsLevelin favor of using views and 'Enabled' method. (#12159)- Components will temporarily need the service to support using views.
💡 Enhancements 💡
componenttest: Add helper to get a metric for componentest.Telemetry (#12215)componenttest: Extract componenttest.Telemetry as generic struct for telemetry testing (#12151)mdatagen: Generate assert function for each metric in mdatagen (#12179)metadatatest: Generate NewSettings that accepts componenttest.Telemetry (#12216)pdata/pprofile: Add new helper methodFromAttributeIndicesto build apcommon.Mapout ofAttributeIndices. (#12176)scraper: Support logs scraper (#12116)component: Allowcomponent.ValidateConfigto recurse through all fields in a config object (#11524)component: Show path to invalid config in errors returned fromcomponent.ValidateConfig(#12108)
🧰 Bug fixes 🧰
mdatagen: All register callbacks to async instruments can now be unregistered by callingmetadata.TelemetryBuilder.Shutdown()(#12204)mdatagen: Fix bug where Histograms were marked as not supporting temporal aggregation (#12168)
v1.24.0/v0.118.0
🛑 Breaking changes 🛑
exporterqueue: Change Queue Size and Capacity to return explicit int64. (#12076)receiver/scraperhelper: Removing the deprecated receiver/scraperhelper package (#12054)processortest: Revert the nop_processor.NewNopSettings change, as it is no longer needed (#11433)experimental/storage: Remove deprecated package/module experimental/storage (#12109)mdatagen: Remove deprecated generated_component_telemetry_test file from being generated and delete it. (#12068)receivertest: Remove deprecated receivertest.NewNopFactoryForType (#12110)
🚩 Deprecations 🚩
componenttest: Deprecate CheckScraperMetrics in componenttest (#12105) Usemetadatatest.AssertMetricsinstead ofobsreporttest.CheckScraperMetricsscraperhelper: Deprecatescraperhelper.NewScraperControllerReceiverandscraperhelper.ScraperControllerOption. (#12103) Usescraperhelper.NewMetricsControllerinstead ofscraperhelper.NewScraperControllerReceiver| Usescraperhelper.ScraperControllerOptioninstead ofscraperhelper.ControllerOption
💡 Enhancements 💡
exporterhelper: Add capability for memory and persistent queue to block when add items (#12074)scraper/scraperhelper: Add obs_logs for scraper/scraperhelper (#12036) This change adds obs for logs in scraper/scraperhelper, also introduced new metrics for scraping logs.mdatagen: Add scraper component type support to mdatagen (#12092)mdatagen: Add tracing support in metadatatest (#12106)exporterhelper: Change persistent queue to not use sized channel, improve memory usage and simplify sized_channel. (#12060)confighttp: Added support for configuring compression levels. (#10467) A new configuration option called CompressionParams has been added to confighttp. | This allows users to configure the compression levels for the confighttp client.
v1.23.0/v0.117.0
🛑 Breaking changes 🛑
pdata/pprofile: Remove duplicate Attributes field from profile (#11932)connector: Remove deprecated connectorprofiles module, use xconnector instead. (#11778)consumererror: Remove deprecated consumererrorprofiles module, use xconsumererror instead. (#11778)consumer: Remove deprecated consumerprofiles module, use xconsumer instead. (#11778)exporterhelper: Remove deprecated exporterhelperprofiles module, use xexporterhelper instead. (#11778)exporter: Remove deprecated exporterprofiles module, use xexporter instead. (#11778)pipeline: Remove deprecated pipelineprofiles module, use xpipeline instead. (#11778)processorhelper: Remove deprecated processorhelperprofiles module, use xprocessorhelper instead. (#11778)processor: Remove deprecated processorprofiles module, use xprocessor instead. (#11778)receiver: Remove deprecated receiverprofiles module, use xreceiver instead. (#11778)exporterhelper: Remove Merge function from experimental Request interface (#12012)
🚩 Deprecations 🚩
mdatagen: Deprecate component_test in favor of metadatatest (#11812)receivertest: Deprecate receivertest.NewNopFactoryForType (#11993)extension/experimental: Deprecate extension/experimental in favor of extension/xextension (#12010)scraperhelper: Move scraperhelper under scraper and in a separate module. (#11003)
💡 Enhancements 💡
scrapertest: Add scrapertest package in a separate module (#11988)pdata: Upgrade pdata to opentelemetry-proto v1.5.0 (#11932)
v1.22.0/v0.116.0
🛑 Breaking changes 🛑
component: Remove deprecated TelemetrySettings.LeveledMeterProvider (#11811)scraperhelper: Remove deprecated scraperhelper.Scraper and helpers (#11803)
🚩 Deprecations 🚩
connector: Deprecate connectorprofiles module in favor of xconnector to allow adding more experimental data types. (#11778)consumererror: Deprecate consumererrorprofiles module in favor of xconsumererror to allow adding more experimental data types. (#11778)consumer: Deprecate consumerprofiles module in favor of xconsumer to allow adding more experimental data types. (#11778)exporterhelper: Deprecate exporterhelperprofiles module in favor of xexporterhelper to allow adding more experimental data types. (#11778)exporter: Deprecate exporterprofiles module in favor of xexporter to allow adding more experimental data types. (#11778)pipeline: Deprecate pipelineprofiles module in favor of xpipeline to allow adding more experimental data types. (#11778)processorhelper: Deprecate processorhelperprofiles module in favor of xprocessorhelper to allow adding more experimental data types. (#11778)processor: Deprecate processorprofiles module in favor of xprocessor to allow adding more experimental data types. (#11778)receiver: Deprecate receiverprofiles module in favor of xreceiver to allow adding more experimental data types. (#11778)receiver/scrapererror: Remove the receiver/scrapererror alias. (#11003)
💡 Enhancements 💡
receiver/scraperhelper: Add scraper for logs (#11238)
v1.21.0/v0.115.0
🛑 Breaking changes 🛑
extension/auth/authtest:authtestis now its own module (#11465, #11705)pdata/pprofile: AttributeTable is now a slice rather than a map (#11706)scraperhelper: Remove deprecated scraperhelper funcs Scraper.ID, NewScraper, AddScraper. (#11710)mdatagen: Remove deprecated LeveledMeter from the generated code (#11696)
🚩 Deprecations 🚩
component: MarkTelemetrySettings.LeveledMeterProvideras deprecated (#11697)receiver/scraper: Move receiver/scrapererror package to scraper/scrapererror and deprecate original receiver/scrapererror package. (#11003)scraperhelper: Make Scraper compatible with the new scraper.Metrics (#11682) Deprecate scraperhelper.Scraper in favor of scraper.Metrics
v1.20.0/v0.114.0
🛑 Breaking changes 🛑
extensiontest: Make extensiontest into its own module (#11463)component: Make componenttest into its own module (#11464)expandconverter: Remove deprecated expandvar converter (#11672)exporter: Remove deprecated funcs Create[]Exporter and []ExporterStability (#11662)exporterhelper: Remove deprecated NewLogs[Request]Exporter funcs (#11661)extension: Remove deprecated funcs CreateExtension and ExtensionStability (#11663)processortest: Remove deprecated func NewUnhealthyProcessorCreateSettings (#11665)
🚩 Deprecations 🚩
component: DeprecateTelemetrySettings.LeveledMeterProviderand undo deprecation ofTelemetrySettings.MeterProvider(#11061)scraperhelper: Deprecate Scraper.ID func, pass type when register Scraper (#11238)
v1.19.0/v0.113.0
🛑 Breaking changes 🛑
builder: Remove deprecated flags from Builder (#11576) Here is the list of flags | --name, --description, --version, --otelcol-version, --go, --module
🚀 New components 🚀
processorhelperprofiles: Add processorhelperprofiles to support profiles signal (#11556)
💡 Enhancements 💡
mdatagen: Add newTelemetrySettings to be generated all the time even for pkg class (#11535)debugexporter: Add profiles support to debug exporter (#11155)component: Add UnmarshalText for StabilityLevel (#11520)
v1.18.0/v0.112.0
🛑 Breaking changes 🛑
service: Change Host to not implement GetExportersWithSignal (#11444) Use Host.GetExporters if still needed.componentstatus: Remove deprecatedNewInstanceIDWithPipelineIDs,AllPipelineIDsWithPipelineIDs, andWithPipelineIDs. UseNewInstanceID,AllPipelineIDsandWithPipelinesinstead. (#11363)configgrpc: Removed deprecatedClientConfig.ToClientConnWithOptions/ServerConfig.ToServerWithOptions. (#11359, #9480) These methods were renamed toClientConfig.ToClientConn/ServerConfig.ToServerin v0.111.0.connector: Put connectortest in its own module (#11216)exporter: Disables setting batch option to batch sender directly. (#10368) Removed WithRequestBatchFuncs(BatcherOption) in favor of WithBatchFuncs(Option), where | BatcherOption is a function that operates on batch sender and Option is one that operates | on BaseExporterexporter: Made mergeFunc and mergeSplitFunc required method of exporter.Request (#10368) mergeFunc and mergeSplitFunc used to be part of the configuration pass to the exporter. Now it is changed | to be a method function of request.componentprofiles: Move componentprofiles to pipelineprofiles (#11421)processor: Put processortest in its own module (#11218)receivertest: Removed deprecatedNewNopFactoryForTypeWithSignal. UseNewNopFactoryForTypeinstead. (#11362)processor: Remove deprecated funcs from processor package (#11368)receiver: Remove deprecated funcs from receiver package (#11367)processorhelper: Remove deprecated funcs/types from processorhelper & componenttest (#11302)service: Remove deprecatedpipelines.ConfigWithPipelineIDandConfig.PipelinesWithPipelineID. Usepipelines.ConfigandConfig.Pipelinesinstead. (#11361)
🚩 Deprecations 🚩
-
extension: Deprecate funcs that repeat extension in name (#11413) Factory.CreateExtension -> Factory.Create | Factory.ExtensionStability -> Factory.Stability -
exporter: Deprecate funcs that repeate exporter in name (#11370) Factory.Create[Traces|Metrics|Logs|Profiles]Exporter -> Factory.Create[Traces|Metrics|Logs|Profiles] | Factory.[Traces|Metrics|Logs|Profiles]ExporterStability -> Factory.[Traces|Metrics|Logs|Profiles]Stability
🚀 New components 🚀
consumererrorprofiles: Add new module consumereerrorprofiles for consumer error profiles. (#11131)
💡 Enhancements 💡
configcompression: Add support for lz4 compression (#9128)otlpexporter: Add profiles support to OTLP exporter (#11435)otlphttpexporter: Add profiles support to OTLP HTTP exporter (#11450)
v1.17.0/v0.111.0
🛑 Breaking changes 🛑
-
service/telemetry: Change default metrics address to "localhost:8888" instead of ":8888" (#11251) This behavior can be disabled by disabling the feature gate 'telemetry.UseLocalHostAsDefaultMetricsAddress'. -
componentprofiles: Removed deprecatedDataTypeProfiles. UseSignalProfilesinstead. (#11312) -
configgrpc: Replace ToClientConn and ToServer with ToClientConnWithOptions and ToServerWithOptions. (#11271, #9480)ClientConfig.ToClientConnandServerConfig.ToServerwere deprecated in v0.110.0 in favor ofClientConfig.ToClientConnWithOptionsandServerConfig.ToServerWithOptionswhich use a more flexible option type. The original functions are now removed, and the new ones are renamed to the old names. TheWithOptionsnames are kept as deprecated aliases for now. -
exporterhelper: Removed deprecatedQueueTimeout/TimeoutSettingsaliases in favor ofQueueConfig/TimeoutConfig. (#11264, #6767)NewDefaultQueueSettingsandNewDefaultTimeoutSettingshave been similarly renamed. -
exporterqueue: Remove deprecatedSettings.DataType. UseSettings.Signalinstead. (#11305) -
exportertest: Remove deprecatedCheckConsumeContractParams.DataType. UseCheckConsumeContractParams.Signalinstead. (#11305) -
component: Removed deprecatedErrDataTypeIsNotSupported,DataType,DataTypeTraces,DataTypeMetrics, andDataTypeLogs. Usepipeline.ErrSignalNotSupported,pipeline.Signal,pipeline.SignalTraces,pipeline.SignalMetrics, andpipeline.SignalLogsinstead. (#11253) -
pdata/pprofile: Replace slices of values to slices of pointers for theMapping,Location,Line,Function,AttributeUnit,Link,Value,SampleandLabelsattributes. (#11339) -
receivertest: Remove deprecatedCheckConsumeContractParams.DataType. UseCheckConsumeContractParams.Signalinstead. (#11304) -
scraperhelper: Remove deprecated functionNewScraperWithComponentType. (#11294) -
processorhelper: Remove deprecated funcs form processorhelper.ObsReport (#11289) The "otelcol_processor_dropped_log_records", "otelcol_processor_dropped_log_records" | and "otelcol_processor_dropped_spans" metrics are complete removed, before they were always record with 0 values.
🚩 Deprecations 🚩
-
componentstatus: DeprecatedNewInstanceIDWithPipelineIDs,AllPipelineIDsWithPipelineIDs, andWithPipelineIDs. UseNewInstanceID,AllPipelineIDs, andWithPipelinesinstead. (#11313) -
processorhelper: Deprecate unused and empty struct processorhelper.ObsReport (#11293) -
processor: Deprecate funcs that repeat "processor" in name (#11310) Factory.Create[Traces|Metrics|Logs|Profiles]Processor -> Factory.Create[Traces|Metrics|Logs|Profiles] Factory.[Traces|Metrics|Logs|Profiles]ProcessorStability -> Factory.[Traces|Metrics|Logs|Profiles]Stability -
receiver: Deprecate funcs that repeat "receiver" in name (#11287) Factory.Create[Traces|Metrics|Logs|Profiles]Receiver -> Factory.Create[Traces|Metrics|Logs|Profiles] Factory.[Traces|Metrics|Logs|Profiles]ReceiverStability -> Factory.[Traces|Metrics|Logs|Profiles]Stability -
receivertest: DeprecatedNewNopFactoryForTypeWithSignal. UseNewNopFactoryForTypeinstead. (#11304) -
service: DeprecatesConfig.PipelinesWithPipelineID,pipelines.ConfigWithPipelineIDandGetExportersWithSignalinterface implementation. UseConfig.Pipelines,pipelines.Config, andGetExportersinterface implementation instead. (#11303)
v1.16.0/v0.110.0
🛑 Breaking changes 🛑
otlpexporter: TheTimeoutSettingsfield inotlpexporter.Configwas renamed toTimeoutConfig. (#11132)connector: ChangeTracesRouterAndConsumer,NewTracesRouter,MetricsRouterAndConsumer,NewMetricsRouter,LogsRouterAndConsumer, andNewLogsRouterto usepipeline.IDinstead ofcomponent.ID. (#11204)extension: Remove deprecated extension interfaces. (#11043) They are now available in theextensioncapabilitiesmodule.
🚩 Deprecations 🚩
-
exporterhelper: Deprecate TimeoutSettings/QueueSettings in favor of TimeoutConfig/QueueConfig. (#6767) -
configgrpc: DeprecateClientConfig.ToClientConn/ServerConfig.ToServerin favor ofToClientConnWithOptions/ToServerWithOptions(#9480) Users providing a grpc.DialOption/grpc.ServerOption should now wrap them into a generic option withWithGrpcDialOption/WithGrpcServerOption. -
componentprofiles: DeprecatesDataTypeProfiles. UseSignalProfilesinstead. (#11204) -
componentstatus: DeprecatesNewInstanceID,AllPipelineIDs, andWithPipelines. UseNewInstanceIDWithPipelineIDs,AllPipelineIDsWithPipelineIDs, andWithPipelineIDsinstead. (#11204) -
exporterqueue: DeprecatesSettings.DataType. UseSettings.Signalinstead. (#11204) -
service: Deprecatespipelines.Config. Usepipelines.ConfigWithPipelineIDinstead. (#11204) -
component: DeprecatesDataType,DataTypeTraces,DataTypeMetrics, andDataTypeLogs. Usepipeline.Signal,SignalTraces,SignalMetrics, andSignalLogsinstead. (#11204) -
service: Deprecates service's implementation ofGetExportersinterface. UseGetExportersWithSignalinstead. (#11249) -
scraperhelper: Deprecate NewScraperWithComponentType, should use NewScraper (#11159)
🚀 New components 🚀
pipeline: Adds newpipelinemodule to house the concept of pipeline ID and Signal. (#11209)
💡 Enhancements 💡
pdata: Add support to MoveTo for Map, allow avoiding copies (#11175)options: Avoid using private types in public APIs and also protect options to be implemented outside this module. (#11054)mdatagen: Avoid using private types in public APIs and also protect options to be implemented outside this module. (#11040)consumertest: Introduce SampleCount method in ProfilesSink struct. (#11225)otlpreceiver: Support profiles in the OTLP receiver (#11071)
v1.15.0/v0.109.0
🛑 Breaking changes 🛑
RemoveextensiontestStatusWatcher helpers: They were unused. They may be added back on a different module or aftercomponentstatusis marked 1.0 (#11044)pprofile: Change Profile ID field from a byte array to a custom data type (#11048)connector: Remove deprecated connector builder (#11019)exporter: Remove deprecated exporter builder (#11019)extension: Remove deprecated extension builder (#11019)processor: Remove deprecated processor builder (#11019)receiver: Remove deprecated receiver builder (#11019)
🚩 Deprecations 🚩
configtelemetry: DeprecatingTelemetrySettings.MeterProviderin favour ofTelemetrySettings.LeveledMeterProvider(#10912)extension: Deprecateextension.ConfigWatcher,extension.PipelineWatcherandextension.Dependentin favor of equivalents in theextensioncapabilitiesmodule. (#11000)scraperhelper: deprecate NewScraper, should use NewScraperWithComponentType (#11082)
🚀 New components 🚀
extensioncapabilities: Create a new module for optional extension capabilities. (#11000)
💡 Enhancements 💡
connectorprofiles: Add ProfilesRouterAndConsumer interface, and NewProfilesRouter method. (#11023)pprofileotlp: Introduce grpc service implementation of pprofileotlp (#11048)pprofile: Introduce marshalling and unmarshalling of pprofile data (#11048)service: Support profiles in the service package (#11024)
v1.14.1/v0.108.1
v1.14.0/v0.108.0
🛑 Breaking changes 🛑
extensions: RemoveStatusWatcherinterface. Usecomponentstatus.Watcherinstead. (#10777)component: Removed Status related types and functions. Usecomponentstatusinstead. (#10777)component: RemoveReportStatusfromTelemetrySettings. Usecomponentstatus.ReportStatusinstead. (#10777)componentstatus: Make componentstatus.InstanceID immutable. (#10494)
🚩 Deprecations 🚩
scraperhelper: deprecate NewObsReport, ObsReport, ObsReportSettings, scrapers should use NewScraperControllerReceiver (#10959)mdatagen: Deprecating generatedMeterfunc in favour ofLeveledMeter(#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
🛑 Breaking changes 🛑
otelcol: Delete deprecated NewCommandMustSetProvider (#10778)component: Removes the deprecatedHost.GetFactorymethod. (#10771)otelcoltest: Theotelcol.LoadConfigmethod no longer sets theexpandconverter. (#10510)ocb: Collectors built with OCB will no longer include theexpandconverter(#10510)exporterhelper: Delete deprecatedexporterhelper.ObsReportandexporterhelper.NewObsReport(#10779, #10592)
🚩 Deprecations 🚩
expandconverter: Deprecateexpandconverter. (#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: AddNewDefaultCORSConfigfunction to initialize the defaultconfighttp.CORSConfig(#9655)
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, theauthattribute was moved fromconfigauth.Authenticationto a newAuthConfig, which contains aconfigauth.Authentication. For end-users, this is a non-breaking change. For users of the API, create a new AuthConfig using theconfigauth.Authenticationinstance 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: AddsOptionstoextensions.New. (#10728) This is only a breaking change if you are depending onextensions.New's signature. Calls toextensions.Neware 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 onIncludeMetadatain confighttp and configgrpc (#9381)confighttp: Addconfighttp.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 withwere expanded. The collector now converts$${ENV_VAR}to${ENV_VAR}and$$ENV_VARto$ENV_VARwithout further expansion.
v1.12.0/v0.105.0
🛑 Breaking changes 🛑
otelcol: Obtain the Collector's effective config from otelcol.Config (#10139)otelcol.Collectorwill now marshalconfmap.Confobjects fromotelcol.Configitself.otelcoltest: Remove deprecated methodsLoadConfigWithSettingsandLoadConfigAndValidateWithSettings(#10512)
🚩 Deprecations 🚩
configauth: DeprecatedAuthentication.GetClientAuthenticatorContextandAuthentication.GetServerAuthenticatorContext(#10578)otelcol: Deprecateotelcol.ConfmapProvider(#10139)otelcol.Collectorwill now marshalconfmap.Confobjects fromotelcol.Configitself.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)
v1.11.0/v0.104.0
🛑 Breaking changes 🛑
otelcol: Theotelcol.NewCommandnow requires at least one provider be set. (#10436)component/componenttest: Added additional "inserted" count toTestTelemetry.CheckProcessor*methods. (#10353)
🚩 Deprecations 🚩
otelcoltest: DeprecatesLoadConfigWithSettingsandLoadConfigAndValidateWithSettings. UseLoadConfigandLoadConfigAndValidateinstead. (#10417)otelcol: Theotelcol.NewCommandMustSetProvideris deprecated. Useotelcol.NewCommandinstead. (#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)
v1.10.0/v0.103.0
🛑 Breaking changes 🛑
component: Remove deprecatedcomponent.UnmarshalConfig(#7102)confighttp: Useconfighttp.ServerConfigas part of zpagesextension.Config. Previously the extension usedconfignet.TCPAddrConfig(#9368)
🚩 Deprecations 🚩
-
connector: Deprecate CreateSettings and NewNopCreateSettings (#9428) The following methods are being renamed:- connector.CreateSettings -> connector.Settings
- connector.NewNopCreateSettings -> connector.NewNopSettings
-
exporter: Deprecate CreateSettings and NewNopCreateSettings (#9428) The following methods are being renamed:- exporter.CreateSettings -> exporter.Settings
- exporter.NewNopCreateSettings -> exporter.NewNopSettings
-
extension: Deprecate CreateSettings and NewNopCreateSettings (#9428) The following methods are being renamed:- extension.CreateSettings -> extension.Settings
- extension.NewNopCreateSettings -> extension.NewNopSettings
-
processor: Deprecate CreateSettings and NewNopCreateSettings (#9428) The following methods are being renamed:- processor.CreateSettings -> processor.Settings
- processor.NewNopCreateSettings -> processor.NewNopSettings
-
receiver: Deprecate CreateSettings and NewNopCreateSettings (#9428) The following methods are being renamed:- receiver.CreateSettings -> receiver.Settings
- receiver.NewNopCreateSettings -> receiver.NewNopSettings
-
configauth: DeprecateGetClientAuthenticatorandGetServerAuthenticator, useGetClientAuthenticatorContextandGetServerAuthenticatorContextinstead. (#9808) -
confighttp: DeprecateClientConfig.CustomRoundTripper(#8627) Set theTransportfield on the*http.Clientobject returned from(ClientConfig).ToClientinstead. -
filter: Deprecate thefilter.CombinedFilterstruct (#10348) -
otelcol: Deprecateotelcol.NewCommand. Useotelcol.NewCommandMustProviderSettingsinstead. (#10359) -
otelcoltest: DeprecateLoadConfigandLoadConfigAndValidate. UseLoadConfigWithSettingsandLoadConfigAndValidateWithSettingsinstead (#10359)
💡 Enhancements 💡
confmap: Addsconfmap.Retrieved.AsStringmethod that returns the configuration value as a string (#9532)confmap: Addsconfmap.NewRetrievedFromYAMLhelper to createconfmap.Retrievedvalues from YAML bytes (#9532)
v0.102.1
No API-only changes on this release. This release addresses GHSA-c74f-6mfw-mm4v for configgrpc.
v1.9.0/v0.102.0
This release addresses GHSA-c74f-6mfw-mm4v for confighttp.
🛑 Breaking changes 🛑
otelcol: Remove deprecatedConfigProviderfield fromCollectorSettings(#10281)exporterhelper: remove deprecated RequestMarshaler & RequestUnmarshaler types (#10283)service: remove deprecated Telemetry struct and New func (#10285)configtls: remove deprecated LoadTLSConfigContext funcs (#10283)
🚩 Deprecations 🚩
component: Deprecatecomponent.UnmarshalConfig, use(*confmap.Conf).Unmarshal(&intoCfg)instead. (#7102)service/telemetry: Deprecate telemetry.New in favor of telemetry.NewFactory (#4970)
💡 Enhancements 💡
confmap: Allow setting a default Provider on a Resolver to use when${}syntax is used without a scheme (#10182)pdata: Introduce string and int64 slices to pcommon (#10148)pdata: Introduce generated experimental pdata for profiling signal. (#10195)confmap: Remove top level condition when considering struct as Unmarshalers (#7101)
🧰 Bug fixes 🧰
otelcol: Update validate command to use the new configuration options (#10203)
v1.8.0/v0.101.0
🛑 Breaking changes 🛑
confighttp: Removes deprecated functionsToClientContext,ToListenerContext, andToServerContext. (#10138)confmap: DeprecateNewWithSettingsfor all Providers andNewfor all Converters (#10134) UseNewFactoryinstead for all affected modules.confmap: Remove deprecatedProvidersandConvertersfromconfmap.ResolverSettings(#10173) UseProviderSettingsandConverterSettingsinstead.
🧰 Bug fixes 🧰
otelcol: Add explicit mapstructure tags to main configuration struct (#10152)confmap: Support string-like types as map keys when marshaling (#10137)
v1.7.0/v0.100.0
💡 Enhancements 💡
configgrpc: AddsNewDefault*functions for all the config structs. (#9654)exporterqueue: Expose ErrQueueIsFull so upstream components can retry or apply backpressure. (#10070)
🧰 Bug fixes 🧰
mdatagen: Call connectors with routers to be the same as the service graph (#10079)
v1.6.0/v0.99.0
🛑 Breaking changes 🛑
component: Removed deprecated functionGetExportersfromcomponent.Hostinterface (#9987)
🚩 Deprecations 🚩
confighttp: deprecate ToClientContext, ToServerContext, ToListenerContext, replaced by ToClient, ToServer, ToListener (#9807)configtls: DeprecatesClientConfig.LoadTLSConfigContextandServerConfig.LoadTLSConfigContext, useClientConfig.LoadTLSConfigandServerConfig.LoadTLSConfiginstead. (#9945)confmap: Deprecate theProvidersandConvertersfields inconfmap.ResolverSettings(#9516) Use theProviderFactoriesandConverterFactoriesfields instead.
💡 Enhancements 💡
configauth: AddsNewDefault*functions for all the config structs. (#9821)configtls: AddsNewDefault*functions for all the config structs. (#9658)pmetric: Support metric.metadata in pdata/pmetric (#10006)
v1.5.0/v0.98.0
🛑 Breaking changes 🛑
component: Restricts maximum length forcomponent.Typeto 63 characters. (#9872)configgrpc: Remove deprecatedToServerContext, useToServerinstead. (#9836)configgrpc: Remove deprecatedSanitizedEndpoint. (#9836)configtls: Remove DeprecatedTLSSetting,TLSClientSetting, andTLSServerSetting. (#9786)configtls: RenameTLSSettingtoConfigonClientConfigandServerConfig. (#9786)
🚩 Deprecations 🚩
confighttp: DeprecateToClient,ToListenerandToServeruseToClientContext,ToListenerContextandToServerContextinstead. (#9807)configtls: DeprecateClientConfig.LoadTLSConfigandServerConfig.LoadTLSConfig, useClientConfig.LoadTLSConfigContextandServerConfig.LoadTLSConfigContextinstead. (#9811)
💡 Enhancements 💡
-
Introduce new module for generating pdata: pdata/testdata (#9886)
-
exporterhelper: Make theWithBatcheroption available for regular exporter helpers based on OTLP data type. (#8122) Now,WithBatchercan be used with both regular exporter helper (e.g. NewTracesExporter) and the request-based exporter helper (e.g. NewTracesRequestExporter). The request-based exporter helpers requireWithRequestBatchFuncsoption providing batching functions. -
confmap: Creates a logger in the confmap.ProviderSettings and uses it to log when there is a missing or blank environment variable referenced in config. For now the noop logger is used everywhere except tests. (#5615)
v1.4.0/v0.97.0
🛑 Breaking changes 🛑
configgrpc: Remove deprecatedToServerfunction. (#9787)confignet: ChangeTransportfield fromstringtoTransportType(#9385)component: Change underlying type ofcomponent.Typeto an opaque struct. (#9208)obsreport: Remove deprecated obsreport/obsreporttest package. (#9724)component: Remove deprecated errorErrNilNextConsumer(#9322)connector: RemoveLogsRouter,MetricsRouterandTracesRouter. UseLogsRouterAndConsumer,MetricsRouterAndConsumer,TracesRouterAndConsumerrespectively instead. (#9095)receiver: Remove deprecated structScraperControllerSettingsand functionNewDefaultScraperControllerSettings(#6767)confmap: Remove deprecatedprovider.Newmethods, useNewWithSettingsmoving forward. (#9443)
🚩 Deprecations 🚩
configgrpc: DeprecatedToServerContext, useToServerinstead. (#9787)configgrpc: DeprecateSanitizedEndpoint(#9788)
💡 Enhancements 💡
exporterhelper: Add experimental batching capabilities to the exporter helper (#8122)confignet: AddsNewDefault*functions for all the config structs. (#9656)configtls: Validates TLS min_version and max_version (#9475) IntroducesValidate()method in TLSSetting.exporterhelper: Invalid exporterhelper options now make the exporter creation error out instead of panicking. (#9717)components: Give NoOp components a unique name (#9637)
v1.3.0/v0.96.0
🚩 Deprecations 🚩
configgrpc: DeprecatesToServer. UseToServerContextinstead. (#9624)component: deprecate component.ErrNilNextConsumer (#9526)configtls: Rename TLSClientSetting, TLSServerSetting, and TLSSetting based on the naming convention used in other config packages. (#9474)
💡 Enhancements 💡
receivertest: add support for metrics in contract checker (#9551)
v1.2.0/v0.95.0
🛑 Breaking changes 🛑
all: Bump minimum go version to go 1.21 (#9507)service/telemetry: Delete generated_config types, use go.opentelemetry.io/contrib/config types instead (#9546)configcompression: Remove deprecatedconfigcompressiontypes, constants and methods. (#9388)component: Removehost.ReportFatalError(#6344)configgrpc: Remove deprecatedconfiggrpc.ServerConfig.ToListener(#9481)confmap: Remove deprecatedconfmap.WithErrorUnused(#9484)
🚩 Deprecations 🚩
confignet: Deprecateconfignet.NetAddrandconfignet.TCPAddrin favor ofconfignet.AddrConfigandconfignet.TCPAddrConfig. (#9509)config/configgrpc: Deprecateconfiggrpc.ClientConfig.SanitizedEndpoint,configgrpc.ServerConfig.ToListenerandconfiggrpc.ServerConfig.ToListenerContext(#9481, #9482)scraperhelper: Deprecate ScraperControllerSettings, use ControllerConfig instead (#6767)
v1.1.0/v0.94.0
🛑 Breaking changes 🛑
-
confignet: Remove deprecatedDialContextandListenContextfunctions (#9363) -
confmap/converter/expandconverter: Addconfmap.ConverterSettingsargument to experimentalexpandconverter.Newfunction. (#5615, #9162)- The
confmap.ConverterSettingsstruct currently has no fields. It will be used to pass a logger.
- The
-
component: Remove deprecated funcs and types (#9283) -
otlpexporter: Config struct is moving from embedding the deprecated GRPCClientSettings struct to using ClientConfig instead. (#6767) -
otlphttpexporter: otlphttpexporter.Config embeds the struct confighttp.ClientConfig instead of confighttp.HTTPClientSettings (#6767) -
otlpreceiver: HTTPConfig struct is moving from embedding the deprecated ServerSettings struct to using HTTPServerConfig instead. (#6767) -
component: Validate component.Type at creation and unmarshaling time. (#9208)- A component.Type must start with an ASCII alphabetic character and can only contain ASCII alphanumeric characters and '_'.
🚩 Deprecations 🚩
configcompressions: DeprecateIsCompressed. UseCompressionType.IsCompressed insteadinstead. (#9435)configcompression: DeprecateCompressionType, useTypeinstead. (#9416)confighttp: Deprecate CORSSettings, use CORSConfig instead (#6767)configgrpc: DeprecateToListenerfunction in favor ofToListenerContext(#9389)configgrpc: Deprecate GRPCServerSettings, use ServerConfig instead (#6767)confighttp: Deprecate HTTPClientSettings, use ClientConfig instead (#6767)confighttp: Deprecate HTTPServerSettings, use ServerConfig instead (#6767)confmap/provider: Deprecate .New in favor of .NewWithSettings for all core providers (#5615, #9162)- NewWithSettings now takes an empty confmap.ProviderSettings struct. This will be used to pass a logger in the future.
💡 Enhancements 💡
-
exporter/exporterhelper: Add API for enabling queue in the new exporter helpers. (#7874) The following experimental API is introduced in exporter package:exporterhelper.WithRequestQueue: a new exporter helper option for using a queue.exporterqueue.Queue: an interface for queue implementations.exporterqueue.Factory: a queue factory interface, implementations of this interface are intended to be used with WithRequestQueue option.exporterqueue.Settings: queue factory settings.exporterqueue.Config: common configuration for queue implementations.exporterqueue.NewDefaultConfig: a function for creating a default queue configuration.exporterqueue.NewMemoryQueueFactory: a new factory for creating a memory queue.- `exporterqueue.NewPersistentQueueFactory: a factory for creating a persistent queue.
-
featuregate: Add thefeaturegate.ErrAlreadyRegisterederror, which is returned byfeaturegate.Registry'sRegisterwhen adding a feature gate that is already registered. (#8622) Useerrors.Isto check for this error.
v0.93.0
🛑 Breaking changes 🛑
-
bug_fix: Implementencoding.BinaryMarshalerinterface to preventconfigopaque->[]byte->stringconversions from leaking the value (#9279) -
configopaque: configopaque.String implementsfmt.Stringerandfmt.GoStringer, outputting [REDACTED] when formatted with the %s, %q or %#v verbs(#9213) This may break applications that rely on the previous behavior of opaque strings withfmt.Sprintfto e.g. build URLs or headers. Explicitly cast the opaque string to a string before using it infmt.Sprintf` to restore the previous behavior. -
all: Remove obsolete "// +build" directives (#9304) -
connectortest: Remove deprecated connectortest router helpers. (#9278)
🚩 Deprecations 🚩
-
obsreporttest: deprecate test funcs/structs (#8492) The following methods/structs have been moved from obsreporttest to componenttest:- obsreporttest.TestTelemetry -> componenttest.TestTelemetry
- obsreporttest.SetupTelemetry -> componenttest.SetupTelemetry
- obsreporttest.CheckScraperMetrics -> TestTelemetry.CheckScraperMetrics
- obserporttest.TestTelemetry.TelemetrySettings -> componenttest.TestTelemetry.TelemetrySettings()
-
confignet: DeprecatesDialContextandListenContextfunctions. UseDialandListeninstead. (#9258) Unlike the previousDialandListenfunctions, the newDialandListenfunctions take acontext.ContextlikeDialContextandListenContext.
v1.0.1/v0.92.0
🛑 Breaking changes 🛑
otlpexporter: Change Config members names to use Config suffix. (#9091)component: Remove deprecated unused TelemetrySettingsBase (#9145)
🚩 Deprecations 🚩
confignet: Deprecates theDialandListenfunctions in favor ofDialContextandListenContext. (#9163)component: Deprecate unnecessary type StatusFunc (#9146)
v0.91.0
v1.0.0/v0.90.0
🛑 Breaking changes 🛑
exporterhelper: Replace converter interface with function in the new experimental exporter helper. (#8122)featuregate: Remove deprecate functionfeaturegate.NewFlag(#8727) Usefeaturegate.Registry'sRegisterFlagsmethod instead.
🚩 Deprecations 🚩
telemetry: deprecate jsonschema generated types (#15009)
💡 Enhancements 💡
pdata: Add ZeroThreshold field to exponentialHistogramDataPoint in pmetric package. (#8802)
v1.0.0-rcv0018/v0.89.0
🛑 Breaking changes 🛑
otelcol: CollectorSettings.Factories now expects:func() (Factories, error)(#8478)exporter/exporterhelper: The experimental Request API is updated. (#7874)Requestinterface now includes ItemsCount() method.RequestItemsCounteris removed.- The following interfaces are added:
- Added an optional interface for handling errors that occur during request processing
RequestErrorHandler. - Added a function to unmarshal bytes into a Request
RequestUnmarshaler. - Added a function to marshal a Request into bytes
RequestMarshaler
- Added an optional interface for handling errors that occur during request processing
🚩 Deprecations 🚩
featuregate: Deprecatefeaturegate.NewFlagin favor offeaturegate.Registry'sRegisterFlagsmethod (#8727)
💡 Enhancements 💡
featuregate: Add validation for feature gates ID, URL and versions. (#8766) Feature gates IDs are now explicitly restricted to ASCII alphanumerics and dots.
v1.0.0-rcv0017/v0.88.0
💡 Enhancements 💡
pdata: Add IsReadOnly() method to p[metrics|logs|traces].[Metrics|Logs|Spans] pdata structs allowing to check if the struct is read-only. (#6794)
v1.0.0-rcv0016/v0.87.0
💡 Enhancements 💡
pdata: Introduce API to control pdata mutability (#6794) This change introduces new API pdata methods to control the mutability:- p[metric|trace|log].[Metrics|Traces|Logs].MarkReadOnly() - marks the pdata as read-only. Any subsequent mutations will result in a panic.
- p[metric|trace|log].[Metrics|Traces|Logs].IsReadOnly() - returns true if the pdata is marked as read-only. Currently, all the data is kept mutable. This API will be used by fanout consumer in the following releases.
🛑 Breaking changes 🛑
obsreport: remove methods/structs deprecated in previous release. (#8492)extension: remove deprecated Configs and Factories (#8631)
v1.0.0-rcv0015/v0.86.0
🛑 Breaking changes 🛑
service: remove deprecated service.PipelineConfig (#8485)
🚩 Deprecations 🚩
-
obsreporttest: deprecate To*CreateSettings funcs in obsreporttest (#8492) The following TestTelemetry methods have been deprecated. Use structs instead:- ToExporterCreateSettings -> exporter.CreateSettings
- ToProcessorCreateSettings -> processor.CreateSettings
- ToReceiverCreateSettings -> receiver.CreateSettings
-
obsreport: Deprecatingobsreport.Exporter,obsreport.ExporterSettings,obsreport.NewExporter(#8492) These deprecated methods/structs have been moved to exporterhelper:obsreport.Exporter->exporterhelper.ObsReportobsreport.ExporterSettings->exporterhelper.ObsReportSettingsobsreport.NewExporter->exporterhelper.NewObsReport
-
obsreport: Deprecatingobsreport.BuildProcessorCustomMetricName,obsreport.Processor,obsreport.ProcessorSettings,obsreport.NewProcessor(#8492) These deprecated methods/structs have been moved to processorhelper:obsreport.BuildProcessorCustomMetricName->processorhelper.BuildCustomMetricNameobsreport.Processor->processorhelper.ObsReportobsreport.ProcessorSettings->processorhelper.ObsReportSettingsobsreport.NewProcessor->processorhelper.NewObsReport
-
obsreport: Deprecating obsreport scraper and receiver API (#8492) These deprecated methods/structs have been moved to receiverhelper and scraperhelper:obsreport.Receiver->receiverhelper.ObsReportobsreport.ReceiverSettings->receiverhelper.ObsReportSettingsobsreport.NewReceiver->receiverhelper.NewObsReportobsreport.Scraper->scraperhelper.ObsReportobsreport.ScraperSettings->scraperhelper.ObsReportSettingsobsreport.NewScraper->scraperhelper.NewObsReport
💡 Enhancements 💡
otelcol: Splitting otelcol into its own module. (#7924)service: Split service into its own module (#7923)
v0.85.0
v0.84.0
💡 Enhancements 💡
-
exporter/exporterhelper: Introduce a new exporter helper that operates over client-provided requests instead of pdata (#7874) The following experimental API is introduced in exporter/exporterhelper package:NewLogsRequestExporter: a new exporter helper for logs.NewMetricsRequestExporter: a new exporter helper for metrics.NewTracesRequestExporter: a new exporter helper for traces.Request: an interface for client-defined requests.RequestItemsCounter: an optional interface for counting the number of items in a Request.LogsConverter: an interface for converting plog.Logs to Request.MetricsConverter: an interface for converting pmetric.Metrics to Request.TracesConverter: an interface for converting ptrace.Traces to Request. All the new APIs are intended to be used by exporters that need to operate over client-provided requests instead of pdata.
-
otlpreceiver: Export HTTPConfig as part of the API for creating the otlpreceiver configuration. (#8175) Changes signature of receiver/otlpreceiver/config.go type httpServerSettings to HTTPConfig.
v0.83.0
🛑 Breaking changes 🛑
all: Remove go 1.19 support, bump minimum to go 1.20 and add testing for 1.21 (#8207)
💡 Enhancements 💡
changelog: Generate separate changelogs for end users and package consumers (#8153)