The following commands were run to prepare this release: - make chlog-update VERSION=v1.59.0/v0.153.0 - make prepare-release PREVIOUS_VERSION=1[.]58[.]0 RELEASE_CANDIDATE=1.59.0 MODSET=stable - make prepare-release PREVIOUS_VERSION=0[.]152[.]0 RELEASE_CANDIDATE=0.153.0 MODSET=beta --------- Co-authored-by: otelbot <[email protected]> Co-authored-by: Andrew Wilkins <[email protected]>
256 KiB
Changelog
Starting with version v0.83.0, this changelog includes only user-facing changes. If you are looking for developer-facing changes, check out CHANGELOG-API.md.
v1.52.0/v0.146.1
v0.146.0
🛑 Breaking changes 🛑
all: Increase minimum Go version to 1.25 (#14567)
🚩 Deprecations 🚩
pdata/pprofile: Declare removed aggregation elements as deprecated. (#14528)
💡 Enhancements 💡
-
all: Add detailed failure attributes to exporter send_failed metrics at detailed telemetry level. (#13956) Theotelcol_exporter_send_failed_{spans,metric_points,log_records}metrics now include failure attributes when telemetry level is Detailed:error.type(OpenTelemetry semantic convention describing the error class) anderror.permanent(indicates if error is permanent/non-retryable). Theerror.typeattribute captures gRPC status codes (e.g., "Unavailable", "ResourceExhausted"), standard Go context errors (e.g., "canceled", "deadline_exceeded"), and collector-specific errors (e.g., "shutdown"). This enables better alerting and debugging by providing standardized error classification. -
cmd/builder: Introduce new experimentalinitsubcommand (#14530) The newinitsubcommand initializes a new custom collector -
cmd/builder: Add "telemetry" field to allow configuring telemetry providers (#14575) Most users should not need to use this, this field should only be set if you intend to provide your own OpenTelemetry SDK. -
cmd/mdatagen: Introduce additional metadata (the version since the deprecation started, and the deprecation reason) for deprecated metrics. (#14113) -
cmd/mdatagen: Add optionalrelationshipsfield to entity schema in metadata.yaml (#14284) -
exporter/debug: Addoutput_pathsconfiguration option to control output destination whenuse_internal_loggeris false. (#10472) Whenuse_internal_loggeris set tofalse, the debug exporter now supports configuring the output destination via theoutput_pathsoption. This allows users to send debug exporter output tostdout,stderr, or a file path. The default value is["stdout"]to maintain backward compatibility. -
pkg/confmap: Add experimentalToStringMapRawfunction to decodeconfmap.Confinto a string map without losing internal types (#14480) This method exposes the internal structure of aconfmap.Confwhich may change at any time without prior notice
🧰 Bug fixes 🧰
cmd/mdatagen: Reset aggDataPoints during metric init to avoid index out of range panic across emit cycles when reaggregation is enabled. (#14569)cmd/mdatagen: Fix panic when mdatagen is run without arguments. (#14506)pdata/pprofile: Fix off-by-one issue in dictionary lookups. (#14534)pkg/config/confighttp: Fix high cardinality span name from request method from confighttp server internal telemetry (#14516) Follow spec to bound request method cardinality.pkg/otelcol: Ignore component aliases in theotelcol componentscommand (#14492)pkg/otelcol: Order providers and converters in alphabetical order in thecomponentssubcommand. (#14476)
v1.51.0/v0.145.0
💡 Enhancements 💡
pkg/scraperhelper: ScraperID has been added to the logs for metrics, logs, and profiles (#14461)
🧰 Bug fixes 🧰
-
exporter/otlp_grpc: Fix the OTLP exporter balancer to use round_robin by default, as intended. (#14090) -
pkg/config/configoptional: FixUnmarshalmethods not being called when config is wrapped insideOptional(#14500) This bug notably manifested in the fact that thesending_queue::batch::sizerconfig for exporters stopped defaulting tosending_queue::sizer, which sometimes caused the wrong units to be used when configuringsending_queue::batch::min_sizeandmax_size.As part of the fix,
xconfmapexposes a newxconfmap.WithForceUnmarshaleroption, to be used in theUnmarshalmethods of wrapper types likeconfigoptional.Optionalto make sure theUnmarshalmethod of the inner type is called.The default behavior remains that calling
conf.Unmarshalon theconfmap.Confpassed as argument to anUnmarshalmethod will skip any top-levelUnmarshalmethods to avoid infinite recursion in standard use cases. -
pkg/confmap: Fix an issue where configs could fail to decode when using interpolated values in string fields. (#14413) For example, a header can be set via an environment variable to a string that is parseable as a number, e.g.1234 -
pkg/service: Don't error on startup when process metrics are enabled on unsupported OSes (e.g. AIX) (#14307)
v1.50.0/v0.144.0
🛑 Breaking changes 🛑
pkg/exporterhelper: Change verbosity level for otelcol_exporter_queue_batch_send_size metric to detailed. (#14278)pkg/service: Remove deprecatedtelemetry.disableHighCardinalityMetricsfeature gate. (#14373)pkg/service: Remove deprecatedservice.noopTracerProviderfeature gate. (#14374)
🚩 Deprecations 🚩
exporter/otlp_grpc: Renameotlpexporter tootlp_grpcexporter and add deprecated aliasotlp. (#14403)exporter/otlp_http: Renameotlphttpexporter tootlp_httpexporter and add deprecated aliasotlphttp. (#14396)
💡 Enhancements 💡
-
cmd/builder: Avoid duplicate CLI error logging in generated collector binaries by relying on cobra's error handling. (#14317) -
cmd/mdatagen: Add the ability to disable attributes at the metric level and re-aggregate data points based off of these new dimensions (#10726) -
cmd/mdatagen: Add optionaldisplay_nameanddescriptionfields to metadata.yaml for human-readable component names (#14114) Thedisplay_namefield allows components to specify a human-readable name in metadata.yaml. When provided, this name is used as the title in generated README files. Thedescriptionfield allows components to include a brief description in generated README files. -
cmd/mdatagen: Validate stability level for entities (#14425) -
pkg/xexporterhelper: Reenable batching for profiles (#14313) -
receiver/nop: add profiles signal support (#14253)
🧰 Bug fixes 🧰
pkg/exporterhelper: Fix reference count bug in partition batcher (#14444)
v1.49.0/v0.143.0
💡 Enhancements 💡
all: Update semconv import to 1.38.0 (#14305)exporter/nop: Add profiles support to nop exporter (#14331)pkg/pdata: Optimize the size and pointer bytes for pdata structs (#14339)pkg/pdata: Avoid using interfaces/oneof like style for optional fields (#14333)
v1.48.0/v0.142.0
💡 Enhancements 💡
-
exporter/debug: Add logging of dropped attributes, events, and links counts in detailed verbosity (#14202) -
extension/memory_limiter: The memorylimiter extension can be used as an HTTP/GRPC middleware. (#14081) -
pkg/config/configgrpc: Statically validate gRPC endpoint (#10451) This validation was already done in the OTLP exporter. It will now be applied to any gRPC client. -
pkg/service: Add support to disabling adding resource attributes as zap fields in internal logging (#13869) Note that this does not affect logs exported through OTLP.
v1.47.0/v0.141.0
🛑 Breaking changes 🛑
pkg/config/confighttp: Use configoptional.Optional for confighttp.ClientConfig.Cookies field (#14021)
💡 Enhancements 💡
pkg/config/confighttp: Settingcompression_algorithmsto an empty list now disables automatic decompression, ignoring Content-Encoding (#14131)pkg/service: Update semantic conventions from internal telemetry to v1.37.0 (#14232)pkg/xscraper: Implement xscraper for Profiles. (#13915)
🧰 Bug fixes 🧰
pkg/config/configoptional: Ensure that configoptional.None values resulting from unmarshaling are equivalent to configoptional.Optional zero value. (#14218)
v1.46.0/v0.140.0
💡 Enhancements 💡
-
cmd/mdatagen:metadata.yamlnow supports an optionalentitiessection to organize resource attributes into logical entities with identity and description attributes (#14051) When entities are defined, mdatagen generatesAssociateWith{EntityType}()methods on ResourceBuilder that associate resources with entity types using the entity refs API. The entities section is backward compatible - existing metadata.yaml files without entities continue to work as before. -
cmd/mdatagen: Add semconv reference for metrics (#13920) -
connector/forward: Add support for Profiles to Profiles (#14092) -
exporter/debug: Disable sending queue by default (#14138) The recently added sending queue configuration in Debug exporter was enabled by default and had a problematic default size of 1. This change disables the sending queue by default. Users can enable and configure the sending queue if needed. -
pkg/config/configoptional: Markconfigoptional.AddEnabledFieldas beta (#14021) -
pkg/otelcol: This feature has been improved and tested; secure-by-default redacts configopaque values (#12369)
🧰 Bug fixes 🧰
all: Ensure service service.instance.id is the same for all the signals when it is autogenerated. (#14140)
v1.45.0/v0.139.0
🛑 Breaking changes 🛑
-
cmd/mdatagen: Make stability.level a required field for metrics (#14070) -
cmd/mdatagen: Replaceoptionalfield withrequirement_levelfield for attributes in metadata schema (#13913) Theoptionalboolean field for attributes has been replaced with arequirement_levelfield that accepts enum values:required,conditionally_required,recommended, oropt_in.required: attribute is always included and cannot be excludedconditionally_required: attribute is included by default when certain conditions are met (replacesoptional: true)recommended: attribute is included by default but can be disabled via configuration (replacesoptional: false)opt_in: attribute is not included unless explicitly enabled in user config Whenrequirement_levelis not specified, it defaults torecommended.
-
pdata/pprofile: Remove deprecatedPutAttributehelper method (#14082) -
pdata/pprofile: Remove deprecatedPutLocationhelper method (#14082)
💡 Enhancements 💡
all: Add FIPS and non-FIPS implementations for allowed TLS curves (#13990)cmd/builder: Set CGO_ENABLED=0 by default, add thecgo_enabledconfiguration to enable it. (#10028)pkg/config/configgrpc: Errors of type status.Status returned from an Authenticator extension are being propagated as is to the upstream client. (#14005)pkg/config/configoptional: Adds newconfigoptional.AddEnabledFieldfeature gate that allows users to explicitly disable aconfigoptional.Optionalthrough a newenabledfield. (#14021)pkg/exporterhelper: Replace usage of gogo proto for persistent queue metadata (#14079)pkg/pdata: Remove usage of gogo proto and generate the structs with pdatagen (#14078)
🧰 Bug fixes 🧰
exporter/debug: add queue configuration (#14101)
v1.44.0/v0.138.0
🛑 Breaking changes 🛑
-
all: Remove deprecated typeTracesConfig(#14036) -
pkg/exporterhelper: Add default values forsending_queue::batchconfiguration. (#13766) Settingsending_queue::batchto an empty value now results in the same setup as the default batch processor configuration. -
all: Add unified print-config command with mode support (redacted, unredacted), json support (unstable), and validation support. (#11775) This replaces theprint-initial-configcommand. See theservicepackage README for more details. The original command nameprint-initial-configremains an alias, to be retired with the feature flag.
💡 Enhancements 💡
all: Addkeep_alives_enabledoption to ServerConfig to control HTTP keep-alives for all components that create an HTTP server. (#13783)pkg/otelcol: Avoid unnecessary mutex in collector logs, replace by atomic pointer (#14008)cmd/mdatagen: Add lint/ordering validation for metadata.yaml (#13781)pdata/xpdata: Refactor JSON marshaling and unmarshaling to usepcommon.Valueinstead ofAnyValue. (#13837)pkg/exporterhelper: ExposeMergeCtxin exporterhelper's queue batch settings` (#13742)
🧰 Bug fixes 🧰
all: Fix zstd decoder data corruption due to decoder pooling for all components that create an HTTP server. (#13954)pkg/otelcol: Remove UB when taking internal logs and move them to the final zapcore.Core (#14009) This can happen because of a race on accessinglogsTaken.pkg/confmap: Fix a potential race condition in confmap by closing the providers first. (#14018)
v1.43.0/v0.137.0
💡 Enhancements 💡
-
cmd/mdatagen: Improve validation for resource attributeenabledfield in metadata files (#12722) Resource attributes now require an explicitenabledfield in metadata.yaml files, while regular attributes are prohibited from having this field. This improves validation and prevents configuration errors. -
all: Changelog entries will now have their component field checked against a list of valid components. (#13924) This will ensure a more standardized changelog format which makes it easier to parse. -
pkg/pdata: Mark featuregate pdata.useCustomProtoEncoding as stable (#13883)
v1.42.0/v0.136.0
💡 Enhancements 💡
xpdata: Add Serialization and Deserialization of AnyValue (#12826)debugexporter: add support for batching (#13791) The default queue size is 1configtls: Add early validation for TLS server configurations to fail fast when certificates are missing instead of failing at runtime. (#13130, #13245)mdatagen: Expose stability level in generated metric documentation (#13748)internal/tools: Add support for modernize in Makefile (#13796)
🧰 Bug fixes 🧰
otelcol: Fix a potential deadlock during collector shutdown. (#13740)otlpexporter: fix the validation of unix socket endpoints (#13826)
v1.41.0/v0.135.0
💡 Enhancements 💡
exporterhelper: Add newexporter_queue_batch_send_sizeandexporter_queue_batch_send_size_bytesmetrics, showing the size of telemetry batches from the exporter. (#12894)
v1.40.0/v0.134.0
💡 Enhancements 💡
pdata: Add custom grpc/encoding that replaces proto and calls into the custom marshal/unmarshal logic in pdata. (#13631) This change should not affect other gRPC calls since it fallbacks to the default grpc/proto encoding if requests are not pdata/otlp requests.pdata: Avoid copying the pcommon.Map when same origin (#13731) This is a very large improvement if using OTTL with map functions since it will avoid a map copy.exporterhelper: Respectnum_consumerswhen batching and partitioning are enabled. (#13607)
🧰 Bug fixes 🧰
pdata: Correctly parse OTLP payloads containing non-packed repeated primitive fields (#13727, #13730) This bug prevented the Collector from ingesting most Histogram, ExponentialHistogram, and Profile payloads.
v1.39.0/v0.133.0
🛑 Breaking changes 🛑
all: Increase minimum Go version to 1.24 (#13627)
💡 Enhancements 💡
-
otlphttpexporter: Addprofiles_endpointconfiguration option to allow custom endpoint for profiles data export (#13504) Theprofiles_endpointconfiguration follows the same pattern astraces_endpoint,metrics_endpoint, andlogs_endpoint. When specified, profiles data will be sent to the custom URL instead of the default{endpoint}/v1development/profiles. -
pdata: Add support for local memory pooling for data objects. (#13678) This is still an early experimental (alpha) feature. Do not recommended to be used production. To enable use "--featuregate=+pdata.useProtoPooling" -
pdata: Optimize CopyTo messages to avoid any copy when same source and destination (#13680) -
receiverhelper: New feature flag to make receiverhelper distinguish internal vs. downstream errors using newotelcol_receiver_failed_xandotelcol_receiver_requestsmetrics (#12207, #12802) This is a breaking change for the semantics of the otelcol_receiver_refused_metric_points, otelcol_receiver_refused_log_records and otelcol_receiver_refused_spans metrics. These new metrics and semantics are enabled through thereceiverhelper.newReceiverMetricsfeature gate. -
debugexporter: Add support for entity references in debug exporter output (#13324) -
pdata: Fix unnecessary allocation of a new state when adding new values to pcommon.Map (#13634) -
service: Implement refcounting for pipeline data owned memory. (#13631) This feature is protected by--featuregate=+pdata.useProtoPooling. -
service: Add a debug-level log message when a consumer returns an error. (#13357) -
xpdata: Optimize xpdata/context for persistent queue when only one value for key (#13636) -
otlpreceiver: Log the listening addresses of the receiver, rather than the configured endpoints. (#13654) -
pdata: Use the newly added proto marshaler/unmarshaler for the official proto Marshaler/Unmarshaler (#13637) If any problems observed with this consider to disable the featuregate--feature-gates=-pdata.useCustomProtoEncoding
configtls: Enable X25519MLKEM768 as per draft-ietf-tls-ecdhe-mlkem (#13670)
🧰 Bug fixes 🧰
exporterhelper: Prevent uncontrolled goroutines in batcher due to a incorrect worker pool behaviour. (#13689)service: Ensure the insecure configuration is accounted for when normalizing the endpoint. (#13691)configoptional: Allow validating nested types (#13579)configoptional.Optionalnow implementsxconfmap.Validatorbatchprocessor: Fix UB in batch processor when trying to read bytes size after adding request to pipeline (#13698) This bug only happens id detailed metrics are enabled and also an async (sending queue enabled) exporter that mutates data is configure.
v1.38.0/v0.132.0
🛑 Breaking changes 🛑
componentstatus: Change the signature of the componentstatus.NewEvent to accept multiple options. (#13210) Changes the signature of the component.NewEvent to accept multiple EventBuilderOption, like the new WithAttributes constructor.
🚩 Deprecations 🚩
-
service: move service.noopTraceProvider feature gate to deprecated stage (#13492) The functionality of the feature gate is available via configuration with the following telemetry settings:service: telemetry: traces: level: none -
mdatagen: Remove the deletion ofgenerated_component_telemetry_test.go. (#12067) This file used to be generated by mdatagen. Starting with 0.122.0, the code deletes that file. It is no longer necessary to delete the file, as code has had time to upgrade to mdatagen and delete the file. -
service: Thetelemetry.disableHighCardinalityMetricsfeature gate is deprecated (#13537) The feature gate is now deprecated since metric views can be configured. The feature gate will be removed in v0.134.0.The metric attributes removed by this feature gate are no longer emitted by the Collector by default, but if needed, you can achieve the same functionality by configuring the following metric views:
service: telemetry: metrics: level: detailed views: - selector: meter_name: "go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc" stream: attribute_keys: excluded: ["net.sock.peer.addr", "net.sock.peer.port", "net.sock.peer.name"] - selector: meter_name: "go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp" stream: attribute_keys: excluded: ["net.host.name", "net.host.port"]Note that this requires setting
service::telemetry::metrics::level: detailed. If you have a strong use case for using views in combination with a different level, please show your interest in https://github.com/open-telemetry/opentelemetry-collector/issues/10769.
💡 Enhancements 💡
pdata: Generate Logs/Traces/Metrics/Profiles and p[log|trace|metric|profile]ExportResponse with pdatagen. (#13597) This change brings consistency on how these structs are written and remove JSON marshaling/unmarshaling hand written logic.confighttp: Add option to configure ForceAttemptHTTP2 to support HTTP/1 specific transport settings. (#13426)pdata: Avoid unnecessary buffer copy when JSON marshal fails. (#13598)cmd/mdatagen: Use a custom host implementation for lifecycle tests (#13589) Use a custom noop host implementation that implements all non-deprecated, publicly-accessible interfaces implemented by the Collector service.processorhelper: Add processor internal duration metric. (#13231)pdata: Improve RemoveIf for slices to not reference anymore the removed memory (#13522)
🧰 Bug fixes 🧰
-
pdata: Fix null pointer access when copying into a slice with larger cap but smaller len. (#13523) -
confighttp: Fix middleware configuration field name from "middleware" to "middlewares" for consistency with configgrpc (#13444) -
memorylimiterextension, memorylimiterprocessor: Memory limiter extension and processor shutdown don't throw an error if the component was not started first. (#9687) The components would throw an error if they were shut down before being started. With this change, they will no longer return an error, conforming to the lifecycle of components expected. -
confighttp: Reuse zstd Reader objects (#11824)
v1.37.0/v0.131.0
🛑 Breaking changes 🛑
confighttp: Moveconfighttp.framedSnappyfeature gate to beta. (#10584)
💡 Enhancements 💡
-
exporter/debug: Move to alpha stability except profiles (#13487) -
exporterhelper: Enableexporter.PersistRequestContextfeature gate by default. (#13437) Request context is now preserved by default when using persistent queues. Note that Auth extensions context is not propagated through the persistent queue. -
pdata: Use pdatagen to generate marshalJSON without using gogo proto jsonpb. (#13450) -
otlpreceiver: Remove usage of gogo proto which uses reflect.Value.MethodByName. Removes one source of disabling DCE. (#12747) -
exporterhelper: Fix metrics split logic to consider metrics description into the size. (#13418) -
service: New pipeline instrumentation now differentiates internal failures from downstream errors (#13234) With the telemetry.newPipelineTelemetry feature gate enabled, the "received" and "produced" metrics related to a component now distinguish between two types of errors:- "outcome = failure" indicates that the component returned an internal error;
- "outcome = refused" indicates that the component successfully emitted data, but returned an error coming from a downstream component processing that data.
-
pdata: Remove usage of text/template from pdata, improves DCE. (#12747) -
architecture: New Tier 3 platform riscv64 allowing the collector to be built and distributed for this platform. (#13462)
🧰 Bug fixes 🧰
exporterhelper: Prevents the exporter for being stuck when telemetry data is bigger than batch.max_size (#12893)mdatagen: Fix import paths for mdatagen component (#13069)otlpreceiver: Error handler correctly fallbacks to content type (#13414)pdata/pprofiles: Fix profiles JSON unmarshal logic for originalPayload. The bytes have to be base64 encoded. (#13483)xpdata: Fix unmarshaling JSON for entities, add e2e tests to avoid this in the future. (#13480)service: Downgrade dependency of prometheus exporter in OTel Go SDK (#13429) This fixes the bug where collector's internal metrics are emitted with an unexpected suffix in their names when users configure the service::telemetry::metrics::readers with Prometheusservice: Revert Default internal metrics config now enablesotel_scope_labels (#12939, #13344) Reverting change temporarily due to prometheus exporter downgrade. This unfortunately re-introduces the bug that instrumentation scope attributes cause errors in Prometheus exporter. See http://github.com/open-telemetry/opentelemetry-collector/issues/12939 for details.builder: Remove undocumented handling ofDIST_*environment variables replacements (#13335)
v1.36.1/v0.130.1
🧰 Bug fixes 🧰
service: Fixes bug where internal metrics are emitted with an unexpected suffix in their names when users configureservice::telemetry::metrics::readerswith Prometheus. (#13449) See more details on https://github.com/open-telemetry/opentelemetry-go/issues/7039
v1.36.0/v0.130.0
❗ Known Issues ❗
-
Due to a bug in the prometheus exporter, if you are configuring a prometheus exporter, the collector's internal metrics will be emitted with an unexpected suffix in its name. For example, the metric
otelcol_exporter_sent_spans__spans__totalinstead ofotelcol_exporter_sent_spans_total. The workaround is to manually configurewithout_units: truein your prometheus exporter configservice: telemetry: metrics: readers: - pull: exporter: prometheus: host: 0.0.0.0 port: 8888 without_units: trueIf you are using the collector's default Prometheus exporter for exporting internal metrics you are unaffected.
🛑 Breaking changes 🛑
exporter/otlp: Remove deprecated batcher config from OTLP, use queuebatch (#13339)
💡 Enhancements 💡
exporterhelper: Enable items and bytes sizers for persistent queue (#12881)exporterhelper: Refactor persistent storage size backup to always record it. (#12890)exporterhelper: Add support to configure a different Sizer for the batcher than the queue (#13313)yaml: Replacedsigs.k8s.io/yamlwithgo.yaml.in/yamlfor improved support and long-term maintainability. (#13308)
🧰 Bug fixes 🧰
-
exporterhelper: Fix exporter.PersistRequestContext feature gate (#13342) -
exporterhelper: Preserve all metrics metadata when batch splitting. (#13236) Previously, when large batches of metrics were processed, the splitting logic inmetric_batch.gocould cause thenamefield of some metrics to disappear. This fix ensures that all metric fields are properly preserved whenmetricRequestobjects are split. -
service: Default internal metrics config now enablesotel_scope_labels (#12939, #13344) By default, the Collector exports its internal metrics using a Prometheus exporter from the opentelemetry-go repository. With this change, the Collector no longer sets "without_scope_info" to true in its configuration.This means that all exported metrics will have
otel_scope_name,otel_scope_schema_url, andotel_scope_versionlabels corresponding to the instrumentation scope metadata for that metric.This notably prevents an error when multiple metrics are only distinguished by their instrumentation scopes and end up aliased during export.
If this is not desired behavior, a Prometheus exporter can be explicitly configured with this option enabled.
v1.35.0/v0.129.0
🛑 Breaking changes 🛑
exporterhelper: Remove deprecated sending_queue::blocking options, use sending_queue::block_on_overflow. (#13211)
💡 Enhancements 💡
-
mdatagen: Taught mdatagen to print thego liststderr output on failures, and to rungo listwhere the metadata file is. (#13205) -
service: Support settingsamplerandlimitsunderservice::telemetry::traces(#13201) This allows users to enable sampling and set span limits on internal Collector traces using the OpenTelemetry SDK declarative configuration. -
pdata/pprofile: Add new helper methodsFromLocationIndicesandPutLocationto read and modify the content of locations. (#13150) -
exporterhelper: Preserve request span context and client information in the persistent queue. (#11740, #13220, #13232) It allows internal collector spans and client information to propagate through the persistent queue used by the exporters. The same way as it's done for the in-memory queue. Currently, it is behind the exporter.PersistRequestContext feature gate, which can be enabled by adding--feature-gates=exporter.PersistRequestContextto the collector command line. An exporter buffer stored by a previous version of the collector (or by a collector with the feature gate disabled) can be read by a newer collector with the feature enabled. However, the reverse is not supported: a buffer stored by a newer collector with the feature enabled cannot be read by an older collector (or by a collector with the feature gate disabled).
🧰 Bug fixes 🧰
pdata: Fix copying of optional fields when the source is unset. (#13268)service: Only allocate one set of internal log sampling counters (#13014) The case where logs are only exported to stdout was fixed in v0.126.0; this new fix also covers the case where logs are exported through OTLP.
v1.34.0/v0.128.0
🛑 Breaking changes 🛑
service/telemetry: Mark "telemetry.disableAddressFieldForInternalTelemetry" as stable (#13152)
💡 Enhancements 💡
-
confighttp: Update the HTTP server span naming to use the HTTP method and route pattern instead of the path. (#12468) The HTTP server span name will now be formatted as<http.request.method> <http.route>. If a route pattern is not available, it will fall back to<http.request.method>. -
service: Use configured loggers to log errors as soon as it is available (#13081) -
service: Remove stabilized featuregate useOtelWithSDKConfigurationForInternalTelemetry (#13152)
🧰 Bug fixes 🧰
-
telemetry: Add generated resource attributes to the printed log messages. (#13110) If service.name, service.version, or service.instance.id are not specified in the config, they will be generated automatically. This change ensures that these attributes are also included in the printed log messages. -
mdatagen: Fix generation when there are no events in the metadata. (#13123) -
confmap: Do not panic on assigning nil maps to non-nil maps (#13117) -
pdata: Fix event_name skipped when unmarshalling LogRecord from JSON (#13127)
v1.33.0/v0.127.0
🚩 Deprecations 🚩
semconv: Deprecating the semconv package in favour of go.opentelemetry.io/otel/semconv (#13012)
💡 Enhancements 💡
exporter/debug: Display resource and scope innormalverbosity (#10515)service: Add size metrics defined in Pipeline Component Telemetry RFC (#13032) See Pipeline Component Telemetry RFC for more details:otelcol.receiver.produced.sizeotelcol.processor.consumed.sizeotelcol.processor.produced.sizeotelcol.connector.consumed.sizeotelcol.connector.produced.sizeotelcol.exporter.consumed.size
v1.32.0/v0.126.0
🛑 Breaking changes 🛑
configauth: Removes deprecatedconfigauth.Authenticationandextensionauthtest.NewErrorClient(#12992) The following have been removed:configauth.Authenticationuseconfigauth.Configinsteadextensionauthtest.NewErrorClientuseextensionauthtest.NewErrinstead
💡 Enhancements 💡
-
service: Replacego.opentelemetry.io/collector/semconvusage withgo.opentelemetry.io/otel/semconv(#12991) -
confmap: Update the behavior of the confmap.enableMergeAppendOption feature gate to merge only component lists. (#12926) -
service: Add item count metrics defined in Pipeline Component Telemetry RFC (#12812) See Pipeline Component Telemetry RFC for more details:otelcol.receiver.produced.itemsotelcol.processor.consumed.itemsotelcol.processor.produced.itemsotelcol.connector.consumed.itemsotelcol.connector.produced.itemsotelcol.exporter.consumed.items
-
tls: Add trusted platform module (TPM) support to TLS authentication. (#12801) Now the TLS allows the use of TPM for loading private keys (e.g. in TSS2 format).
🧰 Bug fixes 🧰
-
exporterhelper: Add validation error for batch config if min_size is greater than queue_size. (#12948) -
telemetry: Allocate less memory per component when OTLP exporting of logs is disabled (#13014) -
confmap: Use reflect.DeepEqual to avoid panic when confmap.enableMergeAppendOption feature gate is enabled. (#12932) -
internal telemetry: Add resource attributes from telemetry.resource to the logger (#12582) Resource attributes from telemetry.resource were not added to the internal console logs.Now, they are added to the logger as part of the "resource" field.
-
confighttp and configcompression: Fix handling ofsnappycontent-encoding in a backwards-compatible way (#10584, #12825) The collector used the Snappy compression type of "framed" to handle the HTTP content-encoding "snappy". However, this encoding is typically used to indicate the "block" compression variant of "snappy". This change allows the collector to:- When receiving a request with encoding 'snappy', the server endpoints will peek at the first bytes of the payload to determine if it is "framed" or "block" snappy, and will decompress accordingly. This is a backwards-compatible change.
If the feature-gate "confighttp.framedSnappy" is enabled, you'll see new behavior for both client and server:
- Client compression type "snappy" will now compress to the "block" variant of snappy instead of "framed". Client compression type "x-snappy-framed" will now compress to the "framed" variant of snappy.
- Servers will accept both "snappy" and "x-snappy-framed" as valid content-encodings.
-
tlsconfig: Disable TPM tests on MacOS/Darwin (#12964)
v1.31.0/v0.125.0
🛑 Breaking changes 🛑
-
service: Lowercase values for 'otelcol.component.kind' attributes. (#12865) -
service: Restrict thetelemetry.newPipelineTelemetryfeature gate to metrics. (#12856, #12933) The "off" state of this feature gate introduced a regression, where the Collector's internal logs were missing component attributes. See issue #12870 for more details on this bug.On the other hand, the "on" state introduced an issue with the Collector's default internal metrics, because the Prometheus exporter does not currently support instrumentation scope attributes.
To solve both of these issues, this change turns on the new scope attributes for logs and traces by default regardless of the feature gate. However, the new scope attributes for metrics stay locked behind the feature gate, and will remain off by default until the Prometheus exporter is updated to support scope attributes.
Please understand that enabling the
telemetry.newPipelineTelemetryfeature gate may break the export of Collector metrics through, depending on your configuration. Having abatchprocessor in multiple pipelines is a known trigger for this.This comes with a breaking change, where internal logs exported through OTLP will now use instrumentation scope attributes to identify the source component instead of log attributes. This does not affect the Collector's stderr output. See the changelog for v0.123.0 for a more detailed description of the gate's effects.
💡 Enhancements 💡
mdatagen: Add support for attributes for telemetry configuration in metadata. (#12919)configmiddleware: Add extensionmiddleware interface. (#12603, #9591)configgrpc: Add gRPC middleware support. (#12603, #9591)confighttp: Add HTTP middleware support. (#12603, #9591, #7441)configmiddleware: Add configmiddleware struct. (#12603, #9591)
🧰 Bug fixes 🧰
exporterhelper: Do not ignore thenum_consumerssetting when batching is enabled. (#12244)exporterhelper: Reject elements larger than the queue capacity (#12847)mdatagen: Add time and plog package imports (#12907)confmap: Maintain nil values when marshaling or unmarshaling nil slices (#11882) Previously, nil slices were converted to empty lists, which are semantically different than a nil slice. This change makes this conversion more consistent when encoding or decoding config, and these values are now maintained.
v1.30.0/v0.124.0
💡 Enhancements 💡
exporterhelper: Add support for bytes-based batching for profiles in the exporterhelper package. (#3262)otelcol: Enhance config validation using command to capture all validation errors that prevents the collector from starting. (#8721)exporterhelper: Link batcher context to all batched request's span contexts. (#12212, #8122)
🧰 Bug fixes 🧰
confighttp: Ensure http authentication server failures are handled by the provided error handler (#12666)
v1.29.0/v0.123.0
❗ Known Issues ❗
- This version increases memory usage by ~0.5 MB per component in the pipelines because a separate Zap Core logger is initialized for each component. The issue is partially fixed in v0.126.0 for users who write logs to stdout, but do not export logs via OTLP. See https://github.com/open-telemetry/opentelemetry-collector/issues/13014 for more details.
🛑 Breaking changes 🛑
service/telemetry: Marktelemetry.disableAddressFieldForInternalTelemetryas beta, usage of deprecated service::telemetry::address are ignored (#25115) To restore the previous behavior disabletelemetry.disableAddressFieldForInternalTelemetryfeature gate.exporterbatch: Remove deprecated fieldsmin_size_itemsandmax_size_itemsfrom batch config. (#12684)
🚩 Deprecations 🚩
otlpexporter: Mark BatcherConfig as deprecated, usesending_queue::batchinstead (#12726)exporterhelper: Deprecateblockingin favor ofblock_on_overflow. (#12710)exporterhelper: Deprecate configuring exporter batching separately. Usesending_queue::batchinstead. (#12772) Moving the batching configuration tosending_queue::batchrequires settingsending_queue::sizertoitemswhich means thatsending_queue::queue_sizeneeds to be also increased by the average batch size number (roughly x5000 for the default batching configuration). See https://github.com/open-telemetry/opentelemetry-collector/tree/main/exporter/exporterhelper#configuration
💡 Enhancements 💡
-
exporterhelper: Add support to configure batching in the sending queue. (#12746) -
exporterhelper: Add support for wait_for_result, remove disabled_queue (#12742) This has a side effect for users of the experimental BatchConfig with the queue disabled, since not this is | uses only NumCPU() consumers. -
exporterhelper: Allow exporter memory queue to use different type of sizers. (#12708) -
service: Add "telemetry.newPipelineTelemetry" feature gate to inject component-identifying attributes in internal telemetry (#12217) With the feature gate enabled, all internal telemetry (metrics/traces/logs) will include some of the following instrumentation scope attributes:otelcol.component.kindotelcol.component.idotelcol.pipeline.idotelcol.signalotelcol.signal.output
These attributes are defined in the Pipeline Component Telemetry RFC, and identify the component instance from which the telemetry originates. They are added automatically without changes to component code.
These attributes were already included in internal logs as regular log attributes, starting from v0.120.0. For consistency with other signals, they have been switched to scope attributes (with the exception of logs emitted to standard output), and are now enabled by the feature gate.
Please make sure that the exporter / backend endpoint you use has support for instrumentation scope attributes before using this feature. If the internal telemetry is exported to another Collector, a transform processor could be used to turn them into other kinds of attributes if necessary.
-
exporterhelper: Enable support to do batching usingbytessizer (#12751) -
service: Add config key to set metric views used for internal telemetry (#10769) Theservice::telemetry::metrics::viewsconfig key can now be used to explicitly set the list of metric views used for internal telemetry, mirroringmeter_provider::viewsin the SDK config. This can be used to disable specific internal metrics, among other uses.This key will cause an error if used alongside other features which would normally implicitly create views, such as:
- not setting
service::telemetry::metrics::leveltodetailed; - enabling the
telemetry.disableHighCardinalityMetricsfeature flag.
- not setting
🧰 Bug fixes 🧰
exporterhelper: Fix order of starting between queue and batch. (#12705)
v1.28.1/v0.122.1
🧰 Bug fixes 🧰
confmap: Ensure slices with defaults containing struct values are correctly set. (#12661) This reverts the changes made in https://github.com/open-telemetry/opentelemetry-collector/pull/11882.
v1.28.0/v0.122.0
🛑 Breaking changes 🛑
-
service: Batch processor telemetry is no longer emitted at "basic" verbosity level (#7890) According to the guidelines, basic-level telemetry should be reserved for core Collector APIs. Components such as the batch processor should emit telemetry starting from the "normal" level (which is also the default level).Migration: If your Collector telemetry was set to
level: basicand you want to keep seeing batch processor-related metrics, consider switching tolevel: normalinstead.
💡 Enhancements 💡
-
service: Addservice.AllowNoPipelinesfeature gate to allow starting the Collector without pipelines. (#12613) This can be used to start with only extensions. -
mdatagen: Delete generated_status.go if the component type doesn't require it. (#12346) -
componenttest: Improve config struct mapstructure field tag checks (#12590)remaintags andomitemptytags without a custom field name will now pass validation. -
service: include component id/type in start error (#10426) -
mdatagen: Add deprecation date and migration guide fields as part of component metadata (#12359) -
confmap: Introduce a new feature flag to allow for merging lists instead of discarding the existing ones. (#8394, #8754, #10370) You can enable this option via the command line by running following command: otelcol --config=main.yaml --config=extra_config.yaml --feature-gates=-confmap.enableMergeAppendOption -
zpagesextension: Add expvar handler to zpages extension. (#11081)
🧰 Bug fixes 🧰
-
confmap: Maintain nil values when marshaling or unmarshaling nil slices (#11882) Previously, nil slices were converted to empty lists, which are semantically different than a nil slice. This change makes this conversion more consistent when encoding or decoding config, and these values are now maintained. -
service: do not attempt to register process metrics if they are disabled (#12098)
v1.27.0/v0.121.0
🛑 Breaking changes 🛑
confighttp: Make the client config optionsmax_idle_conns,max_idle_conns_per_host,max_conns_per_host, andidle_conn_timeoutintegers (#9478) All four options can be set to0where they were previously set tonull
🚩 Deprecations 🚩
exporterhelper: Deprecatemin_size_itemsandmax_size_itemsin favor ofmin_sizeandmax_size. (#12486)
💡 Enhancements 💡
-
mdatagen: Addconverterandprovidermodule classes (#12467) -
pipeline: output pipeline name with signal as signal[/name] format in logs. (#12410) -
memorylimiter: Add support to configure min GC intervals for soft and hard limits. (#12450) -
otlpexporter: Update the stability level for logs, it has been as stable as traces and metrics for some time. (#12423) -
service: Create a new subcommand to dump the initial configuration after resolving/merging. (#11479) To use theprint-initial-configsubcommand, invoke the Collector with the subcommand and corresponding feature gate:otelcol print-initial-config --feature-gates=otelcol.printInitialConfig --config=config.yaml. Note that the feature gate enabling this flag is currently in alpha stability, and the subcommand may be changed in the future. -
memorylimiterprocessor: Add support for profiles. (#12453) -
otelcol: Converters are now available in thecomponentscommand. (#11900, #12385) -
component: Mark module as stable (#9376) -
confmap: Surface YAML parsing errors when they happen at the top-level. (#12180) This adds context to some instances of the error "retrieved value (type=string) cannot be used as a Conf", which typically happens because of invalid YAML documents -
pprofile: Add LinkIndex attribute to the generated Sample type (#12485) -
exporterhelper: Stabilize exporter.UsePullingBasedExporterQueueBatcher and remove old batch sender (#12425) -
mdatagen: Update metadata schema with new fields without enforcing them (#12359)
🧰 Bug fixes 🧰
service: Fix crash at startup when converting from v0.2.0 to v0.3.0 (#12438)service: fix bug in parsing service::telemetry configuration (#12437)exporterhelper: Fix bug where the error logged when conversion of data fails is always nil (#12510)mdatagen: Adds back missing import for filter when emitting resource attributes (#12455)
v1.26.0/v0.120.0
🛑 Breaking changes 🛑
all: Added support for go1.24, bumped minimum version to 1.23 (#12370)mdatagen: Removing deprecated generated funcs and a few test funcs as well. (#12304)service: Align component logger attributes with those defined in RFC (#12217) See Pipeline Component Telemetry RFC
💡 Enhancements 💡
otlpreceiver: Update stability for logs (#12335)exporterhelper: Implement sync disabled queue used when batching is enabled. (#12245)exporterhelper: Enable the new pull-based batcher in exporterhelper (#12291)exporterhelper: Update queue size after the element is done exported (#12399) After this change the active queue size will include elements in the process of being exported.otelcol: Add featuregate command to display information about available features (#11998) The featuregate command allows users to view detailed information about feature gates including their status, stage, and description.
🧰 Bug fixes 🧰
memorylimiter: Logger no longer attributes to single signal, pipeline, or component. (#12217)otlpreceiver: Logger no longer attributes to random signal when receiving multiple signals. (#12217)exporterhelper: Fix undefined behavior access to request after send to next component. This causes random memory access. (#12281)exporterhelper: Fix default batcher to correctly call all done callbacks exactly once (#12247)otlpreceiver: Fix OTLP http receiver to correctly set Retry-After (#12367)otlphttpexporter: Fix parsing logic for Retry-After in OTLP http protocol. (#12366) The value of Retry-After field can be either an HTTP-date or delay-seconds and the current logic only parsed delay-seconds.cmd/builder: Ensure unique aliases for modules with same suffix (#12201)
v1.25.0/v0.119.0
🛑 Breaking changes 🛑
-
exporterhelper: Rename exporter span signal specific attributes (e.g. "sent_spans" / "send_failed_span") to "items.sent" / "items.failed". (#12165) -
cmd/mdatagen: Remove dead fieldtelemetry::level(#12144) -
exporterhelper: Change exporter ID to be a Span level attribute instead on each event. (#12164) This does not have an impact on the level of information emitted, but on the structure of the Span. -
cmd/mdatagen: Removelevelfield from metrics definition (#12145) This mechanism will be added back once a new views mechanism is implemented. -
service: Value for telemetry exporterotlp.protocolupdated fromgrpc/protobuftogrpc. (#12337) -
service: internal metrics exported over Prometheus may differ from previous versions. (#11611)Users who do not customize the Prometheus reader should not be impacted. The change to update the internal telemetry to use otel-go config can cause unexpected behaviour for end users. This change is caused by the default values in
configbeing different from what the Collector has used in previous versions. The following changes can occur when users configure theirservice::telemetry::metrics::readers:- the metric name will append a
_totalsuffix ifwithout_type_suffixis not configured. Setwithout_type_suffixtotrueto disable this. - units will be appended to metric name if
without_unitsis not configured. Setwithout_unitstotrueto disable this. - a
target_infometric will be emitted ifwithout_scope_infois not configured. Setwithout_scope_infototrueto disable this.
- the metric name will append a
💡 Enhancements 💡
configtls: Allow users to mention their preferred curve types for ECDHE handshake (#12174)service: remove custom code and instead use config package to instantiate meter provider. (#11611)otelcol: Adds support for listing config providers in components command's output (#11570)general: Reduce memory allocations when loading configuration and parsing component names (#11964)
🧰 Bug fixes 🧰
-
exporterhelper: Fix bug that the exporter with new batcher may have been marked as non mutation. (#12239) Only affects users that manually turned onexporter.UsePullingBasedExporterQueueBatcherfeaturegate. -
service: Preserve URL normalization logic that was present before. (#12254) -
confighttp: confighttp.ToServer now sets ErrorLog with a default logger backed by Zap (#11820)This change ensures that the http.Server's ErrorLog is correctly set using Zap's logger at the error level, addressing the issue of error logs being printed using a different logger.
-
exporterhelper: Fix context propagation for DisabledBatcher (#12231) -
mdatagen: apply fieldalignment to generated code (#12125) -
mdatagen: Fix bug where Histograms were marked as not supporting temporal aggregation (#12168) -
exporterhelper: Fix MergeSplit issue that ignores the initial message size. (#12257) -
service: Include validation errors from telemetry.Config when validating the service config (#12100) Previously validation errors were only printed to the console -
service-telemetry: pass the missing async error channel into service telemetry settings (#11417)
v1.24.0/v0.118.0
💡 Enhancements 💡
exporterhelper: Add blocking option to control queue behavior when full (#12090)debugexporter: Add EventName to debug exporter for Logs. EventName was added as top-level field in the LogRecord from 1.5.0 of proto definition. (#11966)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.exporterhelper: Change the memory queue implementation to not pre-allocate capacity objects. (#12070) This change improves memory usage of the collector under low utilization and is a prerequisite for supporting different other size limitations (number of items, bytes).
🧰 Bug fixes 🧰
mdatagen: apply fieldalignment to generated code (#12121)otelcoltest: SetDefaultSchemetoenvin the testConfigProviderto replicate the default provider used by the Collector. (#12066)
v1.23.0/v0.117.0
🛑 Breaking changes 🛑
otelcol: Remove warnings when 0.0.0.0 is used (#11713, #8510)
🧰 Bug fixes 🧰
internal/sharedcomponent: Fixed bug where sharedcomponent would use too much memory remembering all the previously reported statuses (#11826)
v1.22.0/v0.116.0
🛑 Breaking changes 🛑
pdata/pprofile: Remove deprecatedProfile.EndTimeandProfile.SetEndTimemethods. (#11796)
💡 Enhancements 💡
xconfighttp: Add WithOtelHTTPOptions to experimental module xconfighttp (#11770)
🧰 Bug fixes 🧰
exporterhelper: Fix memory leak at exporter shutdown (#11401)sharedcomponent: Remove race-condition and cleanup locking (#11819)
v1.21.0/v0.115.0
🛑 Breaking changes 🛑
otelcol: Change all logged timestamps to ISO8601. (#10543) This makes log timestamps human-readable (as opposed to epoch seconds in scientific notation), but may break users trying to parse logged lines in the old format.pdata/pprofile: Upgrade pdata to opentelemetry-proto v1.4.0 (#11722)
🚩 Deprecations 🚩
scraperhelper: Deprecate all Scraper helpers in scraperhelper (#11732) Deprecate ScrapeFunc, ScraperOption, WithStart, WithShutdown in favor of equivalent funcs in scraper package.
💡 Enhancements 💡
-
exporterqueue: Introduce a feature gate exporter.UsePullingBasedExporterQueueBatcher to use the new pulling model in exporter queue batching. (#8122, #10368) If both queuing and batching is enabled for exporter, we now use a pulling model instead of a pushing model. num_consumer in queue configuration is now used to specify the maximum number of concurrent workers that are sending out the request. -
service: label metrics as alpha to communicate their stability (#11729) -
consumer: Mark consumer as stable. (#9046) -
service: Add support for ca certificates in telemetry metrics otlp grpc exporter (#11633) Before this change the Certificate value in config was silently ignored.
🧰 Bug fixes 🧰
service: ensure OTLP emitted logs respect severity (#11718)featuregate: Fix an unfriendly display messageruntime errorwhen featuregate is used to display command line usage. (#11651)profiles: Fix iteration over scope profiles while counting the samples. (#11688)
v1.20.0/v0.114.0
💡 Enhancements 💡
-
cmd/builder: Allow for replacing of local Providers and Converters when building custom collector with ocb. (#11649) Use the propertypathundergomodto replace an go module with a local folder in builder-config.yaml. Ex:providers: - gomod: module.url/my/custom/provider v1.2.3 path: /path/to/local/provider -
cmd/builder: Allow configuringconfmap.Convertercomponents in ocb. (#11582) If no converters are specified, there will be no converters added. Currently, the only published converter isexpandconverterwhich is deprecated as of v0.107.0, but can still be added for testing purposes.To configure a custom converter, make sure your converter implements the converter interface and is published as a go module (or replaced locally if not published). You may then use the
converterskey in your OCB build manifest with a list of Go modules (and replaces as necessary) to include your converter.Please note that converters are order-dependent. The confmap will apply converters in order of which they are listed in your manifest if there is more than one.
-
all: shorten time period before removing an unmaintained component from 6 months to 3 months (#11664)
🧰 Bug fixes 🧰
all: Updates dialer timeout section documentation in confignet README (#11685)scraperhelper: If the scraper shuts down, do not scrape first. (#11632) When the scraper is shutting down, it currently will scrape at least once. With this change, upon receiving a shutdown order, the receiver's scraperhelper will exit immediately.
v1.19.0/v0.113.0
🛑 Breaking changes 🛑
internal/fanoutconsumer: Extract internal/fanoutconsumer as a separate go module (#11441)builder: Remove builder support to build old version, and the otelcol_version config (#11405) User should remove this property from their config, to build older versions use older builders.receiver: Make receivertest into its own module (#11462)builder: Remove deprecated flags from Builder (#11576) Here is the list of flags | --name, --description, --version, --otelcol-version, --go, --moduleinternal/sharedcomponent: Extract internal/sharedcomponent as a separate go module (#11442)
💡 Enhancements 💡
mdatagen: Add otlp as supported distribution (#11527)batchprocessor: Move single shard batcher creation to the constructor (#11594)service: add support for using the otelzap bridge and emit logs using the OTel Go SDK (#10544)
🧰 Bug fixes 🧰
service: ensure traces and logs emitted by the otel go SDK use the same resource information (#11578)config/configgrpc: Patch for bug in the grpc-go NewClient that makes the way the hostname is resolved incompatible with the way proxy setting are applied. (#11537)builder: Update builder default providers to latest stable releases (#11566)
v1.18.0/v0.112.0
🛑 Breaking changes 🛑
consumer/consumererror: Extract consumer/consumererror as a separate go module (#11440)exporter/exportertest: Put exportertest into its own module (#11461)service: Remove stable gate component.UseLocalHostAsDefaultHost (#11412)
🚩 Deprecations 🚩
processortest: Deprecated 'NewUnhealthyProcessorCreateSettings'. Use NewNopSettings instead. (#11307)
💡 Enhancements 💡
mdatagen: Added generated_package_name config field to support custom generated package name. (#11231)mdatagen: Generate documentation for components with resource attributes only (#10705)confighttp: Adding support for lz4 compression into the project (#9128)service: Hide profiles support behind a feature gate while it remains alpha. (#11477)exporterhelper: Retry sender will fail fast when the context timeout is shorter than the next retry interval. (#11183)
🧰 Bug fixes 🧰
cmd/builder: Fix default configuration for builder for httpprovider, httpsprovider, and yamlprovider. (#11357)processorhelper: Fix issue where in/out parameters were not recorded when error was returned from consumer. (#11351)
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'.loggingexporter: Removed the deprecated logging exporter. Use the debug exporter instead. (#11037)
🚩 Deprecations 🚩
service/telemetry: Deprecate service::telemetry::metrics::address in favor of service::telemetry::metrics::readers. (#11205)processorhelper: Deprecate BuildProcessorMetricName as it's no longer needed since introduction of mdatagen (#11302)
💡 Enhancements 💡
ocb: create docker images for OCB, per https://github.com/open-telemetry/opentelemetry-collector-releases/pull/671 (#5712) Adds standard Docker images for OCB to Dockerhub and GitHub, see hub.docker.com/r/otel/opentelemetry-collector-builderconfighttp: Snappy compression to lazy read for memory efficiency (#11177)httpsprovider: Mark the httpsprovider as stable. (#11191)httpprovider: Mark the httpprovider as stable. (#11191)yamlprovider: Mark the yamlprovider as stable. (#11192)confmap: Allow using any YAML structure as a string when loading configuration including time.Time formats (#10659) Previously, fields with time.Time formats could not be used as strings in configurations
🧰 Bug fixes 🧰
processorhelper: Fix data race condition, concurrent writes to the err variable, causes UB (Undefined Behavior) (#11350)cmd/builder: re-adds function to properly set and view version number of OpenTelemetry Collector Builder (ocb) binaries (#11208)pdata: Unmarshal Span and SpanLink flags from JSON (#11267)
v1.16.0/v0.110.0
🛑 Breaking changes 🛑
-
processorhelper: Update incoming/outgoing metrics to a single metric with aotel.signalattributes. (#11144) The following metrics were added in the previous version- otelcol_processor_incoming_spans
- otelcol_processor_outgoing_spans
- otelcol_processor_incoming_metric_points
- otelcol_processor_outgoing_metric_points
- otelcol_processor_incoming_log_records
- otelcol_processor_outgoing_log_records
They are being replaced with the following to more closely align with OTEP 259:
- otelcol_processor_incoming_items
- otelcol_processor_outgoing_items
-
processorhelper: Remove deprecated[Traces|Metrics|Logs]Inserted funcs (#11151) -
config: Mark UseLocalHostAsDefaultHostfeatureGate as stable (#11235)
🚩 Deprecations 🚩
processorhelper: deprecate accepted/refused/dropped metrics (#11201) The following metrics are being deprecated as they were only used in a single processor:otelcol_processor_accepted_log_recordsotelcol_processor_accepted_metric_pointsotelcol_processor_accepted_spansotelcol_processor_dropped_log_recordsotelcol_processor_dropped_metric_pointsotelcol_processor_dropped_spansotelcol_processor_refused_log_recordsotelcol_processor_refused_metric_pointsotelcol_processor_refused_spans
💡 Enhancements 💡
pdata: Add support to MoveTo for Map, allow avoiding copies (#11175)mdatagen: Add stability field to telemetry metrics, allowing the generated description to include a stability string. (#11160)confignet: Mark module as Stable. (#9801)confmap/provider/envprovider: Support default values when env var is empty (#5228)mdatagen: mdatagenvalidateMetrics()support validate metrics intelemetry.metric(#10925)service/telemetry: Mark useOtelWithSDKConfigurationForInternalTelemetry as stable (#7532)mdatagen: Use cobra for the command, add version flag (#11196)
🧰 Bug fixes 🧰
-
service: Ensure process telemetry is registered when internal telemetry is configured with readers instead of an address. (#11093) -
mdatagen: Fix incorrect generation of metric tests with boolean attributes. (#11169) -
otelcol: Fix the Windows Event Log configuration when running the Collector as a Windows service. (#5297, #11051) -
builder: Honor build_tags in config (#11156) -
builder: Fix version for providers in the default config (#11123) -
cmd/builder: Temporarily disable strict versioning checks (#11129, #11152) The strict versioning check may be enabled by default in a future version once all configuration providers are stabilized. -
confmap: Fix loading config of a component from a different source. (#11154) This issue only affected loading the whole component config, loading parts of a component config from a different source was working correctly.
v1.15.0/v0.109.0
🛑 Breaking changes 🛑
scraperhelper: Remove deprecatedObsReport,ObsReportSettings,NewObsReporttypes/funcs (#11086)confmap: Remove stableconfmap.strictlyTypedInputgate (#11008)confmap: Removes stableconfmap.unifyEnvVarExpansionfeature gate. (#11007)ballastextension: Removes the deprecated ballastextension (#10671)service: Removes stableservice.disableOpenCensusBridgefeature gate (#11009)
🚩 Deprecations 🚩
processorhelper: These funcs are not used anywhere, marking them deprecated. (#11083)
🚀 New components 🚀
extension/experimental/storage: Moveextension/experimental/storageinto a separate module (#11022)
💡 Enhancements 💡
-
configtelemetry: Add guidelines for each level of component telemetry (#10286) -
service: moveuseOtelWithSDKConfigurationForInternalTelemetrygate to beta (#11091) -
service: implement a no-op tracer provider that doesn't propagate the context (#11026) The no-op tracer provider supported by the SDK incurs a memory cost of propagating the context no matter what. This is not needed if tracing is not enabled in the Collector. This implementation of the no-op tracer provider removes the need to allocate memory when tracing is disabled. -
envprovider: Mark module as stable (#10982) -
fileprovider: Mark module as stable (#10983) -
processor: Add incoming and outgoing counts for processors using processorhelper. (#10910) Any processor using the processorhelper package (this is most processors) will automatically report incoming and outgoing item counts. The new metrics are:- otelcol_processor_incoming_spans
- otelcol_processor_outgoing_spans
- otelcol_processor_incoming_metric_points
- otelcol_processor_outgoing_metric_points
- otelcol_processor_incoming_log_records
- otelcol_processor_outgoing_log_records
🧰 Bug fixes 🧰
configgrpc: Change the value of max_recv_msg_size_mib from uint64 to int to avoid a case where misconfiguration caused an integer overflow. (#10948)exporterqueue: Fix a bug in persistent queue that Offer can becomes deadlocked when queue is almost full (#11015)
v1.14.1/v0.108.1
🧰 Bug fixes 🧰
mdatagen: Fix a missing import in the generated test file (#10969)
v1.14.0/v0.108.0
🛑 Breaking changes 🛑
all: Added support for go1.23, bumped the minimum version to 1.22 (#10869)otelcol: Remove deprecatedConfmapProviderinterface. (#10934)confmap: Markconfmap.strictlyTypedInputas 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: AddTelemetrySettings.LeveledMeterProviderfunc to replace MetricsLevel in the near future (#10931)mdatagen: AddLeveledMetermethod to mdatagen (#10933)service: Addslevelconfiguration option toservice::telemetry::traceto allow users to disable the default TracerProvider (#10892) This replaces the feature gateservice.noopTracerProviderintroduced in v0.107.0componentstatus: Add new Reporter interface to define how to report a status via acomponent.Hostimplementation (#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 settingSkipLifecycle&SkipShutdownto true would result in a generated file with an unused importconfmaptest(#10866)confmap: Use string representation for field types where all primitive types are strings. (#10937)otelcol: Preserve internal representation when unmarshaling component configs (#10552)
v1.13.0/v0.107.0
🛑 Breaking changes 🛑
service: Remove OpenCensus bridge completely, mark feature gate as stable. (#10414)confmap: Set theconfmap.unifyEnvVarExpansionfeature gate to Stable. Expansion of$FOOenv vars is no longer supported. Use${FOO}or${env:FOO}instead. (#10508)service: Removeotelcolfrom Prometheus configuration. This means that any metric that isn't explicitly prefixed withotelcol_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 gateservice.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 thetemporality_preferencesetting 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)
v0.106.1
🧰 Bug fixes 🧰
configauth: Fix unmarshaling of authentication in HTTP servers. (#10750)
v0.106.0
🛑 Breaking changes 🛑
-
service: Update all metrics to includeotelcol_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: DeleteClientConfig.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 theconfmap.unifyEnvVarExpansionfeature 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 modulego.opentelemetry.io/collector/client(#9804) This module contains generic representations of clients connecting to different receivers.
💡 Enhancements 💡
exporterhelper: Add data_type attribute tootelcol_exporter_queue_sizemetric 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)
v1.12.0/v0.105.0
🛑 Breaking changes 🛑
service: addservice.disableOpenCensusBridgefeature gate which is enabled by default to remove the dependency on OpenCensus (#10414)confmap: Promoteconfmap.strictlyTypedInputfeature 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 inENVverbatim 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, setbalancer_nametopick_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 toconfmap.strictlyTypedInputfeature gate. (#9532)confmap: Allow usingmap[string]anyvalues 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$$whenconfmap.unifyEnvVarExpansionis 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 whencomponent.UseLocalHostAsDefaultHostis enabled (#8510)
v1.11.0/v0.104.0
This release includes 2 very important breaking changes.
- The
otlpreceiverwill now uselocalhostby default instead of0.0.0.0. This may break the receiver in containerized environments like Kubernetes. If you depend on0.0.0.0disable thecomponent.UseLocalHostAsDefaultHostfeature gate or explicitly set the endpoint to0.0.0.0. - Expansion of BASH-style environment variables, such as
$FOOwill no longer be supported by default. If you depend on this syntax, disable theconfmap.unifyEnvVarExpansionfeature gate, but know that the feature will be removed in the future in favor of${env:FOO}.
🛑 Breaking changes 🛑
filter: Remove deprecatedfilter.CombinedFilter(#10348)otelcol: By default,otelcol.NewCommandandotelcol.NewCommandMustSetProviderwill set theDefaultSchemetoenv. (#10435)expandconverter: By default expandconverter will now error if it is about to expand$FOOsyntax. Update configuration to use${env:FOO}instead or disable theconfmap.unifyEnvVarExpansionfeature gate. (#10435)otlpreceiver: Switch tolocalhostas the default for all endpoints. (#8510) Disable thecomponent.UseLocalHostAsDefaultHostfeature gate to temporarily get the previous default.
💡 Enhancements 💡
confighttp: Add support for cookies in HTTP clients withcookies::enabled. (#10175) The methodconfighttp.ToClientwill return a client with acookiejar.Jarwhich will reuse cookies from server responses in subsequent requests.exporter/debug: Innormalverbosity, display one line of text for each telemetry record (log, data point, span) (#7806)exporter/debug: Add optionuse_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_spansprocessor_inserted_metric_pointsprocessor_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)
v1.10.0/v0.103.0
🛑 Breaking changes 🛑
exporter/debug: Disable sampling by default (#9921) To restore the behavior that was previously the default, setsampling_thereafterto500.
💡 Enhancements 💡
-
cmd/builder: Allow settingotelcol.CollectorSettings.ResolverSettings.DefaultSchemevia the builder'sconf_resolver.default_uri_schemeconfiguration option (#10296) -
mdatagen: add support for optional internal metrics (#10316) -
otelcol/expandconverter: Addconfmap.unifyEnvVarExpansionfeature gate to allow enabling Collector/Configuration SIG environment variable expansion rules. (#10391) When enabled, this feature gate will:- Disable expansion of BASH-style env vars (
$FOO) ${FOO}will be expanded as if it was `${env:FOO} See https://github.com/open-telemetry/opentelemetry-collector/blob/main/docs/rfcs/env-vars.md for more details.
- Disable expansion of BASH-style env vars (
-
confmap: Addconfmap.unifyEnvVarExpansionfeature gate to allow enabling Collector/Configuration SIG environment variable expansion rules. (#10259) When enabled, this feature gate will:- Disable expansion of BASH-style env vars (
$FOO) ${FOO}will be expanded as if it was `${env:FOO} See https://github.com/open-telemetry/opentelemetry-collector/blob/main/docs/rfcs/env-vars.md for more details.
- Disable expansion of BASH-style env vars (
-
confighttp: Allow the compression list to be overridden (#10295) Allows Collector administrators to control which compression algorithms to enable for HTTP-based receivers. -
configgrpc: Revert the zstd compression for gRPC to the third-party library we were using previously. (#10394) We switched back to our compression logic for zstd when a CVE was found on the third-party library we were using. Now that the third-party library has been fixed, we can revert to that one. For end-users, this has no practical effect. The reproducers for the CVE were tested against this patch, confirming we are not reintroducing the bugs. -
confmap: Adds alphaconfmap.strictlyTypedInputfeature gate that enables strict type checks during configuration resolution (#9532) When enabled, the configuration resolution system will:- Stop doing most kinds of implicit type casting when resolving configuration values
- Use the original string representation of configuration values if the ${} syntax is used in inline position
-
confighttp: Useconfighttp.ServerConfigas part of zpagesextension. See server configuration options. (#9368)
🧰 Bug fixes 🧰
exporterhelper: Fix potential deadlock in the batch sender (#10315)expandconverter: Fix bug where an warning was logged incorrectly. (#10392)exporterhelper: Fix a bug when the retry and timeout logic was not applied with enabled batching. (#10166)exporterhelper: Fix a bug where an unstarted batch_sender exporter hangs on shutdown (#10306)exporterhelper: Fix small batch due to unfavorable goroutine scheduling in batch sender (#9952)confmap: Fix issue where structs with only yaml tags were not marshaled correctly. (#10282)
v0.102.1
This release addresses GHSA-c74f-6mfw-mm4v for configgrpc.
🧰 Bug fixes 🧰
configrpc: Use own compressors for zstd. Before this change, the zstd compressor we used didn't respect the max message size. This addresses GHSA-c74f-6mfw-mm4v forconfiggrpc(#10323)
v1.9.0/v0.102.0
This release addresses GHSA-c74f-6mfw-mm4v for confighttp.
🛑 Breaking changes 🛑
envprovider: Restricts Environment Variable names. Environment variable names must now be ASCII only and start with a letter or an underscore, and can only contain underscores, letters, or numbers. (#9531)confighttp: Apply MaxRequestBodySize to the result of a decompressed body. This addresses GHSA-c74f-6mfw-mm4v forconfighttp(#10289) When using compressed payloads, the Collector would verify only the size of the compressed payload. This change applies the same restriction to the decompressed content. As a security measure, a limit of 20 MiB was added, which makes this a breaking change. For most clients, this shouldn't be a problem, but if you often have payloads that decompress to more than 20 MiB, you might want to either configure your client to send smaller batches (recommended), or increase the limit using the MaxRequestBodySize option.
💡 Enhancements 💡
mdatagen: auto-generate utilities to test component telemetry (#19783)mdatagen: support setting an AttributeSet for async instruments (#9674)mdatagen: support using telemetry level in telemetry builder (#10234) This allows components to set the minimum level needed for them to produce telemetry. By default, this is set to configtelemetry.LevelBasic. If the telemetry level is below that minimum level, then the noop meter is used for metrics.mdatagen: add support for bucket boundaries for histograms (#10218)releases: add documentation in how to verify the image signatures using cosign (#9610)
🧰 Bug fixes 🧰
batchprocessor: ensure attributes are set on cardinality metadata metric (#9674)batchprocessor: Fixing processor_batch_metadata_cardinality which was broken in v0.101.0 (#10231)batchprocessor: respect telemetry level for all metrics (#10234)exporterhelper: Fix potential deadlocks in BatcherSender shutdown (#10255)
v1.8.0/v0.101.0
💡 Enhancements 💡
-
mdatagen: generate documentation for internal telemetry (#10170) -
mdatagen: add ability to use metadata.yaml to automatically generate instruments for components (#10054) Thetelemetrysection in metadata.yaml is used to generate instruments for components to measure telemetry about themselves. -
confmap: Allow Converters to write logs during startup (#10135) -
otelcol: Enable logging during configuration resolution (#10056)
🧰 Bug fixes 🧰
mdatagen: Run package tests when goleak is skipped (#10125)
v1.7.0/v0.100.0
🛑 Breaking changes 🛑
service: Thevalidatesub-command no longer validates that each pipeline's type is the same as its component types (#10031)
💡 Enhancements 💡
semconv: Add support for v1.25.0 semantic convention (#10072)builder: remove the need to go get a module to address ambiguous import paths (#10015)pmetric: Support parsing metric.metadata from OTLP JSON. (#10026)
🧰 Bug fixes 🧰
exporterhelper: Fix enabled config option for batch sender (#10076)
v1.6.0/v0.99.0
🛑 Breaking changes 🛑
-
builder: Add strict version checking when using the builder. Add the temporary flag--skip-strict-versioningfor skipping this check. (#9896) Strict version checking will error on major and minor version mismatches between theotelcol_versionconfigured and the builder version or versions in the go.mod. This check can be temporarily disabled by using the--skip-strict-versioningflag. This flag will be removed in a future minor version. -
telemetry: Distributed internal metrics across different levels. (#7890) The internal metrics levels are updated along with reported metrics:- The default level is changed from
basictonormal, which can be overridden withservice::telemetry::metrics::levelconfiguration. - Batch processor metrics are updated to be reported starting from
normallevel:processor_batch_batch_send_sizeprocessor_batch_metadata_cardinalityprocessor_batch_timeout_trigger_sendprocessor_batch_size_trigger_send
- GRPC/HTTP server and client metrics are updated to be reported starting from
detailedlevel:- http.client.* metrics
- http.server.* metrics
- rpc.server.* metrics
- rpc.client.* metrics
- The default level is changed from
💡 Enhancements 💡
-
confighttp: Disable concurrency in zstd compression (#8216) -
cmd/builder: Allow configuringconfmap.Providers in the builder. (#4759) If no providers are specified, the defaults are used. The default providers are: env, file, http, https, and yaml.To configure providers, use the
providerskey in your OCB build manifest with a list of Go modules for your providers. The modules will work the same as other Collector components. -
mdatagen: enable goleak tests by default via mdatagen (#9959) -
cmd/mdatagen: support excluding some metrics based on string and regexes in resource_attributes (#9661) -
cmd/mdatagen: Generate config and factory tests covering their requirements. (#9940) The tests are moved from cmd/builder. -
confmap: AddProviderSettings,ConverterSettings,ProviderFactories, andConverterFactoriesfields toconfmap.ResolverSettings(#9516) This allows configuring providers and converters, which are instantiated byNewResolverusing the given factories.
🧰 Bug fixes 🧰
exporter/otlp: Allow DNS scheme to be used in endpoint (#4274)service: fix record sampler configuration (#9968)service: ensure the tracer provider is configured via go.opentelemetry.io/contrib/config (#9967)otlphttpexporter: Fixes a bug that was preventing the otlp http exporter from propagating status. (#9892)confmap: Fix decoding negative configuration values into uints (#9060)
v1.5.0/v0.98.0
🛑 Breaking changes 🛑
service: emit internal collector metrics with _ instead of / with OTLP export (#9774) This is addressing an issue w/ the names of the metrics generated by the Collector for its internal metrics. Note that this change only impacts users that emit telemetry using OTLP, which is currently still in experimental support. The prometheus metrics already replaced/with_and they will do the same with_.
💡 Enhancements 💡
mdatagen: Adds unsupported platforms to the README header (#9794)confmap: Clarify the use of embedded structs to make unmarshaling composable (#7101)nopexporter: Promote the nopexporter to beta (#7316)nopreceiver: Promote the nopreceiver to beta (#7316)otlpexporter: Checks for port in the config validation for the otlpexporter (#9505)service: Validate pipeline type against component types (#8007)
🧰 Bug fixes 🧰
configtls: Fix issue whereIncludeSystemCACertsPoolwas not consistently used betweenServerConfigandClientConfig. (#9835)component: Fix issue where thecomponentscommand wasn't properly printing the component type. (#9856)otelcol: Fix issue where thevalidatecommand wasn't properly printing valid component type. (#9866)receiver/otlp: Fix bug where the otlp receiver did not properly respond with a retryable error code when possible for http (#9357)
v1.4.0/v0.97.0
🛑 Breaking changes 🛑
telemetry: Remove telemetry.useOtelForInternalMetrics stable feature gate (#9752)
🚀 New components 🚀
-
exporter/nop: Add thenopexporterto serve as a placeholder exporter in a pipeline (#7316) This is primarily useful for starting the Collector with only extensions enabled or to test Collector pipeline throughput. -
receiver/nop: Add thenopreceiverto serve as a placeholder receiver in a pipeline (#7316) This is primarily useful for starting the Collector with only extensions enabled.
💡 Enhancements 💡
-
configtls: Validates TLS min_version and max_version (#9475) IntroducesValidate()method in TLSSetting. -
configcompression: Mark module as Stable. (#9571) -
cmd/mdatagen: Use go package name for the scope name by default and add an option to provide the scope name in metadata.yaml. (#9693) -
cmd/mdatagen: Generate the lifecycle tests for components by default. (#9683) It's encouraged to have lifecycle tests for all components enabled, but they can be disabled if needed in metadata.yaml withskip_lifecycle: trueandskip_shutdown: trueundertestssection. -
cmd/mdatagen: optimize the mdatagen for the case like batchprocessor which use a common struct to implement consumer.Traces, consumer.Metrics, consumer.Logs in the meantime. (#9688)
🧰 Bug fixes 🧰
exporterhelper: Fix persistent queue size backup on reads. (#9740)processor/batch: Prevent starting unnecessary goroutines. (#9739)otlphttpexporter: prevent error on empty response body when content type is application/json (#9666)confmap: confmap honorsUnmarshalmethods on config embedded structs. (#6671)otelcol: Respect telemetry configuration when running as a Windows service (#5300)
v1.3.0/v0.96.0
🛑 Breaking changes 🛑
configgrpc: Remove deprecatedGRPCClientSettings,GRPCServerSettings, andServerConfig.ToListenerContext. (#9616)confighttp: Remove deprecatedHTTPClientSettings,NewDefaultHTTPClientSettings, andCORSSettings. (#9625)confignet: Removes deprecatedNetAddrandTCPAddr(#9614)
💡 Enhancements 💡
configtls: Addinclude_system_ca_certs_poolto configtls, allowing to load system certs and additional custom certs. (#7774)otelcol: AddConfigProviderSettingstoCollectorSettings(#4759) This allows passing a custom list ofconfmap.Providers tootelcol.NewCommand.pdata: Update to OTLP v1.1.0 (#9587) Introduces Span and SpanLink flags.confmap: Update mapstructure to use a maintained fork, github.com/go-viper/mapstructure/v2. (#9634) See https://github.com/mitchellh/mapstructure/issues/349 for context.
🧰 Bug fixes 🧰
configretry: Allow max_elapsed_time to be set to 0 for indefinite retries (#9641)client: MakeMetadata.Getthread safe (#9595)
v1.2.0/v0.95.0
🛑 Breaking changes 🛑
all: scope name for all generated Meter/Tracer funcs now includes full package name (#9494)
💡 Enhancements 💡
confighttp: Adds support for Snappy decompression of HTTP requests. (#7632)configretry: Validatemax_elapsed_time, ensure it is larger thanmax_intervalandinitial_intervalrespectively. (#9489)configopaque: Mark module as stable (#9167)otlphttpexporter: Add support for json content encoding when exporting telemetry (#6945)confmap/converter/expandconverter, confmap/provider/envprovider, confmap/provider/fileprovider, confmap/provider/httpprovider, confmap/provider/httpsprovider, confmap/provider/yamlprovider: Split confmap.Converter and confmap.Provider implementation packages out of confmap. (#4759, #9460)
v1.1.0/v0.94.0
🛑 Breaking changes 🛑
receiver/otlp: Update gRPC code fromcodes.InvalidArgumenttocodes.Internalwhen a permanent error doesn't contain a gRPC status (#9415)
🚩 Deprecations 🚩
configgrpc: Deprecate GRPCClientSettings, use ClientConfig instead (#6767)
💡 Enhancements 💡
-
mdatagen: Add a generated test that checks the config struct usingcomponenttest.CheckConfigStruct(#9438) -
component: Addcomponent.UseLocalHostAsDefaultHostfeature gate that changes default endpoints from 0.0.0.0 to localhost (#8510) The only component in this repository affected by this is the OTLP receiver. -
confighttp: Add support of Host header (#9395) -
mdatagen: Remove use of ReportFatalError in generated tests (#9439)
🧰 Bug fixes 🧰
service: fix opencensus bridge configuration in periodic readers (#9361)otlpreceiver: Fix goroutine leak when GRPC server is started but HTTP server is unsuccessful (#9165)otlpexporter: PartialSuccess is treated as success, logged as warning. (#9243)
v0.93.0
🛑 Breaking changes 🛑
exporterhelper: remove deprecated exporterhelper.RetrySettings and exporterhelper.NewDefaultRetrySettings (#9256)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.
🚀 New components 🚀
extension/memory_limiter: Introduce amemory_limiterextension which receivers can use to reject incoming requests when collector doesn't have enough memory (#8632) The extension has the same configuration interface and behavior as the existingmemory_limiterprocessor, which potentially can be deprecated and removed in the future
💡 Enhancements 💡
-
configtls: addcipher_suitesto configtls. (#8105) Users can specify a list of cipher suites to pick from. If left blank, a safe default list is used. -
service: marktelemetry.useOtelForInternalMetricsas stable (#816) -
exporters: Cleanup log messages for export failures (#9219)- Ensure an error message is logged every time and only once when data is dropped/rejected due to export failure.
- Update the wording. Specifically, don't use "dropped" term when an error is reported back to the pipeline. Keep the "dropped" wording for failures happened after the enabled queue.
- Properly report any error reported by a queue. For example, a persistent storage error must be reported as a storage error, not as "queue overflow".
🧰 Bug fixes 🧰
configgrpc: Update dependency to address a potential crash in the grpc instrumentation (#9296)otlpreceiver: Ensure OTLP receiver handles consume errors correctly (#4335) Make sure OTLP receiver returns correct status code and follows the receiver contract (gRPC)zpagesextension: Remove mention of rpcz page from zpages extension (#9328)
v1.0.1/v0.92.0
🛑 Breaking changes 🛑
-
exporters/sending_queue: Do not re-enqueue failed batches, rely on the retry_on_failure strategy instead. (#8382) The current re-enqueuing behavior is not obvious and cannot be configured. It takes place only for persistent queue and only ifretry_on_failure::enabled=trueeven ifretry_on_failureis a setting for a different backoff retry strategy. This change removes the re-enqueuing behavior. Consider increasingretry_on_failure::max_elapsed_timeto reduce chances of data loss or set it to 0 to keep retrying until requests succeed. -
confmap: Make the optionWithErrorUnusedenabled by default when unmarshaling configuration (#7102) The optionWithErrorUnusedis now enabled by default, and a new optionWithIgnoreUnusedis introduced to ignore errors about unused fields. -
status: DeprecateReportComponentStatusin favor ofReportStatus. This new function does not return an error. (#9148)
🚩 Deprecations 🚩
-
connectortest: Deprecate connectortest.New[Metrics|Logs|Traces]Router in favour of connector.New[Metrics|Logs|Traces]Router (#9095) -
exporterhelper: Deprecate exporterhelper.RetrySettings in favor of configretry.BackOffConfig (#9091) -
extension/ballast: Deprecatememory_ballastextension. (#8343) UseGOMEMLIMITenvironment variable instead. -
connector: Deprecate [Metrics|Logs|Traces]Router in favour of [Metrics|Logs|Traces]RouterAndConsumer (#9095)
💡 Enhancements 💡
-
exporterhelper: Add RetrySettings validation function (#9089) Validate that time.Duration, multiplier values in configretry are non-negative, and randomization_factor is between 0 and 1 -
service: Enabletelemetry.useOtelForInternalMetricsby updating the flag to beta (#7454) The metrics generated should be consistent with the metrics generated previously with OpenCensus. Users can disable the behaviour by setting--feature-gates -telemetry.useOtelForInternalMetricsat collector start. -
mdatagen: move component from contrib to core (#9172) -
semconv: Generated Semantic conventions 1.22.0. (#8686) -
confignet: Adddialer_timeoutconfig option. (#9066) -
processor/memory_limiter: Update config validation errors (#9059)- Fix names of the config fields that are validated in the error messages
- Move the validation from start to the initialization phrase
-
exporterhelper: Add config Validate for TimeoutSettings (#9104)
🧰 Bug fixes 🧰
memorylimiterprocessor: Fixed leaking goroutines from memorylimiterprocessor (#9099)cmd/otelcorecol: Fix the code detecting if the collector is running as a service on Windows. (#7350) Removed theNO_WINDOWS_SERVICEenvironment variable given it is not needed anymore.otlpexporter: remove dependency of otlphttpreceiver on otlpexporter (#6454)
v0.91.0
💡 Enhancements 💡
statusreporting: Automates status reporting upon the completion of component.Start(). (#7682)service: add resource attributes as labels to otel metrics to ensures backwards compatibility with OpenCensus metrics. (#9029)semconv: Generated Semantic conventions 1.21. (#9056)config/confighttp: Exposes http/2 transport settings to enable health check and workaround golang http/2 issue https://github.com/golang/go/issues/59690 (#9022)cmd/builder: running builder version on binaries installed withgo installwill output the version specified at the suffix. (#8770)
🧰 Bug fixes 🧰
-
exporterhelper: fix missed metric aggregations (#9048) This ensures that context cancellation in the exporter doesn't interfere with metric aggregation. The OTel SDK currently returns if there's an error in the context used inAdd. This means that if there's a cancelled context in an export, the metrics are now recorded. -
service: Fix bug where MutatesData would not correctly propagate through connectors. (#9053)
v0.90.1
🧰 Bug fixes 🧰
exporterhelper: Remove noisy log (#9017)
v1.0.0/v0.90.0
🛑 Breaking changes 🛑
service: To remain backwards compatible w/ the metrics generated today, otel generated metrics will be generated without the_totalsuffix (#7454)service: use WithNamespace instead of WrapRegistererWithPrefix (#8988) Using this functionality in the otel prom exporter fixes a bug where the target_info was prefixed as otelcol_target_info previously.
💡 Enhancements 💡
exporter/debug: Change defaultverbosityfromnormaltobasic(#8844) This change has currently no effect, asbasicandnormalverbosity share the same behavior. This might change in the future though, with thenormalverbosity being more verbose than it currently is (see https://github.com/open-telemetry/opentelemetry-collector/issues/7806). This is why we are changing the default tobasic, which is expected to stay at the current level of verbosity (one line per batch).exporterhelper: Fix shutdown logic in persistent queue to not require consumers to be closed first (#8899)confighttp: Support proxy configuration field in all exporters that support confighttp (#5761)
🧰 Bug fixes 🧰
exporterhelper: Fix invalid write index updates in the persistent queue (#8115)
v1.0.0-rcv0018/v0.89.0
💡 Enhancements 💡
builder: remove replace statement in builder template (#8763)service/extensions: Allow extensions to declare dependencies on other extensions and guarantee start/stop/notification order accordingly. (#8732)exporterhelper: Log export errors when retry is not used by the component. (#8791)cmd/builder: Add --verbose flag to loggosubcommands output that are ran as part of a build (#8715)exporterhelper: Remove internal goroutine loop for persistent queue (#8868)exporterhelper: Simplify usage of storage client, avoid unnecessary allocations (#8830)exporterhelper: Simplify logic in boundedMemoryQueue, use channels len/cap (#8829)
🧰 Bug fixes 🧰
exporterhelper: fix bug with queue size and capacity metrics (#8682)obsreporttest: split handler for otel vs oc test path in TestTelemetry (#8758)builder: Fix featuregate late initialization (#4967)service: Fix connector logger zap kind key (#8878)
v1.0.0-rcv0017/v0.88.0
💡 Enhancements 💡
fanoutconsumer: Enable runtime assertions to catch incorrect pdata mutations in the components claiming as non-mutating pdata. (#6794) This change enables the runtime assertions to catch unintentional pdata mutations in components that are claimed as non-mutating pdata. Without these assertions, runtime errors may still occur, but thrown by unrelated components, making it very difficult to troubleshoot.
🧰 Bug fixes 🧰
exporterhelper: make enqueue failures available for otel metrics (#8673)exporterhelper: Fix nil pointer dereference when stopping persistent queue after a start encountered an error (#8718)cmd/builder: Fix ocb ignoringotelcol_versionwhen set to v0.86.0 or later (#8692)
v1.0.0-rcv0016/v0.87.0
💡 Enhancements 💡
service/telemetry exporter/exporterhelper: Enable sampling logging by default and apply it to all components. (#8134) The sampled logger configuration can be disabled easily by setting theservice::telemetry::logs::sampling::enabledtofalse.core: Adds the ability for components to report status and for extensions to subscribe to status events by implementing an optional StatusWatcher interface. (#7682)
🧰 Bug fixes 🧰
telemetry: remove workaround to ignore errors when an instrument includes a/(#8346)
v1.0.0-rcv0015/v0.86.0
🚩 Deprecations 🚩
loggingexporter: Mark the logging exporter as deprecated, in favour of debug exporter (#7769)
🚀 New components 🚀
debugexporter: Add debug exporter, which replaces the logging exporter (#7769)
💡 Enhancements 💡
featuregate: List valid feature gates when failing to load invalid gate (#8505)supported platforms: Addlinux/s390xarchitecture to cross build tests in CI (#8213)
🧰 Bug fixes 🧰
builder: fix settingdist.*keys from env (#8239)configtls: fix incorrect use of fsnotify (#8438)
v0.85.0
💡 Enhancements 💡
components command: The "components" command now lists the component's stability levels. (#8289) Note that the format of this output is NOT stable and can change between versions.confighttp: Add option to disable HTTP keep-alives (#8260)
🧰 Bug fixes 🧰
confmap: fix bugs of unmarshalling slice values (#4001)exporterhelper: Stop logging error messages suggesting user to enableretry_on_failureorsending_queuewhen they are not available. (#8369)
v0.84.0
💡 Enhancements 💡
loggingexporter: Adds exemplars logging to the logging exporter whendetailedverbosity level is set. (#7912)configgrpc: Allow any registered gRPC load balancer name to be used. (#8262)service: add OTLP export for internal traces (#8106)configgrpc: Add support for :authority pseudo-header in grpc client (#8228)
🧰 Bug fixes 🧰
otlphttpexporter: Fix the handling of the HTTP response to ignore responses not encoded as protobuf (#8263)
v0.83.0
💡 Enhancements 💡
-
extension: Add optionalConfigWatcherinterface (#6596) Extensions implementing this interface will be notified of the Collector's effective config. -
otelcol: Add optionalConfmapProviderinterface for Config Providers (#6596) This allows providing the Collector's configuration as a marshaled confmap.Conf object from a ConfigProvider -
service: AddCollectorConffield toservice.Settings(#6596) This field is intended to be used by the Collector to pass its effective configuration to the service.
v1.0.0-rcv0014/v0.82.0
🛑 Breaking changes 🛑
-
service: Enable configuration of collector telemetry through prometheus reader (#7641) These options are still experimental. To enable them, users must enable bothtelemetry.useOtelForInternalMetricsandtelemetry.useOtelWithSDKConfigurationForInternalTelemetryfeature gates. This change updatesmetric_readerstoreadersto align with the configuration working group. -
service: Remove experimentalmetric_readers.argsandmetric_reader.typeconfig options. (#7641) These options were experimental and did not have any effect on the configuration of the collector's telemetry. The change aligns the configuration with the latest iteration of the configuration json schema, which may still change in the future.
💡 Enhancements 💡
-
service: Add support for exporting internal metrics to the console (#7641) Internal collector metrics can now be exported to the console using the otel-go stdout exporter. -
service: Add support forintervalandtimeoutconfiguration in periodic reader (#7641) -
service: Add support for span processor configuration for internal traces (#8106) These options are still experimental. To enable them, users must enable bothtelemetry.useOtelForInternalMetricsandtelemetry.useOtelWithSDKConfigurationForInternalTelemetryfeature gates. -
service: Add support for OTLP export for internal metrics (#7641) Internal collector metrics can now be exported via OTLP using the otel-go otlpgrpc and otlphttp exporters. -
scraperhelper: Adding optional timeout field to scrapers (#7951) -
otlpreceiver: Add http url paths per signal config options to otlpreceiver (#7511) -
otlphttpexporter: Add support for trailing slash in endpoint URL (#8084) URLs likehttp://localhost:4318/will now be treated as if they werehttp://localhost:4318
🧰 Bug fixes 🧰
connector: Fix connector validation (#7892) Validation of connectors was too aggressive such that a connector that was used in any combination of unsupported roles would fail. Instead, validation should pass as long as each use of the connector has a supported corresponding use.
v0.81.0
🛑 Breaking changes 🛑
service: Remove 'service.connectors' featuregate (#7952)
💡 Enhancements 💡
HTTPServerSettings: Add zstd support to HTTPServerSettings (#7927) This adds ability to decompress zstd-compressed HTTP requests to| all receivers that use HTTPServerSettings.cmd/builder: Add "--skip-generate" option to make builder skip source generation (#7541)confighttp: Add support for additional content decoders viaWithDecoderserver option (#7977)connectortest: Add helpers to aid the construction ofconnector.TracesRouter,connector.MetricsRouter, andconnector.LogsRouterinstances toconnectortest. (#7672)confighttp: Addresponse_headersconfiguration option on HTTPServerSettings. It allows for additional headers to be attached to each HTTP response sent to the client (#7328)otlpreceiver, otlphttpexporter, otlpexporter, configgrpc: Upgrade github.com/mostynb/go-grpc-compression and switch to nonclobbering imports (#7920) consumers of this library should not have their grpc codecs overriddenotlphttpexporter: Treat partial success responses as errors (#6686)
🧰 Bug fixes 🧰
HTTPServerSettings: Ensure requests with unsupported Content-Encoding return HTTP 400 Bad Request (#7927)
v1.0.0-rcv0013/v0.80.0
🚩 Deprecations 🚩
service: Deprecate service.PipelineConfig in favor of pipelines.Config. (#7854)
💡 Enhancements 💡
service: Added dry run flag to validate config file without running collector. (#4671)configtls: Allow TLS Settings to be provided in memory in addition to filepath. (#7313)connector: Updates the way connector nodes are built to always pass a fanoutconsumer to their factory functions. (#7672, #7673)otlp: update otlp protos to v0.20.0 (#7839)configauth: Split config/configauth into its own module (#7895)configgrpc, confighttp, config/internal: Split confighttp, configgrpc, and config/internal into separate modules (#7895)confignet: Split config/confignet into its own module (#7895)configopaque: Split config/configopaque into its own module (#7895)configtelemetry: Split config/configtelemetry into its own module (#7895)configtls: Split config/configtls into its own module (#7895)configcompression: Split config/configcompression into its own module (#7895)extension: Splittingextension/authinto separate module (#7054)connector: Split connector into its own module (#7895)extension: split extension module into its own module (#7306)processor: Split the processor into its own go module (#7307)confighttp: Avoid re-creating the compressors for every request. (#7859)otlpexporter: Treat partial success responses as errors (#6686)service/pipelines: Add pipelines.Config to remove duplicate of the pipelines configuration (#7854)
v0.79.0
🚩 Deprecations 🚩
component: Deprecate Host.GetExporters function (#7370)
💡 Enhancements 💡
-
otelcol: Add connectors to output of thecomponentscommand (#7809) -
scraperhelper: Will start calling scrapers on component start. (#7635) The change allows scrapes to perform their initial scrape on component start and provide an initial delay. This means that scrapes will be delayed byinitial_delaybefore first scrape and then run oncollection_intervalfor each consecutive interval. -
batchprocessor: Change multiBatcher to use sync.Map, avoid global lock on fast path (#7714)
🧰 Bug fixes 🧰
connectors: When replicating data to connectors, consider whether the next pipeline will mutate data (#7776)
v0.78.2
🧰 Bug fixes 🧰
batchprocessor: Fix return error for batch processor when consuming Metrics and Logs (#7711)
v0.78.1
🧰 Bug fixes 🧰
batchprocessor: Fix start/stop logic for batch processor (#7708)
v1.0.0-rcv0012/v0.78.0
💡 Enhancements 💡
batchprocessor: Add support for batching by metadata keys. (#4544)service: Add feature gatetelemetry.useOtelWithSDKConfigurationForInternalTelemetrythat will add support for configuring the export of internal telemetry to additional destinations in future releases (#7641)forwardconnector: Promote to beta (#7579)featuregate: Promotefeaturegateto the stable module-set (#7693)
🧰 Bug fixes 🧰
featuregate: Fix issue whereStageDeprecatedwas not usable (#7586)exporterhelper: Fix persistent storage behaviour with no available space on device (#7198)
v0.77.0
🛑 Breaking changes 🛑
-
exporterhelper: Reduce the default queue size to 1000 from 5000 (#7359) Affects any exporter which enables the queue by default and doesn't set its own default size. For example: otlphttp. -
featuregate: Remove deprecatedRemovalVersionandWithRegisterRemovalVersionfunctions. (#7587)
💡 Enhancements 💡
service: Adds ResourceAttributes map to telemetry settings and thus CreateSettings. (#6599)service: Allows users to disable high cardinality OTLP attributes behind a feature flag. (#7517)featuregate: Finalize purpose oftoVersion. Allow stable gates to be explicitly set to true, but produce a warning log. (#7626)
🧰 Bug fixes 🧰
config/confighttp: Ensure Auth RoundTripper follows compression/header changes (#7574)otlpreceiver: do not reject requests having 'content-type' header with optional parameters (#7452)
v1.0.0-rcv0011/v0.76.1
🛑 Breaking changes 🛑
confmap: Using an Invalid Scheme in a URI will throw an error. (#7504)
🚩 Deprecations 🚩
featuregate: Deprecate Gate.RemovalVersion and WithRegisterRemovalVersion in favor of ToVersion. (#7043)
💡 Enhancements 💡
-
batchprocessor: Support zero timeout. (#7508) This allows the batchprocessor to limit request sizes without introducing delay in a pipeline, to act only as a splitter. -
service: use the otel opencensus bridge when telemetry.useOtelForInternalMetrics is enabled (#7483) -
connector: Mark 'service.connectors' featuregate as stable (#2336) -
featuregate: Add a new Deprecated stage for feature gates, when features are abandoned. (#7043) -
loggingexporter: Show more counters in not detailed verbosity (#7461) The logging exporter now shows more counters when the verbosity is not detailed. The following numbers are added:- Number of resource logs
- Number of resource spans
- Number of resource metrics
- Number of data points
-
configtls: Reload mTLS ClientCA certificates on file change (#6524) -
confmap: Add support for nested URIs. (#7117) -
featuregate: Add concept of gate lifetime, [fromVersion, toVersion]. (#7043)
🧰 Bug fixes 🧰
obsreport: fix issue where send_failed_requests counter was reporting an incorrect value. (#7456)
v1.0.0-rc9/v0.75.0
🛑 Breaking changes 🛑
featuregate: Remove deprecated featuregate.FlagValue (#7401)
💡 Enhancements 💡
provider: Added userfriendly error on incorrect type. (#7399)
🧰 Bug fixes 🧰
loggingexporter: Fix display of bucket boundaries of exponential histograms to correctly reflect inclusive/exclusive bounds. (#7445)exporterhelper: Fix a deadlock in persistent queue initialization (#7400)
v1.0.0-rc8/v0.74.0
🛑 Breaking changes 🛑
consumererror: Remove deprecated funcs in consumererror (#7357)
🚩 Deprecations 🚩
featuregate: DeprecateFlagValuein favor ofNewFlag. (#7042)
💡 Enhancements 💡
service: Enable connectors by default by moving service.connectors featuregate to beta (#7369)
v0.73.0/v1.0.0-rc7
🛑 Breaking changes 🛑
consumererror: RemoveGetprefix from methods returning failed signal data (#7048)service: Feature gateservice.graphis now stable and cannot be disabled. It will be removed in the next version. (#2336)
💡 Enhancements 💡
exporter: split exporter into its own module (#7239)receiver: split receiver into its own module (#7174)connectors: Provide connectors with a mechanism to route data to specific pipelines (#7152)confmap: Markconfmap.expandEnabledas stable (#7323)
v1.0.0-rc6/v0.72.0
🛑 Breaking changes 🛑
all: Remove go 1.18 support, bump minimum to go 1.19 and add testing for 1.20 (#7151)pdata: Remove deprecated[Metrics|Traces|Logs]MoveTomethods. (#7165)featuregate: Remove deprecated funcs in featuregate. (#7173)
💡 Enhancements 💡
semconv: Generated Semantic conventions 1.17 that now contains theeventtype. (#7170)semconv: Generated Semantic conventions 1.18. (#7168)
🧰 Bug fixes 🧰
memorylimiterprocessor: Fix incorrect parsing of cgroups when running Collector with host mount (#6826)confmap: Clear list of old already closed closers. (#7215)
v1.0.0-rc5/v0.71.0
🛑 Breaking changes 🛑
pdata: Add private method to GrpcServer interface, disallow direct implementation (#6966)featuregate: Remove deprecated GetRegistry (#7011)pcommon: Remove deprecated Map.Sort (#6688)
🚩 Deprecations 🚩
featuregate: Deprecate Registry.List in favor of Registry.VisitAll. (#7041)featuregate: Deprecate Apply in favor of Set (#7018)pdata: Deprecate [Metrics|Logs|Traces].MoveTo methods. (#7091)featuregate: Deprecate RegistryOption in favor of RegisterOption (#7012)featuregate: Deprecate featuregate.Registry.[IsEnabled, RegisterID, MustRegister] (#6998)
🚀 New components 🚀
httpsprovider: Add the httpsprovider. This component allows the collector to fetch configurations from web servers using the HTTPS protocol. (#6683)
💡 Enhancements 💡
-
exporter: Allow configuration of fields,RandomizationFactorandMultiplier, for exponential backoff algorithm when retry on failure is enabled (#6610) -
connectors: Add "connectors", a new type of pipeline component (#2336)- Connectors connect pipelines by acting as an exporter in one or more pipelines and simultaneously
as a receiver of corresponding data in one or more other pipelines. For example:
- The
forwardconnector can export data to another pipeline of the same type. This allows you to merge data from multiple pipelines onto a common pipeline. Or, you can replicate data onto multiple pipelines so that it may be processed in different ways and/or exported to different backends. - The
countconnector can count data of any type. Regardless of the type of data that is counted, it emits counts as metrics onto a metrics pipeline.
- The
- Connectors are currently disabled by default but can be enabled with the
service.connectorsfeature gate. - See the connectors README for more details on how to use connectors.
- Connectors connect pipelines by acting as an exporter in one or more pipelines and simultaneously
as a receiver of corresponding data in one or more other pipelines. For example:
-
service: Enable new pipelines implementation using graphs. Controlled by theservice.graphfeaturegate. (#2336) -
builder: added ldflags command option (#6940) -
proctelemetry: Instrumentproctelemetry.ProcessMetricsmetrics with otel-go (#6886) -
capabilityconsumer: If the consumer has already the desired capability, don't wrap (#7116) -
confmap: Add support to resolve embedded uris inside a string, concatenate results. (#6932)
🧰 Bug fixes 🧰
confmap: Fix bug in confmap validation that allowed the usage of case-insensitive keys in the configurations, despite them failing silently. (#6876)logging: Fix the attribute key used to identify the receiver data type in logging configuration (#7033)
v1.0.0-RC4/v0.70.0
🛑 Breaking changes 🛑
pdata: Start enforcing grpc server implementation to embed UnimplementedGRPCServer, disallow client implementation (#6966)config/configgrpc: Change configgrpc.GRPCClientSettings.Headers type to map[string]configopaque.String (#6852) Useconfigopaque.String(str)andstring(opaque)to turn a string opaque/clear.pdata: Remove deprecated pcommon.Value.Equal (#6860)
🚩 Deprecations 🚩
pdata: Deprecate pcommon.Map.Sort(). (#6688)featuregate: Deprecate GetRegistry in favor of GlobalRegistry (#6979)
💡 Enhancements 💡
builder: Add remote debug option for otel-collector to builder (#6149)connector: Add Builder (#6867)cmd/builder: Add support for connector configurations (#6789)exporter/otlphttp: Retry only on status code 429/502/503/504 (#6845)featuregate: Reduce contention in featuregate by using sync.Map instead of mutex. (#6980)
🧰 Bug fixes 🧰
loggingexporter: Fix undefined symbol errors on building otelcorecol for other platforms than darwin, linux, windows. (#6924)otlpexporter: Fix a dataloss bug in persistent storage when collector shuts down or restarts (#6771)
v0.69.1
🧰 Bug fixes 🧰
various modules: Fix issue where some collector modules imported previous version of other modules (#6929)
v1.0.0-RC3/v0.69.0
🛑 Breaking changes 🛑
component: Remove deprecated Exporter types (#6880)component: Remove deprecated Extension types (#6865)component: Remove deprecated ProcessorFactoryOptions (#6881)component: Remove deprecated Receiver types (#6882)componenttest: Remove deprecated funcs from componenttest (#6836)batchprocessor: Remove deprecated batchprocessor.MetricViews and batchprocessor.OtelMetricViews (#6861)component: Remove deprecated component.[Factories|MakeProcessorFactoryMap] and componenttest.NewNopFactories (#6835)config: Remove deprecated config.*Settings (#6837)obsreporttest: Remove deprecated obsreporttest.SetupTelemetryWithID (#6861)component: Remove deprecated component [Traces|Metrics|Logs]Processor and ProcessorFactory (#6884)service: Remove deprecated service service.ConfigService and service.ConfigServicePipeline (#6859)
💡 Enhancements 💡
connector: Add MakeFactoryMap (#6889)semconv: Add semantic conventions for specification v1.16.0 (#6714)
🧰 Bug fixes 🧰
config: use [REDACTED] when marshaling to text a configopaque.String, instead of disclosing secret length. (#6868)
v1.0.0-RC2/v0.68.0
🛑 Breaking changes 🛑
componenttest: Move NopFactories to otelcoltest (#6792)config/confighttp: Change confighttp.HTTPClientSettings.Headers type to map[string]configopaque.String (#5653)config: Remove deprecatedcomponent.Config.[ID|SetIDName]. (#4714)configauth: Remove deprecated funcs/types fromconfigauth(#6719)component: Remove deprecated funcs/types from component package (#6769)component.[Exporter|Processor|Receiver|Extension]Configcomponent.Unmarshal[Exporter|Processor|Receiver|Extension]Configcomponent.[Exporter|Processor|Receiver|Extension]CreateDefaultConfigFunccomponent.[Exporter|Receiver|Extension]FactoryOptioncomponent.New[Exporter|Receiver|Extension]Factorycomponent.With[Traces|Metrics|Logs][Exporter|Receiver]component.Create[Traces|Metrics|Logs][Exporter|Receiver]Funccomponent.CreateExtensionFunc
componenttest: Remove deprecated componenttest.NewNop*CreateSettings (#6761)service: Remove deprecatedservice.[Collector|New|CollectorSettings|ConfigProvider](#5564)service: Remove deprecated funcsservice.NewCommandandservice.NewSvcHandler. (#5564)obsreporttest: Remove deprecate obsreporttest.Check* (#6720)service: Remove deprecatedservice.Config. (#6774)servicetest: Remove deprecatedservicetestpackage. (#5564)
🚩 Deprecations 🚩
service: Deprecateservice.ConfigServicein favor ofservice.Configandservice.ConfigServicePipelinein favor ofservice.PipelineConfig. (#6787)pdata: Deprecatepcommon.Value.Equalmethod (#6811)component: DeprecateProcessorrelated structs and functions in favor ofprocessorpackage (#6709)component: Deprecate component.Factories in favor of otelcol.Factories (#6723)config: Deprecateconfig.[Extension|Exporter|Connector|Receiver|Processor]Settings. (#6718)batchprocessor: Deprecate metric views funcs, for OC and Otel. (#6730)obsreporttest: Deprecate obsreporttest.SetupTelemetryWithID in favor of obsreporttest.SetupTelemetry (#6720)
🚀 New components 🚀
forwardconnector: Add forward connector (#6763)
💡 Enhancements 💡
components: Add [receiver|processor|exporter|extension].Builder to help with creating components form a set of configs and factories (#6803)configunmarshaler: Consolidate package into generic implementation (#6801)service: Shutdown internal telemetry with the Service (every time config changes). (#5564)
🧰 Bug fixes 🧰
configgrpc: Fix todo to add MeterProvider to grpc instrumentation (#4030)otlpreceiver: Fix otlpreceiver transport metrics attribute (#6695)
v1.0.0-RC1/v0.67.0
We are excited to announce that the pdata module is now available as a
v1.0.0 release candidate. While breaking changes may still happen in this
module before v1.0.0, we believe it is ready for final assessment and validation
and hope to make a v1.0.0 release soon.
🛑 Breaking changes 🛑
overwritepropertiesconverter: Remove deprecated packageoverwritepropertiesconverter(#6656)pdata: Change [...Slice|Map].Sort methods to not return any value (#6660)featuregate: remove deprecated functions (#6594)featuregate.GetID()featuregate.GetDescription()
obsreport: remove deprecated functions. (#6595)obsreport.MustNewExporterobsreport.MustNewProcessorobsreport.MustNewReceiverobsreport.MustNewScraper
service: Remove deprecatedservice.Stateenum values. (#6605)component: Remove deprecated func/types from component (#6606)config: Remove deprecated config.Pipelines and config.Pipeline (#6664)ballastextension: Remove deprecatedballastextension.MemoryBallasttype (#6628)component: RemoveValidate()from component.*Config interfaces and make it optional interface (#6544)confmap: Splitting confmap into its own module (#6185) The import path for the confmap module can now be access directly:go.opentelemetry.io/collector/confmap
🚩 Deprecations 🚩
-
service: Deprecate service.[Collector|NewSvcHandler|CollectorSettings|State|NewCommand] in favor of otelcol package" (#6608)- Deprecate
service.Configin favor ofotelcol.Config. - Deprecate
service.ConfigProviderin favor ofotelcol.ConfigProvider. - Deprecate
service.NewConfigProviderin favor ofotelcol.NewConfigProvider. - Deprecate
service.CollectorSettingsin favor ofotelcol.CollectorSettings. - Deprecate
service.Collectorin favor ofotelcol.Collector. - Deprecate
service.Newin favor ofotelcol.NewCollector. - Deprecate
service.Statein favor ofotelcol.State. - Deprecate
service.NewSvcHandlerin favor ofotelcol.NewSvcHandler. - Deprecate
service.NewCommandin favor ofotelcol.NewCommand.
- Deprecate
-
obsreporttest: Deprecate obsreporttest.Check* in favor of TestTelemetry.Check (#6678) -
component: Deprecate Exporter related types/funcs from component package in favor of exporter package. (#6578)component.ExporterCreateSettings->exporter.CreateSettingscomponent.CreateTracesExporterFunc->exporter.CreateTracesFunccomponent.CreateMetricsExporterFunc->exporter.CreateMetricsFunccomponent.CreateLogsExporterFunc->exporter.CreateLogsFunccomponent.ExporterFactory->exporter.Factorycomponent.NewExporterFactory->exporter.NewFactorycomponent.MakeExporterFactoryMap->exporter.MakeFactoryMapcomponenttest.NewNopExporterCreateSettings->exportertest.NewNopCreateSettingscomponenttest.NewNopExporterFactory->exportertest.NewNopFactory
-
component: Change Config to be opaque for otel collector core. (#4714)- Deprecate
component.Config.ID()in favor ofcomponent.[*]CreateSettings.ID. - Deprecate
component.Config.SetIDName(), no replacement needed since ID in settings is public member. - Deprecate
obsreporttest.SetupTelemetryin favor ofobsreporttest.SetupTelemetryWithID.
- Deprecate
-
component: Deprecatecomponent.Unmarshal[*]Configin favor ofcomponent.UnmarshalConfig(#6613) -
component: Deprecate Extension related types/funcs from component package in favor of extension package. (#6578)component.Extension->extension.Extensioncomponent.PipelineWatcher-> extension.PipelineWatchercomponent.ExtensionCreateSettings->extension.CreateSettingscomponent.CreateExtensionFunc->extension.CreateFunccomponent.ExtensionFactory->extension.Factorycomponent.NewExtensionFactory->extension.NewFactorycomponent.MakeExtensionFactoryMap->extension.MakeFactoryMapcomponenttest.NewNopExtensionCreateSettings->extensiontest.NewNopCreateSettingscomponenttest.NewNopExtensionFactory->extensiontest.NewNopFactory
-
component: DeprecateReceiverrelated structs and functions in favor ofreceiverpackage (#6687) -
component: Deprecatecomponent.[Exporter|Extension|Processor|Receiver]Configin favor ofcomponent.Config(#6578) -
pdata: Remove deprecated funcspdata.[Span|Trace]ID.HexString(#6627)
💡 Enhancements 💡
config/configopaque: Add newconfigopaque.Stringtype alias for opaque strings. (#5653)service: Added components sub command which outputs components in collector distribution. (#4671)component: Define new component type 'connectors' (#6577)connector: Add connector factory (#6611)connector: Add connector types (TracesConnector, MetricsConnector, LogsConnector) (#6689)connectortest: Add connector/connectortest package (#6711)component: Add recursive validation check for configs (#4584)service: Improve config error messages, split Validate functionality (#6665)extension/authextension: Define new authextension package and use new package in collector repo (#6467)- configauth.ClientAuthenticator -> auth.Client
- configauth.NewClientAuthenticator -> auth.NewClient
- configauth.ClientOption -> auth.ClientOption
- configauth.WithClientStart -> auth.WithClientStart
- configauth.WithClientShutdown -> auth.WithClientShutdown
- configauth.WithClientRoundTripper -> auth.WithClientRoundTripper
- configauth.WithPerRPCCredentials -> auth.WithClientPerRPCCredentials
- configauth.ServerAuthenticator -> auth.Server
- configauth.NewServerAuthenticator -> auth.NewServer
- configauth.Option -> auth.ServerOption
- configauth.AuthenticateFunc -> auth.ServerAuthenticateFunc
- configauth.WithAuthenticate -> auth.WithServerAuthenticate
- configauth.WithStart -> auth.WithServerStart
- configauth.WithShutdown -> auth.WithServerShutdown
obsreport: Instrumentobsreport.Processormetrics with otel-go (#6607)pdata: Add ability to clear optional fields (#6474)
🧰 Bug fixes 🧰
otlpexporter: Fix nil panic from otlp exporter in case of errors during Start. (#6633)service: Stop notification for signals before shutdown, increase channel size. (#6522)confmap: Fix support for concatenating envvars with colon (#6580)otlpexporter: Fix a bug that exporter persistent queue is sending duplicate data after restarting. (#6692)
v0.65.0
🛑 Breaking changes 🛑
-
featuregate: Capitalizefeaturegate.Stagestring values, remove Stage prefix. (#6490) -
configtelemetry: Update values returned byLevel.StringandLevel.MarshalTextmethod. (#6490)- All returned strings are capitalized.
- "" is returned for integers that are out of Level enum range.
- It also affects
Level.Marshaloutput, but it's not a problem becauseUnmarshalmethod accepts strings in all cases, e.g. "normal", "Normal" and "NORMAL".
-
featuregate: Make impossible to implement RegistryOption outsidefeaturegatepackage (#6532) -
service/telemetry: Remove unit suffixes from metrics exported by the otel-go prometheus exporter. (#6403) -
obsreport:obsreport.New[Receiver|Scraper|Processor|Exporter]returns error now (#6458) -
configgrpc: Remove deprecated funcs inconfiggrpc. (#6529)configgrpc.GRPCClientSettings.ToDialOptionsconfiggrpc.GRPCServerSettings.ToServerOption
-
config/configtest: Remove deprecatedconfigtestpackage. (#6542) -
config: Remove deprecated types and funcs from config. Usecomponentpackage. (#6511)- config.ComponentID
- config.Type
- config.DataType
- config.Receiver
- config.UnmarshalReceiver
- config.Processor
- config.UnmarshalProcessor
- config.Exporter
- config.UnmarshalExporter
- config.Extension
- config.UnmarshalExtension
-
featuregate: Remove deprecated funcs and struct members fromfeaturegatepackage (#6523)- featuregate.Gate.ID
- featuregate.Gate.Description
- featuregate.Gate.Enabled
- featuregate.Registry.Register
- featuregate.Registry.MustRegister
-
experimental: Remove experimental configsource code. (#6558) -
component: Update values returned byStabilityLevel.Stringmethod. (#6490)- All returned strings are capitalized.
- "Undefined" is returned only for
StabilityLevelUndefined. - "" is returned for integers that are out of StabilityLevel enum range.
🚩 Deprecations 🚩
-
pdata: Deprecatepcommon.[Span|Trace]ID.HexStringmethods. Callhex.EncodeToStringexplicitly instead. (#6514) -
obsreport: deprecateobsreport.MustNew[Receiver|Scraper|Processor|Exporter]in favor ofobsreport.New[Receiver|Scraper|Processor|Exporter](#6458)- Deprecate
obsreport.MustNewReceiver()in favor ofobsreport.NewReceiver() - Deprecate
obsreport.MustNewScraper()in favor ofobsreport.NewScraper() - Deprecate
obsreport.MustNewProcessor()in favor ofobsreport.NewProcessor() - Deprecate
obsreport.MustNewExporter()in favor ofobsreport.NewExporter()
- Deprecate
-
component: Deprecatecomponent.Receiver,component.Processor, andcomponent.Exporter. (#6553) -
featuregate: Deprecate Get prefix funcs forfeaturegate.Gate(#6528)featuregate.Gate.GetID->featuregate.Gate.IDfeaturegate.Gate.GetDescription->featuregate.Gate.Description -
component: Deprecatecomponent.Config.Validatein favor ofcomponent.ValidateConfig(#6572) -
component: DeprecateStabilityLevelInDevelopmentenum const in favor ofStabilityLevelDevelopment. (#6561) Also rename all mentions of "In development" stability level to "Development". -
service: Deprecateservice.[Starting|Running|Closing|Closed]in favor ofservice.State[Starting|Running|Closing|Closed](#6492)
💡 Enhancements 💡
component:component.Extensionis temporarily set to be an alias ofcomponent.Componentwhich will be reverted once it's moved to theextensionpackage. Change yourcomponent.Host.GetExtensions()implementation to returnmap[ID]component.Componentinstead ofmap[ID]component.Extension(#6553)pdata: Return error frompcommon.[Value|Map|Slice].FromRawwhen unsupported type. (#6579)batchprocessor: instrument thebatchprocessor with OpenTelemetry Go SDK (#6423)obsreport: Instrumentobsreport.Scrapermetrics with otel-go (#6460)service/collector: Support SIGHUP configuration reloading (#5966)component: Split component into its own package (#6187) The import path for the component module can now be access directly:go.opentelemetry.io/collector/component
consumer: Split consumer into its own package (#6186) The import path for the consumer module can now be accessed directly:go.opentelemetry.io/collector/consumer
featuregate: Split featuregate into its own package (#6526) The import path for the featuregate module can now be accessed directly:go.opentelemetry.io/collector/featuregate
🧰 Bug fixes 🧰
service: Disallow duplicate references to processors within a single pipeline (#6540)
v0.64.1
🧰 Bug fixes 🧰
loggingexporter: Fix logging exporter to not mutate the data (#6420)
0.64.0
🛑 Breaking changes 🛑
-
config: Remove already deprecatesconfig.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 deprecatesconfig.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.NewClientp[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/ballastextensiongo.opentelemetry.io/collector/extension/zpagesextension
If using one of these extensions, modify your Collector builder configuration to use
gomoddirectly, 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/batchprocessorgo.opentelemetry.io/collector/processor/memorylimiter
If using this processor, modify your Collector builder configuration to use
gomoddirectly, 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
gomoddirectly, such as:gomod: go.opentelemetry.io/collector/receiver/otlpreceiver v0.64.0
-
confmap: Remove unused public membersync.Mutexfromconfmap.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 inconfigpackage (#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: deprecateobsreport.New[Receiver|Scraper|Processor|Exporter]in favor ofobsreport.MustNew[Receiver|Scraper|Processor|Exporter](#6458) -
config/configgrpc: Provide better helpers for configgrpc, consistent with confighttp (#6441)- Deprecate
GRPCClientSettings.ToDialOptionsin favor ofGRPCClientSettings.ToClientConn. - Deprecate
GRPCServerSettings.ToServerOptionin favor ofGRPCServerSettings.ToServer.
- Deprecate
-
featuregates: Removing Gates being configurable externally to the Registry (#6167)- Deprecate
Gate.IDin favour ofRegistry.RegisterID - Deprecate
Gate.Enabledin favour ofGate.IsEnabled() - Deprecate
Gate.Descriptionin favour ofWithRegisterDescriptionto be used withRegistry.RegisterID - Deprecate
Registry.Registerin favour ofRegistry.RegisterID - Deprecate
Registry.MustRegisterin favour ofRegistry.MustRegisterID
- Deprecate
💡 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: Instrumentobsreport.Exportermetrics 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)
v0.63.1
🧰 Bug fixes 🧰
service: Fix running collector as a windows service. (#6433)
v0.63.0
🛑 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 deprecatedconfmap.Conf.UnmarshalExactAPI 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
- Remove deprecated
-
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/loggingexportergo.opentelemetry.io/collector/exporter/otlpexportergo.opentelemetry.io/collector/exporter/otlphttpexporter
If using these exporters, modify your Collector builder configuration to use
gomoddirectly, such as:gomod: go.opentelemetry.io/collector/exporter/otlpexporter v0.63.0
🚩 Deprecations 🚩
-
overwritepropertiesconverter: Deprecateoverwritepropertiesconverter, only used by non builder distributions. (#6294) -
pdata: AddExportprefix top[trace|metric|log]otlp.[Request|Response](#6365)- Deprecate
p[trace|metric|log]otlp.[Request|Response]in favor ofp[trace|metric|log]otlp.Export[Request|Response] - Deprecate
p[trace|metric|log]otlp.New[Request|Response]in favor ofp[trace|metric|log]otlp.NewExport[Request|Response] - Deprecate
p[trace|metric|log]otlp.NewRequestFrom[Traces|Metrics|Logs]in favor ofp[trace|metric|log]otlp.NewExportRequestFrom[Traces|Metrics|Logs]
- Deprecate
-
pdata: Deprecatep[trace|metric|log]otlp.NewClientin favor ofp[trace|metric|log]otlp.NewGRPCClient(#6350) -
exporter/logging: Deprecate 'loglevel' in favor of 'verbosity' option (#5878) -
pdata: DeprecateNew[JSON|Proto][Marshaler|Unmarshaler]in favor of exposing the underlying structs (#6340)
💡 Enhancements 💡
pdata: Introduce partial success fields in ExportResponse. (#5815, #5816, #6365)obsreport: Instrumentobsreport.Receivermetrics 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 sameprometheus.Registryfor 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)
v0.62.1 Beta
- Fix support for new line in config URI location. (#6306)
v0.62.0 Beta
🛑 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.Valuegetter/setter methods withValsuffix. (#6178) - Delete deprecated
StringValandSetStringValmethods. (#6178) - Delete deprecated
ValueTypeStringmethod. (#6178) - Change AggregationTemporality.String to simpler, easier to read. (#6117)
- Update
pcommon.ValueType.Stringoutput 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.RegisterServerin favor ofp[metric|log|trace]otlp.RegisterGRPCServer(#6182) - Deprecate
pcommon.Map.PutStringin favor ofpcommon.Map.PutStr(#6210) - Deprecate
pcommon.NewValueStringin favor ofpcommon.NewValueStr(#6209) - Deprecate
pmetric.MetricAggregationTemporalityenum type in favor ofpmetric.AggregationTemporality(#6253) - Deprecate
confmap.Conf.UnmarshalExactin favor ofconfmap.Conf.Unmarshal(.., WithErrorUnused)(#6231) - Deprecate
pmetric.[Default]?MetricDataPointFlagsfavor ofpmetric.[Default]?DataPointFlags(#6259) - Deprecate
ptrace.[New]?SpanStatusfavor ofptrace.[New]?Status(#6258) - Deprecate
pmetric.[New]?Bucketsin favor ofpmetric.[New]?ExponentialHistogramDataPointBuckets(#6261) - Deprecate
plog.SeverityNumberUndefinedin favor ofplog.SeverityNumberUnspecified(#6269) - Deprecate
pmetric.[New]?ValueAtQuantile[Slice]?in favor ofpmetric.[New]?SummaryDataPointValueAtQuantile[Slice]?(#6262) - Deprecate enum zero constants ending with
None(#6270)- Deprecate
pmetric.MetricTypeNonein favor ofpmetric.MetricTypeEmpty - Deprecate
pmetric.NumberDataPointValueTypeNonein favor ofpmetric.NumberDataPointValueTypeEmpty - Deprecate
pmetric.ExemplarValueTypeNonein favor ofpmetric.ExemplarValueTypeEmpty
- Deprecate
💡 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
telemetryInitializeris not cleaned up whennewServiceerrors (#6239)
v0.61.0 Beta
🛑 Breaking changes 🛑
- Change
ptrace.Span[Link]?.TraceStatesignature to matchptrace.Span[Link]?.TraceStateStruct(#6085) - Delete deprecated
pmetric.NewMetricDataPointFlagsImmutablefunc. (#6097) - Delete deprecated
pmetric.*DataPoint.[Set]FlagsImmutable()funcs. (#6097) - Delete deprecated
config.Unmarshalableinterface. (#6084) - Delete deprecated
p[metric|log|trace].MarshalerSizerinterfaces (#6083) - Delete deprecated
pcommon.Map.Insert*funcs. (#6088) - Delete deprecated
pcommon.Map.Upsert*funcs. (#6088) - Delete deprecated
pcommon.Map.Update*funcs. (#6088) - Change
pcommon.NewValueBytessignature to matchpcommon.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]FlagStructfuncs. (#6100) - Delete deprecated
pcommon.ImmutableByteSliceandpcommon.NewImmutableByteSlice. (#6107) - Delete deprecated
pcommon.ImmutableFloat64Sliceandpcommon.NewImmutableFloat64Slice. (#6107) - Delete deprecated
pcommon.ImmutableUInt64Sliceandpcommon.NewImmutableUInt64Slice. (#6107) - Delete deprecated
*DataPoint.SetBucketCountsand*DataPoint.SetExplicitBounds. (#6108)
🚩 Deprecations 🚩
- Deprecate
go.opentelemetry.io/collector/service/featuregatein favor ofgo.opentelemetry.io/collector/featuregate. (#6094) - Deprecate
pmetric.OptionalType, unused enum type. (#6096) - Deprecate
ptrace.Span[Link]?.TraceStateStructin favor ofptrace.Span[Link]?.TraceState(#6085) - Deprecate
pcommon.NewValueBytesEmptyin favor ofpcommon.NewValueBytesthat now has the same signature. (#6105) - Deprecate
pmetric.MetricDataTypeand related constants in favor ofpmetric.MetricType. (#6127) - Deprecate
pmetric.Metric.DataType()in favor ofpmetric.Metric.Type(). (#6127) - Deprecate
pmetric.NumberDataPoint.[Set]?[Int|Double]Val()in favor ofpmetric.NumberDataPoint.[Set]?[Int|Double]Value(). (#6134) - Deprecate
pmetric.Exemplar.[Set]?[Int|Double]Val()in favor ofpmetric.Exemplar.[Set]?[Int|Double]Value(). (#6134) - Deprecate
p[metric|log|trace]otlp.[Client|Server]in favor ofp[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.Cloneis deprecated in favor ofpmetric.Metrics.CopyToptrace.Traces.Cloneis deprecated in favor ofpmetric.Traces.CopyToplog.Logs.Cloneis deprecated in favor ofplogs.Logs.CopyTo
- Rename all
pcommon.Valuegetter/setter methods by removingValsuffix. (#6092)- Old methods with
Valsuffix are deprecated. StringValandSetStringValare deprecated in favor ofStrandSetStrto avoid implementingfmt.Stringerinterface.- Therefore,
ValueTypeStringis deprecated in favour ofValueTypeStrfor consistency.
- Old methods with
💡 Enhancements 💡
- Add AppendEmpty and EnsureCapacity method to primitive pdata slices (#6060)
- Expose
AsRawandFromRawpcommon.Valuemethods (#6090) - Convert
ValueTypeBytesattributes in logging exporter (#6153) - service.name Resource attribute is added to Collector's own telemetry, defaults to the value of
BuildInfo.Commandand can be overridden in the config (#6152) - Updated how
telemetryInitializeris created so it's instanced per Collector instance rather than global to the process (#6138)
v0.60.0 Beta
🛑 Breaking changes 🛑
- Replace deprecated
*DataPoint.Flags()with*DataPoint.[Set]FlagsImmutable(). (#6017) - Remove deprecated
MetricDataPointFlagsStructstruct andNewMetricDataPointFlagsStructfunc. (#6017) - Replace deprecated
MetricDataPointFlagswithMetricDataPointFlagsImmutable. (#6017) - Replace deprecated
LogRecord.[Set]Flags()withLogRecord.[Set]FlagsStruct(). (#6007) - Remove deprecated components helpers funcs (#6006)
exporterhelper.New[Traces|Metrics|Logs]ExporterWithContextprocessorhelper.New[Traces|Metrics|Logs]ProcessorWithCreateSettingscomponent.NewExtensionFactoryWithStabilityLevel
- Remove deprecated
pcommon.InvalidTraceIDandpcommon.InvalidSpanIDfuncs (#6008) - Remove deprecated
pcommon.Mapmethods:Update,Upsert,InsertNull(#6019)
🚩 Deprecations 🚩
- Deprecate pmetric.Metric.SetDataType, in favor of empty setters for each type. (#5979)
- Deprecate
p[metric|log|trace].MarshalerSizerin favor ofp[metric|log|trace].MarshalSizer. (#6033) - Deprecate
pcommon.Map.Update+in favor ofpcommon.Map.Get+pcommon.Value.Set+(#6013) - Deprecate
pcommon.Empty[Trace|Span]IDin favor ofpcommon.New[Trace|Span]IDEmpty(#6008) - Deprecate
pcommon.[Trace|Span]ID.Bytesin favor direct conversion. (#6008) - Deprecate
pcommon.New[Trace|Span]IDin favor direct conversion. (#6008) - Deprecate
MetricDataPointFlagsImmutabletype. (#6017) - Deprecate
*DataPoint.[Set]FlagsImmutable()funcs in favor of*DataPoint.[Set]Flags(). (#6017) - Deprecate
LogRecord.FlagsStruct()andLogRecord.SetFlagsStruct()in favor ofLogRecord.Flags()andLogRecord.SetFlags(). (#6007) - Deprecate
config.Unmarshallablein favor ofconfmap.Unmarshaler. (#6031) - Primitive slice wrapper are now mutable (#5971):
pcommon.ImmutableByteSliceis deprecated in favor ofpcommon.ByteSlicepcommon.ImmutableFloat64Sliceis deprecated in favor ofpcommon.Float64Slicepcommon.ImmutableUInt64Sliceis deprecated in favor ofpcommon.UInt64Slice- Temporarily deprecate
pcommon.NewValueBytesthat will be replaced withpcommon.NewValueBytesEmptyin 0.60.0 - Deprecate
pcommon.Map.UpsertBytesin favor ofpcommon.Map.PutEmptyBytes(#6064) - Deprecate
pcommon.Value.SetBytesValin favor ofpcommon.Value.SetEmptyBytesVal - Deprecate
pcommon.New[Slice|Map]FromRawfunctions in favor ofNew[Slice|Map]().FromRaw(#6045)
- Deprecate
pcommon.Map.Insert*methods (#6051) - Deprecate
pcommon.Map.Upsert*methods in favor ofpcommon.Map.Put*(#6064) - Deprecate
ptrace.TraceStatein favor ofpcommon.TraceState. (#6052)ptrace.Span.TraceStatein favor ofptrace.Span.TraceStateStruct().AsRaw()ptrace.Span.SetTraceStatein favor ofptrace.Span.TraceStateStruct().FromRawptrace.SpanLink.TraceStatein favor ofptrace.SpanLink.TraceStateStruct().AsRaw()ptrace.SpanLink.SetTraceStatein favor ofptrace.SpanLink.TraceStateStruct().FromRawTraceStateStructis a temporary name that will be replaced back toTraceStatein the next release.
💡 Enhancements 💡
- Add
skip-get-modulesbuilder flag to support isolated environment executions (#6009)- Skip unnecessary Go binary path validation when the builder is used with
skip-compilationandskip-get-modulesflags (#6026)
- Skip unnecessary Go binary path validation when the builder is used with
- 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
jsoniterin jsonUnmarshaler (#6021) - Instead of exiting,
ocbnow 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)
v0.59.0 Beta
🛑 Breaking changes 🛑
- Remove deprecated fields/funcs from
service(#5907)- Remove
ConfigProviderSettings.Location - Remove
ConfigProviderSettings.MapProviders - Remove
ConfigProviderSettings.MapConverters - Remove
featuregate.Registry.MustAppy
- Remove
- Remove deprecated funcs from
pdatamodule. (#5911)- Remove
pmetric.MetricDataPointFlags.String() - Remove
pmetric.NumberDataPoint.FlagsStruct() - Remove
pmetric.HistogramDataPoint.FlagsStruct() - Remove
pmetric.ExponentialHistogramDataPoint.FlagsStruct() - Remove
pmetric.SummaryDataPoint.FlagsStruct()
- Remove
- Remove deprecated settings from
obsreport,ProcessorSettings.LevelandExporterSettings.Level(#5918) - Replace
processorhelper.New[Traces|Metrics|Logs]Exporterwithprocessorhelper.New[Traces|Metrics|Logs]ProcessorWithCreateSettingsdefinition (#5915) - Replace
exporterhelper.New[Traces|Metrics|Logs]Exporterwithexporterhelper.New[Traces|Metrics|Logs]ExporterWithContextdefinition (#5914) - Replace
component.NewExtensionFactorywithcomponent.NewExtensionFactoryWithStabilityLeveldefinition (#5917) - Set TLS 1.2 as default for
min_versionfor TLS configuration in case this property is not defined (affects servers). (#5956)
🚩 Deprecations 🚩
- Deprecate
processorhelper.New[Traces|Metrics|Logs]ProcessorWithCreateSettingsin favor ofprocessorhelper.New[Traces|Metrics|Logs]Exporter(#5915) - Deprecates
LogRecord.Flags()andLogRecord.SetFlags()in favor ofLogRecord.FlagsStruct()andLogRecord.SetFlagsStruct(). (#5972) - Deprecate
exporterhelper.New[Traces|Metrics|Logs]ExporterWithContextin favor ofexporterhelper.New[Traces|Metrics|Logs]Exporter(#5914) - Deprecate
component.NewExtensionFactoryWithStabilityLevelin favor ofcomponent.NewExtensionFactory(#5917) - Deprecate
plog.SeverityNumber[UPPERCASE]constants (#5927) - Deprecate
pcommon.Map.InsertNullmethod (#5955) - Deprecate FlagsStruct types (#5933):
MetricDataPointFlagsStruct->MetricDataPointFlagsNewMetricDataPointFlagsStruct->NewMetricDataPointFlags
- Deprecate builder distribution flags, use configuration. (#5946)
- Enforce naming conventions for Invalid[Trace|Span]ID: (#5969)
- Deprecate funcs
pcommon.InvalidTraceIDandpcommon.InvalidSpanIDin favor of varspcommon.EmptyTraceIDandpcommon.EmptySpanID
- Deprecate funcs
- Deprecate
UpdateandUpsertmethods ofpcommon.Map(#5975) - Deprecated the current MetricDataPointFlags API. The new API provides functions to check and set Flags. (#5999)
NumberDataPoint.Flags->NumberDataPoint.FlagsImmutableHistogramDataPoint.Flags->HistogramDataPoint.FlagsImmutableExponentialHistogramDataPoint.Flags->ExponentialHistogramDataPoint.FlagsImmutableSummaryDataPoint.Flags->SummaryDataPoint.FlagsImmutableMetricDataPointFlags->MetricDataPointFlagsImmutableNewMetricDataPointFlags->MetricDataPointFlagsImmutable
💡 Enhancements 💡
- Added
MarshalerSizerinterface toptrace,plog, andpmetricpackages.NewProtoMarshalernow returns aMarshalerSizer(#5929) - Add support to unmarshalls bytes into pmetric.Metrics with
jsoniterin jsonUnmarshaler(#5433) - Add httpprovider to allow loading config files stored in HTTP (#5810)
- Added
service.telemetry.traces.propagatorsconfiguration to set propagators for collector's internal spans. (#5572) - Remove unnecessary duplicate code and allocations for reading enums in JSON. (#5928)
- Add "dist.build_tags" configuration option to support passing go build flags to builder. (#5659)
- Add an AsRaw func on the flags, lots of places to encode these flags. (#5934)
- Change pdata generated types to use type definition instead of aliases. (#5936)
- Improves documentation, and makes code easier to read/understand.
- Log
InstrumentationScopeattributes inloggingexporter(#5976) - Add
UpsertEmpty,UpsertEmptyMapandUpsertEmptySlicemethods topcommon.Map(#5975) - Add
SetEmptyMapValandSetEmptySliceValmethods topcommon.Value(#5975)
🧰 Bug fixes 🧰
- Fix reading scope attributes for trace JSON, remove duplicate code. (#5930)
- otlpjson/trace: skip unknown fields instead of error. (#5931)
- Fix bug in setting the correct collector state after a configuration change event. (#5830)
- Fix json trace unmarshalling for numbers (#5924):
- Accept both string and number for float64.
- Accept both string and number for int32/uint32.
- Read uint64 numbers without converting from int64.
- Fix persistent storage client not closing when shutting down (#6003)
v0.58.0 Beta
🛑 Breaking changes 🛑
- Remove the InstrumentationLibrary to Scope translation (part of transition to OTLP 0.19). (#5819)
- This has a side effect that when sending JSON encoded telemetry using OTLP proto <= 0.15.0, telemetry will be dropped.
- Require the storage to be explicitly set for the (experimental) persistent queue (#5784)
- Remove deprecated
confighttp.HTTPClientSettings.ToClientWithHost(#5803) - Remove deprecated component stability helpers (#5802):
component.WithTracesExporterAndStabilityLevelcomponent.WithMetricsExporterAndStabilityLevelcomponent.WithLogsExporterAndStabilityLevelcomponent.WithTracesReceiverAndStabilityLevelcomponent.WithMetricsReceiverAndStabilityLevelcomponent.WithLogsReceiverAndStabilityLevelcomponent.WithTracesProcessorAndStabilityLevelcomponent.WithMetricsProcessorAndStabilityLevelcomponent.WithLogsProcessorAndStabilityLevel
- ABI breaking change:
featuregate.Registry.Applyreturns error now. - Update minimum go version to 1.18 (#5795)
- Remove deprecated
FlagsAPI from pdata (#5814) - Change
confmap.Providerto return pointer toRetrieved(#5839)
🚩 Deprecations 🚩
- Deprecate duplicate settings in service.ConfigProvider, embed ResolverSettings (#5843)
- Deprecate
featuregate.Registry.MustApplyin favor offeaturegate.Registry.Apply. (#5801) - Deprecate the
component.Factory.StabilityLevel(config.DataType)in favor of Stability per component (#5762):component.ExporterFactory.TracesExporterStabilitycomponent.ExporterFactory.MetricsExporterStabilitycomponent.ExporterFactory.LogsExporterStabilitycomponent.ProcessorFactory.TracesProcessorStabilitycomponent.ProcessorFactory.MetricsProcessorStabilitycomponent.ProcessorFactory.LogsProcessorStabilitycomponent.ReceiverFactory.TracesReceiverStabilitycomponent.ReceiverFactory.MetricsReceiverStabilitycomponent.ReceiverFactory.LogsReceiverStability
- Deprecate
obsreport.ProcessorSettings.Levelandobsreport.ExporterSettings.Level, use MetricsLevel from CreateSettings (#5824) - Deprecate
processorhelper.New[Traces|Metrics|Logs]Processorin favor ofprocessorhelper.New[Traces|Metrics|Logs]ProcessorWithCreateSettings(#5833) - Deprecate MetricDataPointFlags.String(), no other pdata flags have this method (#5868)
- Deprecates
FlagsStructin favor ofFlags(#5842)FlagsStruct->Flags
- Deprecate
exporterhelper.New[Traces|Metrics|Logs]Exporterin favor ofexporterhelper.New[Traces|Metrics|Logs]ExporterWithContext(#5834)
💡 Enhancements 💡
- Enable persistent queue in the build by default (#5828)
- Bump to opentelemetry-proto v0.19.0. (#5823)
- Expose
Scope.Attributesin pdata (#5826) - Remove unnecessary limitation on
pcommon.Value.Equalthat slices have only primitive values. (#5865) - Add support to handle 404, 405 http error code as permanent errors in OTLP exporter (#5827)
- Enforce scheme name restrictions to all
confmap.Providerimplementations. (#5861)
v0.57.2 Beta
See the changelog for v0.57.0.
v0.57.1 Beta
This was a failed release.
v0.57.0 Beta
There isn't a valid core binary for this release. Use v0.57.2 instead.
🛑 Breaking changes 🛑
- Remove deprecated funcs/types from service related to
Config(#5755) - Change
confighttp.ToClientto accept acomponent.Host(#5737) - Remove deprecated funcs from pdata related to mutable slices (#5754)
- Change the following deprecated component functions to ensure a stability level is set:
component.WithTracesExportercomponent.WithMetricsExportercomponent.WithLogsExportercomponent.WithTracesReceivercomponent.WithMetricsReceivercomponent.WithLogsReceivercomponent.WithTracesProcessorcomponent.WithMetricsProcessorcomponent.WithLogsProcessor
🚩 Deprecations 🚩
- Deprecated the current Flag API. The new API provides functions to check and set Flags (#5790) (#5602):
NumberDataPoint.Flags->NumberDataPoint.FlagsStructNumberDataPoint.SetFlags->NumberDataPoint.FlagsStructHistogramDataPoint.Flags->HistogramDataPoint.FlagsStructHistogramDataPoint.SetFlags->HistogramDataPoint.FlagsStructExponentialHistogramDataPoint.Flags->ExponentialHistogramDataPoint.FlagsStructExponentialHistogramDataPoint.SetFlags->ExponentialHistogramDataPoint.FlagsStructSummaryDataPoint.Flags->SummaryDataPoint.FlagsStructSummaryDataPoint.SetFlags->SummaryDataPoint.FlagsStructMetricDataPointFlags->MetricDataPointFlagsStructNewMetricDataPointFlags->NewMetricDataPointFlagsStructMetricDataPointFlagsNone->MetricDataPointFlagsStruct.NoRecordedValueMetricDataPointFlagNoRecordedValue->MetricDataPointFlagsStruct.NoRecordedValueMetricDataPointFlag
- Deprecate the following component functions added to ensure a stability level is set:
component.WithTracesExporterAndStabilityLevel->component.WithTracesExportercomponent.WithMetricsExporterAndStabilityLevel->component.WithMetricsExportercomponent.WithLogsExporterAndStabilityLevel->component.WithLogsExportercomponent.WithTracesReceiverAndStabilityLevel->component.WithTracesReceivercomponent.WithMetricsReceiverAndStabilityLevel->component.WithMetricsReceivercomponent.WithLogsReceiverAndStabilityLevel->component.WithLogsReceivercomponent.WithTracesProcessorAndStabilityLevel->component.WithTracesProcessorcomponent.WithMetricsProcessorAndStabilityLevel->component.WithMetricsProcessorcomponent.WithLogsProcessorAndStabilityLevel->component.WithLogsProcessor
💡 Enhancements 💡
- Make the in-memory and persistent queues more consistent (#5764)
ocbnow exits with an error if it fails to load the build configuration. (#5731)- Deprecate
HTTPClientSettings.ToClientWithHost(#5737)
🧰 Bug fixes 🧰
- Fix bug in ocb where flags did not take precedence. (#5726)
v0.56.0 Beta
💡 Enhancements 💡
- Add
linux-ppc64learchitecture to cross build tests in CI (#5645) client: perform case insensitive lookups in case the requested metadata value isn't found (#5646)loggingexporter: Decoupleloglevelfield from level of logged messages (#5678)- Expose
pcommon.NewSliceFromRawfunction (#5679) loggingexporter: create the exporter's logger from the service's logger (#5677)- Add
otelcol_exporter_queue_capacitymetrics show the collector's exporter queue capacity (#5475) - Add support to handle 402, 413, 414, 431 http error code as permanent errors in OTLP exporter (#5685)
🧰 Bug fixes 🧰
- Fix Collector panic when disabling telemetry metrics (#5642)
- Fix Collector panic when featuregate value is empty (#5663)
- Fix confighttp.compression panic due to nil request.Body. (#5628)
v0.55.0 Beta
🛑 Breaking changes 🛑
- Remove deprecated
config.ServiceTelemetry(#5565) - Remove deprecated
config.ServiceTelemetryLogs(#5565) - Remove deprecated
config.ServiceTelemetryMetrics(#5565)
🚩 Deprecations 🚩
- Deprecate
service.ConfigServiceTelemetry,service.ConfigServiceTelemetryLogs, andservice.ConfigServiceTelemetryMetrics(#5565) - Deprecate the following component functions to ensure a stability level is set (#5580):
component.WithTracesExporter->component.WithTracesExporterAndStabilityLevelcomponent.WithMetricsExporter->component.WithMetricsExporterAndStabilityLevelcomponent.WithLogsExporter->component.WithLogsExporterAndStabilityLevelcomponent.WithTracesReceiver->component.WithTracesReceiverAndStabilityLevelcomponent.WithMetricsReceiver->component.WithMetricsReceiverAndStabilityLevelcomponent.WithLogsReceiver->component.WithLogsReceiverAndStabilityLevelcomponent.WithTracesProcessor->component.WithTracesProcessorAndStabilityLevelcomponent.WithMetricsProcessor->component.WithMetricsProcessorAndStabilityLevelcomponent.WithLogsProcessor->component.WithLogsProcessorAndStabilityLevel
- Deprecate
Registry.Applyinservice.featuregate(#5660)
💡 Enhancements 💡
- Components stability levels are now logged. By default components which haven't defined their stability levels, or which are unmaintained, deprecated or in development will log a message. (#5580)
exporter/logging: Skip "bad file descriptor" sync errors (#5585)
🧰 Bug fixes 🧰
- Fix initialization of the OpenTelemetry MetricProvider. (#5571)
- Set log level for
undefinedstability level to debug. (#5635)
v0.54.0 Beta
🛑 Breaking changes 🛑
- Remove deprecated
GetLogger. (#5504) - Remove deprecated
configtest.LoadConfigMap(#5505) - Remove deprecated
config.Map(#5505) - Remove deprecated
config.MapProvider(#5505) - Remove deprecated
config.MapConverter(#5505) - Remove deprecated
config.Received(#5505) - Remove deprecated
config.CloseFunc(#5505) - Deprecated
pcommon.Value.NewValueBytesis brought back takingpcommon.ImmutableByteSliceas an argument instead of[]byte(#5299)
🚩 Deprecations 🚩
- Use immutable slices for primitive types slices to restrict mutations. (#5299)
Value.NewValueMBytesfunc is deprecated in favor ofValue.NewValueBytesfunc that takesImmutableByteSliceinstead of[]byteValue.SetMBytesValfunc is deprecated in favor ofValue.SetBytesValfunc that takespcommon.ImmutableByteSliceinstead of []byte.Value.BytesValfunc is deprecated in favor ofValue.BytesValfunc that returnspcommon.ImmutableByteSliceinstead of []byte.<HistogramDataPoint|Buckets>.SetMBucketCountsfuncs are deprecated in favor of<HistogramDataPoint|Buckets>.SetBucketCountsfuncs that takepcommon.ImmutableUInt64Sliceinstead of []uint64.<HistogramDataPoint|Buckets>.MBucketCountsfuncs are deprecated in favor of<HistogramDataPoint|Buckets>.BucketCountsfuncs that returnpcommon.ImmutableUInt64Sliceinstead of []uint64.HistogramDataPoint.SetMExplicitBoundsfunc is deprecated in favor ofHistogramDataPoint.SetExplicitBoundsfunc that takespcommon.ImmutableFloat64Sliceinstead of []float64.HistogramDataPoint.MExplicitBoundsfunc func is deprecated in favor ofHistogramDataPoint.ExplicitBoundsreturnspcommon.ImmutableFloat64Sliceinstead of []float64.
💡 Enhancements 💡
- Deprecate
HTTPClientSettings.ToClientin favor ofHTTPClientSettings.ToClientWithHost(#5584) - Use OpenCensus
metricpackage for process metrics instead ofstatspackage (#5486) - Update OTLP to v0.18.0 (#5530)
- Log histogram min/max fields with
loggingexporter (#5520)
🧰 Bug fixes 🧰
- Update sum field of exponential histograms to make it optional (#5530)
- Remove redundant extension shutdown call (#5532)
- Refactor pipelines builder, fix some issues (#5512)
- Unconfigured receivers are not identified, this was not a real problem in final binaries since the validation of the config catch this.
- Allow configurations to contain "unused" receivers. Receivers that are configured but not used in any pipeline, this was possible already for exporters and processors.
- Remove the enforcement/check that Receiver factories create the same instance for the same config.
v0.53.0 Beta
🛑 Breaking changes 🛑
- Remove deprecated
componenterrorpackage. (#5420) - Remove deprecated
config.MapConverterFunc. (#5419) - Remove
AddCollectorVersionTag, enabled for long time already. (#5471)
🚩 Deprecations 🚩
- Move
config.Mapto its own packageconfmapwhich does not depend on any component concept (#5237)config.Map->confmap.ConfMapconfig.MapProvider->confmap.Providerconfig.Received->confmap.Receivedconfig.NewReceivedFromMap->confmap.NewReceivedconfig.CloseFunc->confmap.CloseFuncconfig.ChangeEvent->confmap.ChangeEventconfig.MapConverter->confmap.Converter- Package
envmapprovider->envprovider - Package
filemapprovider->fileprovider - Package
yamlmapprovider->yamlprovider - Package
expandmapconverter->expandconverter - Package
filemapprovider->fileprovider - Package
overwritepropertiesmapconverter->overwritepropertiesconverter
- Deprecate
component.ExtensionDefaultConfigFuncin favor ofcomponent.ExtensionCreateDefaultConfigFunc(#5451) - Deprecate
confmap.Received.AsMapin favor ofconfmap.Received.AsConf(#5465) - Deprecate
confmap.Conf.Set, not used anywhere for the moment (#5485)
💡 Enhancements 💡
- Move
service.mapResolvertoconfmap.Resolver(#5444) - Add
linux-armarchitecture to cross build tests in CI (#5472)
🧰 Bug fixes 🧰
- Fixes the "service.version" label value for internal metrics, always was "latest" in core/contrib distros. (#5449).
- Send correct batch stats when SendBatchMaxSize is set (#5385)
- TLS
MinVersionandMaxVersiondefaults will be handled bycrypto/tls(#5480)
v0.52.0 Beta
🛑 Breaking changes 🛑
- Remove
configunmarshaler.Unmarshalerinterface, per deprecation comment (#5348) - Remove deprecated pdata funcs/structs from v0.50.0 (#5345)
- Remove deprecated pdata getters and setters of primitive slice values:
Value.BytesVal,Value.SetBytesVal,Value.UpdateBytes,Value.InsertBytes,Value.UpsertBytes,<HistogramDataPoint|Buckets>.BucketCounts,<HistogramDataPoint|Buckets>.SetBucketCounts,HistogramDataPoint.ExplicitBounds,HistogramDataPoint.SetExplicitBounds(#5347) - Remove deprecated featuregate funcs/structs from v0.50.0 (#5346)
- Remove access to deprecated members of the config.Retrieved struct (#5363)
- Replace usage of
config.MapConverterFuncwithconfig.MapConverter(#5382)
🚩 Deprecations 🚩
- Deprecate
config.Configandconfig.Service, useservice.Config*(#4608) - Deprecate
componenterrorpackage, move everything tocomponent(#5383) pcommon.Value.NewValueBytesis deprecated in favor ofValue.NewValueMBytesin preparation of migration to immutable slices (#5367)
💡 Enhancements 💡
- Update OTLP to v0.17.0 (#5335)
- Add optional min/max fields to histograms (#5399)
- User-defined Resource attributes can be specified under
service.telemetry.resourceconfiguration key and will be included as metric labels for own telemetry. Ifservice.instance.idis not specified it will be auto-generated. Previouslyservice.instance.idwas always auto-generated, so the default of the new behavior matches the old behavior. (#5402)
v0.51.0 Beta
🛑 Breaking changes 🛑
- Remove deprecated model module, everything is available in
pdataandsemconv. (#5281)- Old versions of the module are still available, but no new versions will be released.
- Remove deprecated LogRecord.Name field. (#5202)
🚩 Deprecations 🚩
- In preparation of migration to immutable slices for primitive type items, the following methods are renamed (#5344)
Value.BytesValfunc is deprecated in favor ofValue.MBytesVal.Value.SetBytesValfunc is deprecated in favor ofValue.SetMBytesVal.Value.UpdateBytesfunc is deprecated in favor ofValue.UpdateMBytes.Value.InsertBytesfunc is deprecated in favor ofValue.InsertMBytes.Value.UpsertBytesfunc is deprecated in favor ofValue.UpsertMBytes.<HistogramDataPoint|Buckets>.BucketCountsfuncs are deprecated in favor of<HistogramDataPoint|Buckets>.MBucketCounts.<HistogramDataPoint|Buckets>.SetBucketCountsfuncs are deprecated in favor of<HistogramDataPoint|Buckets>.SetMBucketCounts.HistogramDataPoint.ExplicitBoundsfunc is deprecated in favor ofHistogramDataPoint.MExplicitBounds.HistogramDataPoint.SetExplicitBoundsfunc is deprecated in favor ofHistogramDataPoint.SetMExplicitBounds.
💡 Enhancements 💡
pdata: Exposepcommon.NewSliceFromRawandpcommon.Slice.AsRawfunctions (#5311)
🧰 Bug fixes 🧰
- Fix Windows Event Logs ignoring user-specified logging options (#5298)
v0.50.0 Beta
🛑 Breaking changes 🛑
- Remove pdata deprecated funcs from 2 versions (v0.48.0) ago. (#5219)
- Remove non pdata deprecated funcs/structs (#5220)
pmetric.Exemplar.ValueType()now returns new typeExemplarValueType(#5233)- Remove deprecated
Deletepdata func in favor ofpdata.Removefrom (v0.47.0). (#5307)
🚩 Deprecations 🚩
- Deprecate
configunmarshalerpackage, move it to internal (#5151) - Deprecate all API in
model/semconv. The package is moved to a newsemconvmodule (#5196) - Deprecate access to
config.Retrievedfields, use the newly added funcs to interact with the internal fields (#5198) - Deprecate
p<signal>otlp.Request.Set<Logs|Metrics|Traces>(#5234)plogotlp.Request.SetLogsfunc is deprecated in favor ofplogotlp.NewRequestFromLogspmetricotlp.Request.SetMetricsfunc is deprecated in favor ofpmetricotlp.NewRequestFromMetricsptraceotlp.Request.SetTracesfunc is deprecated in favor ofptraceotlp.NewRequestFromTraces
pmetric.NumberDataPoint.ValueType()now returns new typeNumberDataPointValueType(#5233)pmetric.MetricValueTypeis deprecated in favor ofNumberDataPointValueTypepmetric.MetricValueTypeNoneis deprecated in favor ofNumberDataPointValueTypeNonepmetric.MetricValueTypeIntis deprecated in favor ofNumberDataPointValueTypeIntpmetric.MetricValueTypeDoubleis deprecated in favor ofNumberDataPointValueTypeDouble
- Deprecate
plog.LogRecord.SetName()function (#5230) - Deprecate global
featuregatefuncs in favor ofGetRegistryand a publicRegistrytype (#5160)
💡 Enhancements 💡
-
Add
jsoniterUnmarshaller (#4817) -
Extend config.Map.Unmarshal hook to check map key string to any TextUnmarshaler not only ComponentID (#5244)
-
Collector will no longer print error with stack trace when the collector is shutdown due to a context cancel. (#5258)
🧰 Bug fixes 🧰
- Fix translation from otlp.Request to pdata representation, changes to the returned pdata not all reflected to the otlp.Request (#5197)
exporterhelpernow properly consumes any remaining items on stop (#5203)pdata: Fix copying ofValuewithValueTypeBytestype (#5267)pdata: Fix copying of metric fields of primitive items slice type (#5271)
v0.49.0 Beta
🛑 Breaking changes 🛑
- Remove deprecated structs/funcs from previous versions (#5131)
- Do not set TraceProvider to global otel (#5138)
- Remove deprecated funcs from otlpgrpc (#5144)
- Add Scheme to MapProvider interface (#5068)
- Do not set MeterProvider to global otel (#5146)
- Make
InstrumentationLibrary<signal>ToScopehelper functions unexported (#5164) - Remove Log's "ShortName" from logging exporter output (#5172)
exporter/otlp: Retry RESOURCE_EXHAUSTED only if the server returns RetryInfo (#5147)
🚩 Deprecations 🚩
- All pdata related APIs from model (model/pdata, model/otlp and model/otlpgrpc) are deprecated in
favor of packages in the new pdata module separated by telemetry signal type (#5168)
model/pdata,model/otlp->pdata/pcommon,pdata/plog,pdata/pmetric,pdata/ptracemodel/otlpgrpc->pdata/plog/plogotlp,pdata/pmetric/pmetricotlp,pdata/ptrace/ptraceotlp
- Deprecate configmapprovider package, replace with mapconverter (#5167)
- Deprecate
service.MustNewConfigProviderandservice.MustNewDefaultConfigProviderin favor ofservice.NewConfigProvider(#4936)
💡 Enhancements 💡
- OTLP HTTP receiver will use HTTP/2 over TLS if client supports it (#5109)
- Add
ObservedTimestampfield topdata.LogRecord(#5171)
🧰 Bug fixes 🧰
- Setup the correct meter provider if telemetry.useOtelForInternalMetrics featuregate enabled (#5146)
- Fix pdata.Value.asRaw() to correctly return elements of Slice and Map type (#5153)
- Update pdata.Slice.asRaw() to return raw representation of Slice and Map elements (#5157)
- The codepath through the OTLP receiver for gRPC was not translating the InstrumentationLibrary* to Scope* (#5189)
v0.48.0 Beta
🛑 Breaking changes 🛑
- Remove deprecated
consumerhelperpackage (#5028) - Remove pdata
InternalRepdeprecated funcs (#5018) - Remove service/defaultcomponents deprecated package (#5019)
- Remove deprecated UseOpenTelemetryForInternalMetrics (#5026)
- Change outcome of
pdata.Value.MapVal()andpdata.Value.SliceVal()functions misuse. In case of type mismatch, they now return an invalid zero-initialized instance instead of a detached collection (#5034) - OTLP JSON field changes following upgrade to OTLP v0.15.0:
- "instrumentationLibraryLogs" is now "scopeLogs"
- "instrumentationLibraryMetrics" is now "scopeMetrics"
- "instrumentationLibrarySpans" is now "scopeSpans"
- "instrumentationLibrary" is now "scope"
- AsString for pdata.Value now returns the JSON-encoded string of floats. (#4934)
🚩 Deprecations 🚩
- Move MapProvider to config, split providers in their own package (#5030)
- API related to
pdata.AttributeValueis deprecated in favor ofpdata.Value(#4978)pdata.AttributeValuestruct is deprecated in favor ofpdata.Valuepdata.AttributeValueTypetype is deprecated in favor ofpdata.ValueTypepdata.AttributeValueType...constants are deprecated in favor ofpdata.ValueType...pdata.NewAttributeValue...funcs are deprecated in favor ofpdata.NewValue...
- Deprecate featureflags.FlagValue.SetSlice, unnecessary public (#5053)
- Remove "Attribute" part from common pdata collections names (#5001)
- Deprecate
pdata.AttributeMapstruct in favor ofpdata.Map - Deprecate
pdata.NewAttributeMapfunc in favor ofpdata.NewMap - Deprecate
pdata.NewAttributeMapFromMapfunc in favor ofpdata.NewMapFromRaw - Deprecate
pdata.AttributeValueSlicestruct in favor ofpdata.Slice - Deprecate
pdata.NewAttributeValueSlicefunc in favor ofpdata.NewSlice
- Deprecate
- Deprecate LogRecord.Name(), it was deprecated in the data model (#5054)
- Rename
Arraytype ofpdata.ValuetoSlice(#5066)- Deprecate
pdata.AttributeValueTypeArraytype in favor ofpdata.ValueTypeSlice - Deprecate
pdata.NewAttributeValueArrayfunc in favor ofpdata.NewValueSlice
- Deprecate
- Deprecate global flag in
featuregates(#5060) - Deprecate last funcs/structs in componenthelper (#5069)
- Change structs in otlpgrpc to follow standard go encoding interfaces (#5062)
- Deprecate
UnmarshalJSON[Traces|Metrics|Logs][Request|Response]in favor ofUnmarshalJSON. - Deprecate
[Traces|Metrics|Logs][Request|Response].Marshalin favor ofMarshalProto. - Deprecate
UnmarshalJSON[Traces|Metrics|Logs][Request|Response]in favor ofUnmarshalProto.
- Deprecate
- Deprecating following pdata methods/types following OTLP v0.15.0 upgrade (#5076): - InstrumentationLibrary is now InstrumentationScope - NewInstrumentationLibrary is now NewInstrumentationScope - InstrumentationLibraryLogsSlice is now ScopeLogsSlice - NewInstrumentationLibraryLogsSlice is now NewScopeLogsSlice - InstrumentationLibraryLogs is now ScopeLogs - NewInstrumentationLibraryLogs is now NewScopeLogs - InstrumentationLibraryMetricsSlice is now ScopeMetricsSlice - NewInstrumentationLibraryMetricsSlice is now NewScopeMetricsSlice - InstrumentationLibraryMetrics is now ScopeMetrics - NewInstrumentationLibraryMetrics is now NewScopeMetrics - InstrumentationLibrarySpansSlice is now ScopeSpansSlice - NewInstrumentationLibrarySpansSlice is now NewScopeSpansSlice - InstrumentationLibrarySpans is now ScopeSpans - NewInstrumentationLibrarySpans is now NewScopeSpans
💡 Enhancements 💡
- Add semconv definitions for v1.9.0 (#5090)
- Change outcome of
pdata.Metric.<Gauge|Sum|Histogram|ExponentialHistogram>()functions misuse. In case of type mismatch, they don't panic right away but return an invalid zero-initialized instance for consistency with other OneOf field accessors (#5035) - Update OTLP to v0.15.0 (#5064)
- Adding support for transition from older versions of OTLP to OTLP v0.15.0 (#5085)
🧰 Bug fixes 🧰
- Add missing files for semconv definitions v1.7.0 and v1.8.0 (#5091)
- The
featuregateswere not configured from the "--feature-gates" flag on windows service (#5060) - Fix Semantic Convention Schema URL definition for 1.5.0 and 1.6.1 versions (#5103)
v0.47.0 Beta
🛑 Breaking changes 🛑
- Remove
Typefuncs in pdata (#4933) - Remove all deprecated funcs/structs from v0.46.0 (#4995)
🚩 Deprecations 🚩
- pdata: deprecate funcs working with InternalRep (#4957)
- Deprecate
pdata.AttributeMap.Deletein favor ofpdata.AttributeMap.Remove(#4914) - Deprecate consumerhelper, move helpers to consumer (#5006)
💡 Enhancements 💡
- Add
pdata.AttributeMap.RemoveIf, which is a more performant way to remove multiple keys (#4914) - Add
pipelinekey with pipeline identifier to processor loggers (#4968) - Add a new yaml provider, allows providing yaml bytes (#4998)
🧰 Bug fixes 🧰
- Collector
Runwill now exit when a context cancels (#4954) - Add missing droppedAttributesCount to pdata generated resource (#4979)
- Collector
Runwill now set state toClosedif startup fails (#4974)
v0.46.0 Beta
🛑 Breaking changes 🛑
- Change otel collector to enable open telemetry metrics through feature gate instead of a constant (#4912)
- Remove support for legacy otlp/http port. (#4916)
- Remove deprecated funcs in pdata (#4809)
- Remove deprecated Retrieve funcs/calls (#4922)
- Remove deprecated NewConfigProvider funcs (#4937)
🚩 Deprecations 🚩
- Deprecated funcs
config.DefaultConfig,confighttp.DefaultHTTPSettings,exporterhelper.DefaultTimeoutSettings,exporthelper.DefaultQueueSettings,exporterhelper.DefaultRetrySettings,testcomponents.DefaultFactories, andscraperhelper.DefaultScraperControllerSettingsin favour for theirNewDefaultmethod to adhere to contribution guidelines (#4865) - Deprecated funcs
componenthelper.StartFunc,componenthelper.ShutdownFuncin favour ofcomponent.StartFuncandcomponent.ShutdownFunc(#4803) - Move helpers from extensionhelper to component (#4805)
- Deprecated
extensionhelper.CreateDefaultConfigin favour ofcomponent.ExtensionDefaultConfigFunc - Deprecated
extensionhelper.CreateServiceExtensionin favour ofcomponent.CreateExtensionFunc - Deprecated
extensionhelper.NewFactoryin favour ofcomponent.NewExtensionFactory
- Deprecated
- Move helpers from processorhelper to component (#4889)
- Deprecated
processorhelper.CreateDefaultConfigin favour ofcomponent.ProcessorDefaultConfigFunc - Deprecated
processorhelper.WithTracesin favour ofcomponent.WithTracesProcessor - Deprecated
processorhelper.WithMetricsin favour ofcomponent.WithMetricsProcessor - Deprecated
processorhelper.WithLogsin favour ofcomponent.WithLogsProcessor - Deprecated
processorhelper.NewFactoryin favour ofcomponent.NewProcessorFactory
- Deprecated
- Move helpers from exporterhelper to component (#4899)
- Deprecated
exporterhelper.CreateDefaultConfigin favour ofcomponent.ExporterDefaultConfigFunc - Deprecated
exporterhelper.WithTracesin favour ofcomponent.WithTracesExporter - Deprecated
exporterhelper.WithMetricsin favour ofcomponent.WithMetricsExporter - Deprecated
exporterhelper.WithLogsin favour ofcomponent.WithLogsExporter - Deprecated
exporterhelper.NewFactoryin favour ofcomponent.NewExporterFactory
- Deprecated
- Move helpers from receiverhelper to component (#4891)
- Deprecated
receiverhelper.CreateDefaultConfigin favour ofcomponent.ReceiverDefaultConfigFunc - Deprecated
receiverhelper.WithTracesin favour ofcomponent.WithTracesReceiver - Deprecated
receiverhelper.WithMetricsin favour ofcomponent.WithMetricsReceiver - Deprecated
receiverhelper.WithLogsin favour ofcomponent.WithLogsReceiver - Deprecated
receiverhelper.NewFactoryin favour ofcomponent.NewReceiverFactory
- Deprecated
💡 Enhancements 💡
- Add validation to check at least one endpoint is specified in otlphttpexporter's configuration (#4860)
- Implement default client authenticators (#4837)
🧰 Bug fixes 🧰
- Initialized logger with collector to avoid potential race condition panic on
Shutdown(#4827) - In addition to traces, now logs and metrics processors will start the memory limiter.
Added thread-safe logic so only the first processor can launch the
checkMemLimitsgo-routine and the last processor that calls shutdown to terminate it; this is done per memory limiter instance. Added memory limiter factory to cache initiated object and be reused by similar config. This guarantees a single runningcheckMemLimitsper config (#4886) - Resolved race condition in collector when calling
Shutdown(#4878)
v0.45.0 Beta
🛑 Breaking changes 🛑
- Remove deprecated funcs in configtelemetry (#4808)
otlphttpandotlpexporters enable gzip compression by default (#4632)
🚩 Deprecations 🚩
- Deprecate
service/defaultcomponentsgo package (#4622) - Deprecate
pdata.NumberDataPoint.Type()andpdata.Exemplar.Type()in favor ofNumberDataPoint.ValueType()andExemplar.ValueType()(#4850)
💡 Enhancements 💡
- Reject invalid queue size exporterhelper (#4799)
- Transform configmapprovider.Retrieved interface to a struct (#4789)
- Added feature gate summary to zpages extension (#4834)
- Add support for reloading TLS certificates (#4737)
🧰 Bug fixes 🧰
confighttp: Allow CORS requests with configured auth (#4869)
v0.44.0 Beta
🛑 Breaking changes 🛑
- Updated to OTLP 0.12.0. Deprecated traces and metrics messages that existed in 0.11.0 are no longer converted to the messages and fields that replaced the deprecated ones. Received deprecated messages and fields will be now ignored. In OTLP/JSON in the instrumentationLibraryLogs object the "logs" field is now named "logRecords" (#4724)
- Deprecate
service.NewWindowsService, addservice.NewSvcHandler(#4783).
🚩 Deprecations 🚩
- Deprecate
service.NewConfigProvider, and a new versionservice.MustNewConfigProvider(#4734).
💡 Enhancements 💡
- Invalid requests now return an appropriate unsupported (
405) or method not allowed (415) response (#4735) client.Info: Add Host property for Metadata (#4736)
v0.43.1 Beta
🧰 Bug fixes 🧰
- ExpandStringValues function support to map[string]interface{} (#4748)
v0.43.0 Beta
🛑 Breaking changes 🛑
- Change configmapprovider.Provider to accept a location for retrieve (#4657)
- Change Properties Provider to be a Converter (#4666)
- Define a type
WatcherFuncfor onChange func instead of func pointer (#4656) - Remove deprecated
configtest.LoadConfigandconfigtest.LoadConfigAndValidate(#4659) - Move service.ConfigMapConverterFunc to config.MapConverterFunc (#4673)
- Add context to config.MapConverterFunc (#4678)
- Builder: the skip compilation should only be supplied as a CLI flag. Previously, it was possible to specify that in the YAML file, contrary to the original intention (#4645)
- Builder: Remove deprecated config option module::core (#4693)
- Remove deprecate flags --metrics-level and --metrics-addr (#4695)
- Usages of
--metrics-level={VALUE}can be replaced by--set=service.telemetry.metrics.level={VALUE}; - Usages of
--metrics-addr={VALUE}can be replaced by--set=service.telemetry.metrics.address={VALUE};
- Usages of
- Updated confighttp
ToClientto support passing telemetry settings for instrumenting otlphttp exporter(#4449) - Remove support to some arches and platforms from
ocb(opentelemetry-collector-builder) (#4710) - Remove deprecated legacy path ("v1/trace") support for otlp http receiver (#4720)
- Change the
service.NewDefaultConfigProviderto accept a slice of location strings (#4727).
🚩 Deprecations 🚩
- Deprecate
configtelemetry.Level.Set()(#4700)
🧰 Bug fixes 🧰
- Ensure Windows path (e.g: C:) is recognized as a file path (#4726)
- Fix structured logging issue for windows service (#4686)
💡 Enhancements 💡
- Expose experimental API
configmapprovider.NewExpandConverter()(#4672) service.NewConfigProvider: copy slice argument, disallow changes from caller to the input slice (#4729)confighttpandconfiggrpc: New config optioninclude_metadatato persist request metadata/headers inclient.Info.Metadata(experimental) (#4547)- Remove expand cases that cannot happen with config.Map (#4649)
- Add
max_request_body_sizeto confighttp.HTTPServerSettings (#4677) - Move
compression.gointoconfighttp.goto internalize functions incompression.gofile. (#4651)- create
configcompressionpackage to manage compression methods inconfighttpandconfiggrpc
- create
- Add support for cgroupv2 memory limit (#4654)
- Enable end users to provide multiple files for config location (#4727)
v0.42.0 Beta
🛑 Breaking changes 🛑
- Remove
configmapprovider.NewInMemory()(#4507) - Disallow direct implementation of
configmapprovider.Retrieved(#4577) configauth: remove interceptor functions from the ServerAuthenticator interface (#4583)- Replace ConfigMapProvider and ConfigUnmarshaler in collector settings by one simpler ConfigProvider (#4590)
- Remove deprecated consumererror.Combine (#4597)
- Remove
configmapprovider.NewDefault,configmapprovider.NewExpand,configmapprovider.NewMerge(#4600)- The merge functionality is now embedded into
service.NewConfigProvider(#4637).
- The merge functionality is now embedded into
- Move
configtest.LoadConfigandconfigtest.LoadConfigAndValidatetoservicetest(#4606) - Builder: Remove deprecated
include-coreflag (#4616) - Collector telemetry level must now be accessed through an atomic function. (#4549)
💡 Enhancements 💡
confighttp: add client-side compression support. (#4441)- Each exporter should remove
compressionfield if they have and should useconfighttp.HTTPClientSettings
- Each exporter should remove
- Allow more zap logger configs:
disable_caller,disable_stacktrace,output_paths,error_output_paths,initial_fields(#1048) - Allow the custom zap logger encoding (#4532)
- Collector self-metrics may now be configured through the configuration file. (#4069)
- CLI flags for configuring self-metrics are deprecated and will be removed in a future release.
service.telemetry.metrics.levelandservice.telemetry.metrics.addressshould be used to configure collector self-metrics.
configauth: add helpers to create new server authenticators. (#4558)- Refactor
configgrpcfor compression methods (#4624) - Add an option to allow
config.Mapconversion in theservice.ConfigProvider(#4634) - Added support to expose gRPC framework's logs as part of collector logs (#4501)
- Builder: Enable unmarshal exact to help finding hard to find typos #4644
🧰 Bug fixes 🧰
- Fix merge config map provider to close the watchers (#4570)
- Fix expand map provider to call close on the base provider (#4571)
- Fix correct the value of
otelcol_exporter_send_failed_requests(#4629) otlpreceiver: Fix legacy port cfg value override and HTTP server starting bug (#4631)
v0.41.0 Beta
🛑 Breaking changes 🛑
- Remove reference to
defaultcomponentsin core and deprecateinclude_coreflag (#4087) - Remove
config.NewConfigMapFrom[File|Buffer], add testonly version (#4502) configtls: TLS 1.2 is the new default minimum version (#4503)confighttp:ToServernow accepts acomponent.Host, in line with gRPC's counterpart (#4514)- CORS configuration for OTLP/HTTP receivers has been moved into a
cors:block, instead of individualcors_allowed_originsandcors_allowed_headerssettings (#4492)
💡 Enhancements 💡
- OTLP/HTTP receivers now support setting the
Access-Control-Max-Ageheader for CORS caching. (#4492) client.Infopre-populated for all receivers using common helpers likeconfighttpandconfiggrpc(#4423)
🧰 Bug fixes 🧰
- Fix handling of corrupted records by persistent buffer (experimental) (#4475)
💡 Enhancements 💡
- Extending the contribution guide to help clarify what is acceptable defaults and recommendations.
v0.40.0 Beta
🛑 Breaking changes 🛑
- Package
clientrefactored (#4416) and auth data included in it (#4422). Final PR to be merged in the next release (#4423) - Remove
pdata.AttributeMap.InitFromMap(#4429) - Updated configgrpc
ToDialOptionsto support passing providers to instrumentation library (#4451) - Make state information propagation non-blocking on the collector (#4460)
💡 Enhancements 💡
- Add semconv 1.7.0 and 1.8.0 (#4452)
- Added
feature-gatesCLI flag for controlling feature gate state. (#4368) - Add a default user-agent header to the OTLP/gRPC and OTLP/HTTP exporters containing collector build information (#3970)
v0.39.0 Beta
🛑 Breaking changes 🛑
- Remove deprecated config (already no-op)
ballast_size_mibin memorylimiterprocessor (#4365) - Remove
config.Receivers,config.Exporters,config.Processors, andconfig.Extensions. Use map directly (#4344) - Remove
component.BaseProcessorFactory, useprocessorhelper.NewFactoryinstead (#4175) - Force usage of
exporterhelper.NewFactoryto implementcomponent.ExporterFactory(#4338) - Force usage of
receiverhelper.NewFactoryto implementcomponent.ReceiverFactory(#4338) - Force usage of
extensionhelper.NewFactoryto implementcomponent.ExtensionFactory(#4338) - Move
service/parserproviderpackage toconfig/configmapprovider(#4206)- Rename
MapProviderinterface toProvider - Remove
MapProviderfrom helper names
- Rename
- Renamed slice-valued
pdatatypes and functions for consistency. (#4325)- Rename
pdata.AnyValueArraytopdata.AttributeValueSlice - Rename
ArrayVal()toSliceVal() - Rename
SetArrayVal()toSetSliceVal()
- Rename
- Remove
config.Pipeline.Name(#4326) - Rename
config.Mapproviderasconfigmapprovider.Provider(#4337) - Move
config.WatchableRetrievedandconfig.Retrievedinterfaces toconfig/configmapproviderpackage (#4337) - Remove
config.Pipeline.InputDataType(#4343) - otlpexporter: Do not retry on PermissionDenied and Unauthenticated (#4349)
- Enable configuring collector metrics through service config file. (#4069)
- New
service::telemetry::metricsstructure added to configuration - Existing metrics configuration CLI flags are deprecated and to be removed in the future.
--metrics-prefixis no longer operative; the prefix is determined by the value ofservice.buildInfo.Command.--add-instance-idis no longer operative; an instance ID will always be added.
- New
- Remove deprecated funcs
consumererror.As[Traces|Metrics|Logs](#4364) - Remove support to expand env variables in default configs (#4366)
💡 Enhancements 💡
- Supports more compression methods(
snappyandzstd) for configgrpc, in addition to currentgzip(#4088) - Moved the OpenTelemetry Collector Builder to core (#4307)
🧰 Bug fixes 🧰
- Fix AggregationTemporality and IsMonotonic when metric descriptors are split in the batch processor (#4389)
v0.38.0 Beta
🛑 Breaking changes 🛑
- Removed
configauth.HTTPClientAuthenticatorandconfigauth.GRPCClientAuthenticatorin favor ofconfigauth.ClientAuthenticator. (#4255) - Rename
parserprovider.MapProviderasconfig.MapProvider. (#4178) - Rename
parserprovider.Watchableasconfig.WatchableMapProvider. (#4178) - Remove deprecated no-op flags to setup Collector's logging "--log-level", "--log-profile", "--log-format". (#4213)
- Move
cmd/pdatagenas internal packagemodel/internal/cmd/pdatagen. (#4243) - Use directly the ComponentID in configauth. (#4238)
- Refactor configauth, getters use the map instead of iteration. (#4234)
- Change scraperhelper to follow the recommended append model for pdata. (#4202)
💡 Enhancements 💡
- Update proto to 0.11.0. (#4209)
- Change pdata to use the newly added [Traces|Metrics|Logs]Data. (#4214)
- Add ExponentialHistogram field to pdata. (#4219)
- Make sure otlphttp exporter tests include TraceID and SpanID. (#4268)
- Use multimod tool in release process. (#4229)
- Change queue metrics to use opencensus metrics instead of stats, close to otel-go. (#4220)
- Make receiver data delivery guarantees explicit (#4262)
- Simplify unmarshal logic by adding more supported hooks. (#4237)
- Add unmarshaler for otlpgrpc.[]Request and otlpgrpc.[]Response (#4215)
v0.37.0 Beta
🛑 Breaking changes 🛑
- Move
configcheck.ValidateConfigFromFactoriesas internal function in service package (#3876) - Rename
configparser.Parserasconfig.Map(#4075) - Rename
component.DefaultBuildInfo()tocomponent.NewDefaultBuildInfo()(#4129) - Rename
consumererror.Permanenttoconsumererror.NewPermanent(#4118) - Rename
config.NewIDtoconfig.NewComponentIDandconfig.NewIDFromStringtoconfig.NewComponentIDFromString(#4137) - Rename
config.NewIDWithNametoconfig.NewComponentIDWithName(#4151) - Move
extension/storagetoextension/experimental/storage(#4082) - Rename
obsreporttest.SetupRecordedMetricsTest()toobsreporttest.SetupTelemetry()andobsreporttest.TestTelemetrySettingstoobsreporttest.TestTelemetry(#4157)
💡 Enhancements 💡
- Add Gen dependabot into CI (#4083)
- Update OTLP to v0.10.0 (#4045).
- Add Flags field to NumberDataPoint, HistogramDataPoint, SummaryDataPoint (#4081).
- Add feature gate library (#4108)
- Add version to the internal telemetry metrics (#4140)
🧰 Bug fixes 🧰
- Fix panic when not using
service.NewCommand(#4139)
v0.36.0 Beta
🛑 Breaking changes 🛑
- Remove deprecated pdata.AttributeMapToMap (#3994)
- Move ValidateConfig from configcheck to configtest (#3956)
- Remove
mem-ballast-size-mib, already deprecated and no-op (#4005) - Remove
semconv.AttributeMessageType(#4020) - Remove
semconv.AttributeHTTPStatusText(#4015) - Remove squash on
configtls.TLSClientSettingand move TLS client configs undertls(#4063) - Rename TLS server config
*configtls.TLSServerSettingfromtls_settingstotls(#4063) - Split
service.Collectorfrom thecobra.Command(#4074) - Rename
memorylimitertomemorylimiterprocessor(#4064)
💡 Enhancements 💡
- Create new semconv package for v1.6.1 (#3948)
- Add AttributeValueBytes support to AsString (#4002)
- Add AttributeValueTypeBytes support to AttributeMap.AsRaw (#4003)
- Add MeterProvider to TelemetrySettings (#4031)
- Add configuration to setup collector logs via config file. (#4009)
v0.35.0 Beta
🛑 Breaking changes 🛑
- Remove the legacy gRPC port(
55680) support in OTLP receiver (#3966) - Rename configparser.Parser to configparser.ConfigMap (#3964)
- Remove obsreport.ScraperContext, embed into StartMetricsOp (#3969)
- Remove dependency on deprecated go.opentelemetry.io/otel/oteltest (#3979)
- Remove deprecated pdata.AttributeValueToString (#3953)
- Remove deprecated pdata.TimestampFromTime. Closes: #3925 (#3935)
💡 Enhancements 💡
- Add TelemetryCreateSettings (#3984)
- Only initialize collector telemetry once (#3918)
- Add trace context info to LogRecord log (#3959)
- Add new view for AWS ECS health check extension. (#3776)
v0.34.0 Beta
🛑 Breaking changes 🛑
- Artifacts are no longer published in this repository, check here (#3941)
- Remove deprecated
tracetranslator.AttributeValueToStringandtracetranslator.AttributeMapToMap(#3873) - Change semantic conventions for status (code, msg) as per specifications (#3872)
- Move
fileexporterto contrib (#3474) - Move
jaegerexporterto contrib (#3474) - Move
kafkaexporterto contrib (#3474) - Move
opencensusexporterto contrib (#3474) - Move
prometheusexporterto contrib (#3474) - Move
prometheusremotewriteexporterto contrib (#3474) - Move
zipkinexporterto contrib (#3474) - Move
attributeprocessorto contrib (#3474) - Move
filterprocessorto contrib (#3474) - Move
probabilisticsamplerprocessorto contrib (#3474) - Move
resourceprocessorto contrib (#3474) - Move
spanprocessorto contrib (#3474) - Move
hostmetricsreceiverto contrib (#3474) - Move
jaegerreceiverto contrib (#3474) - Move
kafkareceiverto contrib (#3474) - Move
opencensusreceiverto contrib (#3474) - Move
prometheusreceiverto contrib (#3474) - Move
zipkinreceiverto contrib (#3474) - Move
bearertokenauthextensionto contrib (#3474) - Move
healthcheckextensionto contrib (#3474) - Move
oidcauthextensionto contrib (#3474) - Move
pprofextensionto contrib (#3474) - Move
translator/internaldatato contrib (#3474) - Move
translator/trace/jaegerto contrib (#3474) - Move
translator/trace/zipkinto contrib (#3474) - Move
testbedto contrib (#3474) - Move
exporter/exporterhelper/resource_to_telemetryto contrib (#3474) - Move
processor/processorhelper/attractionto contrib (#3474) - Move
translator/conventionstomodel/semconv(#3901)
🚩 Deprecations 🚩
- Add
pdata.NewTimestampFromTime, deprecatepdata.TimestampFromTime(#3868) - Add
pdata.NewAttributeMapFromMap, deprecatepdata.AttributeMap.InitFromMap(#3936)
v0.33.0 Beta
🛑 Breaking changes 🛑
- Rename
configloaderinterface toconfigunmarshaler(#3774) - Remove
LabelsMapfrom all the metrics points (#3706) - Update generated K8S attribute labels to fix capitalization (#3823)
💡 Enhancements 💡
- Collector has now full support for metrics proto v0.9.0.
v0.32.0 Beta
This release is marked as "bad" since the metrics pipelines will produce bad data.
🛑 Breaking changes 🛑
- Rename
CustomUnmarshableinterface toUnmarshallable(#3774)
💡 Enhancements 💡
- Change default OTLP/HTTP port number from 55681 to 4318 (#3743)
- Update OTLP proto to v0.9.0 (#3740)
- Remove
SetValue/Valuefunc forNumberDataPoint/Exemplar(#3730) - Remove
IntGauge/IntSumfrom pdata (#3731) - Remove
IntDataPointfrom pdata (#3735) - Add support for
Bytesattribute type (#3756) - Add
SchemaUrlfield (#3759) - Add
AttributestoNumberDataPoint,HistogramDataPoint,SummaryDataPoint(#3761)
- Remove
conventionstranslator: Replace with conventions generated from spec v1.5.0 (#3494)prometheusreceiver: AddToMetricPdatamethod (#3695)- Make configsource
Watchablean optional interface (#3792) obsreportexporter: Change to acceptExporterCreateSettings(#3789)
🧰 Bug fixes 🧰
configgrpc: Use chained interceptors in the gRPC server (#3744)prometheusreceiver: Use actual interval startTimeMs for cumulative types (#3694)jaegertranslator: Fix bug that could generate empty proto spans (#3808)
v0.31.0 Beta
🛑 Breaking changes 🛑
- Remove Resize() from pdata slice APIs (#3675)
- Remove the ballast allocation when
mem-ballast-size-mibis set in command line (#3626)- Use
ballast extensionto set memory ballast instead.
- Use
- Rename
DoubleDataPointtoNumberDataPoint(#3633) - Remove
IntHistogram(#3676)
💡 Enhancements 💡
- Update to OTLP 0.8.0:
- Translate
IntHistogramtoHistograminotlp_wrappers(#3676) - Translate
IntGaugetoGaugeinotlp_wrappers(#3619) - Translate
IntSumtoSuminotlp_wrappers(#3621) - Update
NumberDataPointto supportDoubleValandIntVal(#3689) - Update
Exemplarto useoneOfPrimitiveValue(#3699) - Remove
IntExemplarandIntExemplarSlicefrompdata(#3705) - Mark
IntGauge/IntSum/IntDataPointas deprecated (#3707) - Remove
IntGauge/IntSumfrombatchprocessor(#3718) prometheusremotewriteexporter: Convert to new Number metrics (#3714)prometheusreceiver: Convert to new Number metrics (#3716)prometheusexporter: Convert to new Number metrics (#3709)hostmetricsreceiver: Convert to new Number metrics (#3710)opencensus: Convert to new Number metrics (#3708)scraperhelperreceiver: Convert to new Number metrics (#3717)testbed: Convert to new Number metrics (#3719)exporterhelper: Convertresourcetolabelto new Number metrics (#3723)
- Translate
configauth: Prepare auth API to return a context (#3618)pdata:- Implement
Equal()for map-valuedAttributeValues(#3612) - Add
[Type]Slice.Sort(func)to sort slices (#3671)
- Implement
memorylimiter:- Add validation on ballast size between
memorylimiterandballastextension(#3532) - Access Ballast extension via
Host.GetExtensions(#3634)
- Add validation on ballast size between
prometheusremotewriteexporter: Add a WAL implementation without wiring up (#3597)prometheusreceiver: AddmetricGroup.toDistributionPointpdata conversion (#3667)- Use
ComponentIDas identifier instead of config (#3696) zpages: Move config validation from factory toValidate(#3697)- Enable
tracezz-pages from otel-go, disable opencensus (#3698) - Convert temporality and monotonicity for deprecated sums (#3729)
🧰 Bug fixes 🧰
otlpexporter: Allow endpoint to be configured with a scheme ofhttporhttps(#3575)- Handle errors when reloading the collector service (#3615)
- Do not report fatal error when
cmux.ErrServerClosed(#3703) - Fix bool attribute equality in
pdata(#3688)
v0.30.0 Beta
🛑 Breaking changes 🛑
- Rename
pdata.DoubleSumtopdata.Sum(#3583) - Rename
pdata.DoubleGaugetopdata.Gauge(#3599) - Migrated
pdatato a dedicated package (#3483) - Change Marshaler/Unmarshaler to be consistent with other interfaces (#3502)
- Remove consumer/simple package (#3438)
- Remove unnecessary interfaces from pdata (#3506)
- zipkinv1 implement directly Unmarshaler interface (#3504)
- zipkinv2 implement directly Marshaler/Unmarshaler interface (#3505)
- Change exporterhelper to accept ExporterCreateSettings instead of just logger (#3569)
- Use Func pattern in processorhelper, consistent with others (#3570)
🚩 Deprecations 🚩
- Deprecate Resize() from pdata slice APIs (#3573)
💡 Enhancements 💡
- Update OTLP to v0.8.0 (#3572)
- Migrate from OpenCensus to OpenTelemetry for internal tracing (#3567)
- Move internal/pdatagrpc to model/otlpgrpc (#3507)
- Move internal/otlp to model/otlp (#3508)
- Create http Server via Config, enable cors and decompression (#3513)
- Allow users to set min and max TLS versions (#3591)
- Support setting ballast size in percentage of total Mem in ballast extension (#3456)
- Publish go.opentelemetry.io/collector/model as a separate module (#3530)
- Pass a TracerProvider via construct settings to all the components (#3592)
- Make graceful shutdown optional (#3577)
🧰 Bug fixes 🧰
scraperhelper: Include the scraper name in log messages (#3487)scraperhelper: fix case when returned pdata is empty (#3520)- Record the correct number of points not metrics in Kafka receiver (#3553)
- Validate the Prometheus configuration (#3589)
v0.29.0 Beta
🛑 Breaking changes 🛑
- Rename
service.Applicationtoservice.Collector(#3268) - Provide case sensitivity in config yaml mappings by using Koanf instead of Viper (#3337)
- Move zipkin constants to an internal package (#3431)
- Disallow renaming metrics using metric relabel configs (#3410)
- Move cgroup and iruntime utils from memory_limiter to internal folder (#3448)
- Move model pdata interfaces to pdata, expose them publicly (#3455)
💡 Enhancements 💡
- Change obsreport helpers for scraper to use the same pattern as Processor/Exporter (#3327)
- Convert
otlptextto implement Marshaler interfaces (#3366) - Add encoder/decoder and marshaler/unmarshaler for OTLP protobuf (#3401)
- Use the new marshaler/unmarshaler in
kafkaexporter (#3403) - Convert
zipkinv2to to/from translator interfaces (#3409) zipkinv1: Move to translator and encoders interfaces (#3419)- Use the new marshaler/unmarshaler in
kafkareceiver #3402 - Change
oltpreceiver to use the new unmarshaler, avoid grpc-gateway dependency (#3406) - Use the new Marshaler in the
otlphttpexporter (#3433) - Add grpc response struct for all signals instead of returning interface in
otlpreceiver/exporter (#3437) zipkinv2: Add encoders, decoders, marshalers (#3426)scrapererrorreceiver: Return concrete error type (#3360)kafkareceiver: Add metrics support (#3452)prometheusreceiver:- Add store to track stale metrics (#3414)
- Add
upandscrape_xxxxinternal metrics (#3116)
🧰 Bug fixes 🧰
prometheusreceiver:- Reject datapoints with duplicate label keys (#3408)
- Scrapers are not stopped when receiver is shutdown (#3450)
prometheusremotewriteexporter: Adjust default retry settings (#3416)hostmetricsreceiver: Fix missing startTimestamp forprocessesscraper (#3461)
v0.28.0 Beta
🛑 Breaking changes 🛑
- Remove unused logstest package (#3222)
- Introduce
AppSettingsinstead ofParameters(#3163) - Remove unused testutil.TempSocketName (#3291)
- Move BigEndian helper functions in
tracetranslatorto an internal package.(#3298) - Rename
configtest.LoadConfigFiletoconfigtest.LoadConfigAndValidate(#3306) - Replace
ExtensionCreateParamswithExtensionCreateSettings(#3294) - Replace
ProcessorCreateParamswithProcessorCreateSettings. (#3181) - Replace
ExporterCreateParamswithExporterCreateSettings(#3164) - Replace
ReceiverCreateParamswithReceiverCreateSettings. (#3167) - Change
batchprocessorlogic to limit data points rather than metrics (#3141) - Rename
PrwExportertoPRWExporterandNewPrwExportertoNewPRWExporter(#3246) - Avoid exposing OpenCensus reference in public APIs (#3253)
- Move
config.Parsertoconfigparser.Parser(#3304) - Remove deprecated funcs inside the obsreceiver (#3314)
- Remove
obsreport.GRPCServerWithObservabilityEnabled, enable observability in config (#3315) - Remove
obsreport.ProcessorMetricViews, useBuildProcessorCustomMetricNamewhere needed (#3316) - Remove "Receive" from
obsreport.Receiverfuncs (#3326) - Remove "Export" from
obsreport.Exporterfuncs (#3333) - Hide unnecessary public struct
obsreport.StartReceiveOptions(#3353) - Avoid exposing internal implementation public in OC/OTEL receivers (#3355)
- Updated configgrpc
ToDialOptionsand confighttpToClientapis to take extensions configuration map (#3340) - Remove
GenerateSequentialTraceIDandGenerateSequentialSpanIDinfunctions in testbed (#3390) - Change "grpc" to "GRPC" in configauth function/type names (#3285)
💡 Enhancements 💡
- Add
doc.gofiles to the consumer package and its subpackages (#3270) - Improve documentation of consumer package and subpackages (#3269, #3361)
- Automate triggering of doc-update on release (#3234)
- Enable Dependabot for Github Actions (#3312)
- Remove the proto dependency in
goldendatasetfor traces (#3322) - Add telemetry for dropped data due to exporter sending queue overflow (#3328)
- Add initial implementation of
pdatagrpc(#3231) - Change receiver obsreport helpers pattern to match the Processor/Exporter (#3227)
- Add model translation and encoding interfaces (#3200)
- Add otlpjson as a serializer implementation (#3238)
prometheusreceiver:- Add
createNodeAndResourcePdatafor Prometheus->OTLP pdata (#3139) - Direct metricfamily Prometheus->OTLP (#3145)
- Add
- Add
componenttest.NewNop*CreateSettingsto simplify tests (#3375) - Add support for markdown generation (#3100)
- Refactor components for the Client Authentication Extensions (#3287)
🧰 Bug fixes 🧰
- Use dedicated
zapcore.Corefor Windows service (#3147) - Hook up start and shutdown functions in fileexporter (#3260)
- Fix oc to pdata translation for sum non-monotonic cumulative (#3272)
- Fix
timeseriesSignaturein prometheus receiver (#3310)
v0.27.0 Beta
🛑 Breaking changes 🛑
- Change
Marshalsignatures in kafkaexporter's Marshalers to directly convert pdata tosarama.ProducerMessage(#3162) - Remove
tracetranslator.DetermineValueType, only used internally by Zipkin (#3114) - Remove OpenCensus conventions, should not be used (#3113)
- Remove Zipkin specific translation constants, move to internal (#3112)
- Remove
tracetranslator.TagHTTPStatusCode, useconventions.AttributeHTTPStatusCode(#3111) - Remove OpenCensus status constants and transformation (#3110)
- Remove
tracetranslator.AttributeArrayToSlice, not used in core or contrib (#3109) - Remove
internaldata.MetricsData, same APIs as for traces (#3156) - Rename
config.IDFromStringtoNewIDFromString, removeMustIDFromString(#3177) - Move consumerfanout package to internal (#3207)
- Canonicalize enum names in pdata. Fix usage of uppercase names (#3208)
💡 Enhancements 💡
- Use
config.ComponentIDfor obsreport receiver/scraper (#3098) - Add initial implementation of the consumerhelper (#3146)
- Add Collector version to Prometheus Remote Write Exporter user-agent header (#3094)
- Refactor processorhelper to use consumerhelper, split by signal type (#3180)
- Use consumerhelper for exporterhelper, add WithCapabilities (#3186)
- Set capabilities for all core exporters, remove unnecessary funcs (#3190)
- Add an internal sharedcomponent to be shared by receivers with shared resources (#3198)
- Allow users to configure the Prometheus remote write queue (#3046)
- Mark internaldata traces translation as deprecated for external usage (#3176)
🧰 Bug fixes 🧰
- Fix Prometheus receiver metric start time and reset determination logic. (#3047)
- The receiver will no longer drop the first sample for
counter,summary, andhistogrammetrics.
- The receiver will no longer drop the first sample for
- The Prometheus remote write exporter will no longer force
countermetrics to have a_totalsuffix. (#2993) - Remove locking from jaeger receiver start and stop processes (#3070)
- Fix batch processor metrics reorder, improve performance (#3034)
- Fix batch processor traces reorder, improve performance (#3107)
- Fix batch processor logs reorder, improve performance (#3125)
- Avoid one unnecessary allocation in grpc OTLP exporter (#3122)
batchprocessor: Validate that batch config max size is greater than send size (#3126)- Add capabilities to consumer, remove from processor (#2770)
- Remove internal protos usage in Prometheusremotewrite exporter (#3184)
prometheusreceiver: Honor Prometheus external labels (#3127)- Validate that remote write queue settings are not negative (#3213)
v0.26.0 Beta
🛑 Breaking changes 🛑
- Change
With*Unmarshallerssignatures in Kafka exporter/receiver (#2973) - Rename
marshalltomarshalin all the occurrences (#2977) - Remove
componenterror.ErrAlreadyStartedandcomponenterror.ErrAlreadyStopped, components should not protect against this, Service will start/stop once. - Rename
ApplicationStartInfotoBuildInfo - Rename
ApplicationStartInfo.ExeNametoBuildInfo.Command - Rename
ApplicationStartInfo.LongNametoBuildInfo.Description
🚩 Deprecations 🚩
- Add AppendEmpty and deprecate Append for slices (#2970)
💡 Enhancements 💡
kafkaexporter: Add logs support (#2943)- Update mdatagen to create factories of init instead of new (#2978)
zipkinreceiver: Reduce the judgment of zipkin v1 version (#2990)- Custom authenticator logic to accept a
component.Hostwhich will extract the authenticator to use based on a new authenticator name property (#2767) prometheusremotewriteexporter: Addresource_to_telemetry_conversionconfig option (#3031)loggingexporter: Extract OTLP text logging (#3082)- Format timestamps as strings instead of int in otlptext output (#3088)
- Add darwin arm64 build (#3090)
🧰 Bug fixes 🧰
- Fix Jaeger receiver to honor TLS Settings (#2866)
zipkintranslator: Handle missing starttime case for zipkin json v2 format spans (#2506)prometheusexporter: Fix OTEL resource label drops (#2899)prometheusremotewriteexporter:- Enable the queue internally (#2974)
- Don't drop instance and job labels (#2979)
jaegerreceiver: Wait for server goroutines exit on shutdown (#2985)loggingexporter: Ignore invalid handle on close (#2994)- Fix service zpages (#2996)
batchprocessor: Fix to avoid reordering and send max size (#3029)
v0.25.0 Beta
🛑 Breaking changes 🛑
- Rename ForEach (in pdata) with Range to be consistent with sync.Map (#2931)
- Rename
componenthelper.Starttocomponenthelper.StartFunc(#2880) - Rename
componenthelper.Stoptocomponenthelper.StopFunc(#2880) - Remove
exporterhelper.WithCustomUnmarshaler,processorhelper.WithCustomUnmarshaler,receiverhelper.WithCustomUnmarshaler,extensionhelper.WithCustomUnmarshaler, implementconfig.CustomUnmarshalerinterface instead (#2867) - Remove
component.CustomUnmarshalerimplementconfig.CustomUnmarshalerinterface instead (#2867) - Remove
testutil.HostPortFromAddr, users can write their own parsing helper (#2919) - Remove
configparser.DecodeTypeAndName, useconfig.IDFromString(#2869) - Remove
config.NewViper, users should useconfig.NewParser(#2917) - Remove
testutil.WaitFor, usetestify.Eventuallyhelper if needed (#2920) - Remove testutil.WaitForPort, users can use testify.Eventually (#2926)
- Rename
processorhelper.NewTraceProcessortoprocessorhelper.NewTracesProcessor(#2935) - Rename
exporterhelper.NewTraceExportertoexporterhelper.NewTracesExporter(#2937) - Remove InitEmptyWithCapacity, add EnsureCapacity and Clear (#2845)
- Rename traces methods/objects to include Traces in Kafka receiver (#2966)
💡 Enhancements 💡
- Add
validatableinterface withValidate()to allconfig.<component>(#2898)- add the empty
Validate()implementation for all component configs
- add the empty
- Experimental: Add a config source manager that wraps the interaction with config sources (#2857, #2903, #2948)
kafkaexporter: Key jaeger messages on traceid (#2855)scraperhelper: Don't try to count metrics if scraper returns an error (#2902)- Extract ConfigFactory in a ParserProvider interface (#2868)
prometheusexporter: Allows Summary metrics to be exported to Prometheus (#2900)prometheusreceiver: OptimizedpgSignaturefunction (#2945)kafkareceiver: Add logs support (#2944)
🧰 Bug fixes 🧰
prometheusreceiver:- Treat Summary and Histogram metrics without "_sum" counter as valid metric (#2812)
- Add
jobandinstanceas well-known labels (#2897)
prometheusremotewriteexporter:- Sort Sample by Timestamp to avoid out of order errors (#2941)
- Remove incompatible queued retry (#2951)
kafkareceiver: Fix data race with batchprocessor (#2957)jaegerreceiver: Jaeger agent should not report ErrServerClosed (#2965)
v0.24.0 Beta
🛑 Breaking changes 🛑
- Remove legacy internal metrics for memorylimiter processor,
spans_droppedandtrace_batches_dropped(#2841)- For
spans_droppeduseprocessor/refused_spanswithprocessor=memorylimiter
- For
- Rename pdata..[Start|End]Time to pdata..[Start|End]Timestamp (#2847)
- Rename pdata.DoubleExemplar to pdata.Exemplar (#2804)
- Rename pdata.DoubleHistogram to pdata.Histogram (#2797)
- Rename pdata.DoubleSummary to pdata.Summary (#2774)
- Refactor
consumererrorpackage (#2768)- Remove
PartialErrortype in favor of signal-specific types - Rename
CombineErrors()toCombine()
- Remove
- Refactor
componenthelperpackage (#2778)- Remove
ComponentSettingsandDefaultComponentSettings() - Rename
NewComponent()toNew()
- Remove
- obsReport.NewExporter accepts a settings struct (#2668)
- Remove ErrorWaitingHost from
componenttest(#2582) - Move
config.Loadtoconfigparser.Load(#2796) - Remove
configtest.NewViperFromYamlFile(), useconfig.Parser.NewParserFromFile()(#2806) - Remove
config.ViperSubExact(), useconfig.Parser.Sub()(#2806) - Update LoadReceiver signature to remove unused params (#2823)
- Move
configerror.ErrDataTypeIsNotSupportedtocomponenterror.ErrDataTypeIsNotSupported(#2886) - Rename
CreateTraceExportertype toCreateTracesExporterinexporterhelper(#2779) - Move
fluentbitextension to contrib (#2795) - Move
configmodelstoconfig(#2808) - Move
fluentforwardreceiver to contrib (#2723)
🚩 Deprecations 🚩
- Deprecate
consumetest.New[${SIGNAL}]Nopin favor ofconsumetest.NewNop(#2878) - Deprecate
consumetest.New[${SIGNAL}]Errin favor ofconsumetest.NewErr(#2878)
💡 Enhancements 💡
batchprocessor: - Support max batch size for logs (#2736)- Use
Endpointfor health check extension (#2782) - Use
confignet.TCPAddrforpprofandzpagesextensions (#2829) - Add watcher to values retrieved via config sources (#2803)
- Updates for cloud semantic conventions (#2809)
cloud.infrastructure_service->cloud.platformcloud.zone->cloud.availability_zone
- Add systemd environment file for deb/rpm packages (#2822)
- Add validate interface in
configmodelsto force each component do configuration validation (#2802, #2856) - Add
aws.ecs.task.revisionto semantic conventions list (#2816) - Set unprivileged user to container image (#2838)
- Add New funcs for extension, exporter, processor config settings (#2872)
- Report metric about current size of the exporter retry queue (#2858)
- Allow adding new signals in
ProcessorFactoryby forcing everyone to embedBaseProcessorFactory(#2885)
🧰 Bug fixes 🧰
pdata.TracesFromOtlpProtoBytes: Fixes to handle backwards compatibility changes in proto (#2798)jaegerreceiver: Escape user input used in output (#2815)prometheusexporter: Ensure same time is used for updated time (#2745)prometheusremotewriteexporter: Close HTTP response body (#2875)
v0.23.0 Beta
🛑 Breaking changes 🛑
- Move fanout consumers to fanoutconsumer package (#2615)
- Rename ExporterObsReport to Exporter (#2658)
- Rename ProcessorObsReport to Processor (#2657)
- Remove ValidateConfig and add Validate on the Config struct (#2665)
- Rename pdata Size to OtlpProtoSize (#2726)
- Rename [Traces|Metrics|Logs]Consumer to [Traces|Metrics|Logs] (#2761)
- Remove public access for
componenttest.Example*components:- Users of these structs for testing configs should use the newly added
componenttest.Nop*(update all components name in the configexample*->nopand usecomponenttest.NopComponents()). - Users of these structs for sink like behavior should use
consumertest.*Sink.
- Users of these structs for testing configs should use the newly added
💡 Enhancements 💡
hostmetricsreceiver: List labels along with respective metrics in metadata (#2662)exporterhelper: Remove obsreport.ExporterContext, always add exporter name as a tag to the metrics (#2682)jaegerexporter: Change to not use internal data (#2698)kafkareceiver: Change to not use internal data (#2697)zipkinreceiver: Change to not use internal data (#2699)kafkaexporter: Change to not use internal data (#2696)- Ensure that extensions can be created and started multiple times (#2679)
- Use otlp request in logs wrapper, hide members in the wrapper (#2692)
- Add MetricsWrapper to disallow access to internal representation (#2693)
- Add TracesWrapper to disallow access to internal representation (#2721)
- Allow multiple OTLP receivers to be created (#2743)
🧰 Bug fixes 🧰
prometheusexporter: Fix to work with standard labels that follow the naming convention of using periods instead of underscores (#2707)- Propagate name and transport for
prometheusreceiver and exporter (#2680) zipkinreceiver: Ensure shutdown correctness (#2765)
v0.22.0 Beta
🛑 Breaking changes 🛑
- Rename ServiceExtension to just Extension (#2581)
- Remove
consumerdata.TraceData(#2551) - Move
consumerdata.MetricsDatatointernaldata.MetricsData(#2512) - Remove custom OpenCensus sematic conventions that have equivalent in otel (#2552)
- Move ScrapeErrors and PartialScrapeError to
scrapererror(#2580) - Remove support for deprecated unmarshaler
CustomUnmarshaler, onlyUnmarshalis supported (#2591) - Remove deprecated componenterror.CombineErrors (#2598)
- Rename
pdata.TimestampUnixNanostopdata.Timestamp(#2549)
💡 Enhancements 💡
prometheusexporter: Re-implement on top ofgithub.com/prometheus/client_golang/prometheusand addmetric_expirationoptionloggingexporter: Add support for AttributeMap (#2609)- Add semantic conventions for instrumentation library (#2602)
🧰 Bug fixes 🧰
otlpreceiver: FixShutdown()bug (#2564)batchprocessor: Fix Shutdown behavior (#2537)loggingexporter: Fix handling the loop for empty attributes (#2610)prometheusremotewriteexporter: Fix counter name check (#2613)
v0.21.0 Beta
🛑 Breaking changes 🛑
- Remove deprecated function
IsValidfrom trace/span ID (#2522) - Remove accessors for deprecated status code (#2521)
💡 Enhancements 💡
otlphttpexporter: Addcompressionoption for gzip encoding of outgoing http requests (#2502)- Add
ScrapeErrorsstruct toconsumererrorto simplify errors usage (#2414) - Add
cors_allowed_headersoption toconfighttp(#2454) - Add SASL/SCRAM authentication mechanism on
kafkareceiver and exporter (#2503)
🧰 Bug fixes 🧰
otlpreceiver: Sets the correct deprecated status code before sending data to the pipeline (#2521)- Fix
IsPermanentto account for wrapped errors (#2455) otlpexporter: Preserve original error messages (#2459)
v0.20.0 Beta
🛑 Breaking changes 🛑
- Rename
samplingprocessor/probabilisticsamplerprocessortoprobabilisticsamplerprocessor(#2392)
💡 Enhancements 💡
hostmetricsreceiver: Refactor to use metrics metadata utilities (#2405, #2406, #2421)- Add k8s.node semantic conventions (#2425)
v0.19.0 Beta
🛑 Breaking changes 🛑
- Remove deprecated
queued_retryprocessor - Remove deprecated configs from
resourceprocessor:type(set "opencensus.type" key in "attributes.upsert" map instead) andlabels(use "attributes.upsert" instead).
💡 Enhancements 💡
hostmetricsreceiver: Refactor load metrics to use generated metrics (#2375)- Add uptime to the servicez debug page (#2385)
- Add new semantic conventions for AWS (#2365)
🧰 Bug fixes 🧰
jaegerexporter: Improve connection state logging (#2239)pdatagen: Fix slice of values generated code (#2403)filtersetprocessor: Avoid returning always nil error in strict filterset (#2399)
v0.18.0 Beta
🛑 Breaking changes 🛑
- Rename host metrics according to metrics spec and rename
swapscraper topaging(#2311)
💡 Enhancements 💡
- Add check for
NO_WINDOWS_SERVICEenvironment variable to force interactive mode on Windows (#2272) hostmetricsreceiver: Adddisk/weighted_io_timemetric (Linux only) (#2312)opencensusexporter: Add queue-retry (#2307)filterprocessor: Filter metrics using resource attributes (#2251)
🧰 Bug fixes 🧰
fluentforwardreceiver: Fix string conversions (#2314)- Fix zipkinv2 translation error tag handling (#2253)
v0.17.0 Beta
💡 Enhancements 💡
- Default config environment variable expansion (#2231)
prometheusremotewriteexporter: Add batched exports (#2249)memorylimiterprocessor: Introduce soft and hard limits (#2250)
🧰 Bug fixes 🧰
- Fix nits in pdata usage (#2235)
- Convert status to not be a pointer in the Span (#2242)
- Report the error from
pprof.StartCPUProfile(#2263) - Rename
service.Application.SignalTestCompletetoShutdown(#2277)
v0.16.0 Beta
🛑 Breaking changes 🛑
- Rename Push functions to be consistent across signals in
exporterhelper(#2203)
💡 Enhancements 💡
- Change default OTLP/gRPC port number to 4317, also continue receiving on legacy port 55680 during transition period (#2104).
kafkaexporter: Add support for exporting metrics as otlp Protobuf. (#1966)- Move scraper helpers to its own
scraperhelperpackage (#2185) - Add
componenthelperpackage to help build components (#2186) - Remove usage of custom init/stop in
scraperand use start/shutdown fromcomponent(#2193) - Add more trace annotations, so zpages are more useful to determine failures (#2206)
- Add support to skip TLS verification (#2202)
- Expose non-nullable metric types (#2208)
- Expose non-nullable elements from slices of pointers (#2200)
🧰 Bug fixes 🧰
- Change InstrumentationLibrary to be non-nullable (#2196)
- Add support for slices to non-pointers, use non-nullable AnyValue (#2192)
- Fix
--setflag to work with{}in configs (#2162)
v0.15.0 Beta
🛑 Breaking changes 🛑
- Remove legacy metrics, they were marked as legacy for ~12 months #2105
💡 Enhancements 💡
- Implement conversion between OpenCensus and OpenTelemetry Summary Metric (#2048)
- Add ability to generate non nullable messages (#2005)
- Implement Summary Metric in Prometheus RemoteWrite Exporter (#2083)
- Add
resource_to_telemetry_conversionto exporter helper expose exporter settings (#2060) - Add
CustomRoundTripperfunction to httpclientconfig (#2085) - Allow for more logging options to be passed to
service(#2132) - Add config parameters for
jaegerreceiver (#2068) - Map unset status code for
jaegertranslator as per spec (#2134) - Add more trace annotations to the queue-retry logic (#2136)
- Add config settings for component telemetry (#2148)
- Use net.SplitHostPort for IPv6 support in
prometheusreceiver (#2154) - Add --log-format command line option (default to "console") #2177.
🧰 Bug fixes 🧰
loggingexporter: Add Logging for Summary Datapoint (#2084)hostmetricsreceiver: use correct TCP state labels on Unix systems (#2087)- Fix otlp_log receiver wrong use of trace measurement (#2117)
- Fix "process/memory/rss" metric units (#2112)
- Fix "process/cpu_seconds" metrics (#2113)
- Add check for nil logger in exporterhelper functions (#2141)
prometheusreceiver:- Upgrade Prometheus version to fix race condition (#2121)
- Fix the scraper/discover manager coordination (#2089)
- Fix panic when adjusting buckets (#2168)
v0.14.0 Beta
🚀 New components 🚀
otlphttpexporter which implements OTLP over HTTP protocol.
🛑 Breaking changes 🛑
- Rename consumer.TraceConsumer to consumer.TracesConsumer #1974
- Rename component.TraceReceiver to component.TracesReceiver #1975
- Rename component.TraceProcessor to component.TracesProcessor #1976
- Rename component.TraceExporter to component.TracesExporter #1975
- Move
tailsamplingprocessor to contrib (#2012) - Remove NewAttributeValueSlice (#2028) and mark NewAttributeValue as deprecated (#2022)
- Remove pdata.StringValue (#2021)
- Remove pdata.InitFromAttributeMap, use CopyTo if needed (#2042)
- Remove SetMapVal and SetArrayVal for pdata.AttributeValue (#2039)
🚩 Deprecations 🚩
- Deprecate NopExporter, add NopConsumer (#1972)
- Deprecate SinkExporter, add SinkConsumer (#1973)
💡 Enhancements 💡
zipkinexporter: Add queue retry to zipkin (#1971)prometheusexporter: Addsend_timestampsoption (#1951)filterprocessor: Addexprpdata.Metric filtering support (#1940, #1996)attributeprocessor: Add log support (#1934)loggingexporter: Add index for histogram buckets count (#2009)otlphttpexporter: Add correct handling of server error responses (#2016)prometheusremotewriteexporter:- Add user agent header to outgoing http request (#2000)
- Convert histograms to cumulative (#2049)
- Return permanent errors (#2053)
- Add external labels (#2044)
hostmetricsreceiver: Use scraper controller (#1949)- Change Span/Trace ID to be byte array (#2001)
- Add
simplemetrics helper to facilitate building pdata.Metrics in receivers (#1540) - Improve diagnostic logging for exporters (#2020)
- Add obsreport to receiverhelper scrapers (#1961)
- Update OTLP to 0.6.0 and use the new Span Status code (#2031)
- Add support of partial requests for logs and metrics to the exporterhelper (#2059)
🧰 Bug fixes 🧰
loggingexporter: Added array serialization (#1994)zipkinreceiver: Allow receiver to parse string tags (#1893)batchprocessor: Fix shutdown race (#1967)- Guard for nil data points (#2055)
v0.13.0 Beta
🛑 Breaking changes 🛑
- Host metric
system.disk.timerenamed tosystem.disk.operation_time(#1887) - Use consumer for sender interface, remove unnecessary receiver address from Runner (#1941)
- Enable sending queue by default in all exporters configured to use it (#1924)
- Removed
groupbytraceprocessor(#1891) - Remove ability to configure collection interval per scraper (#1947)
💡 Enhancements 💡
- Host Metrics receiver now reports both
system.disk.io_timeandsystem.disk.operation_time(#1887) - Match spans against the instrumentation library and resource attributes (#928)
- Add
receiverhelperfor creating flexible "scraper" metrics receiver (#1886, #1890, #1945, #1946) - Migrate
tailsamplingprocessor to new OTLP-based internal data model and add Composite Sampler (#1894) - Metadata Generator: Change Metrics fields to implement an interface with new methods (#1912)
- Add unmarshalling for
pdata.Traces(#1948) - Add debug-level message on error for
jaegerexporter (#1964)
🧰 Bug fixes 🧰
- Fix bug where the service does not correctly start/stop the log exporters (#1943)
- Fix Queued Retry Unusable without Batch Processor (#1813) - (#1930)
prometheusreceiver: Log error message whenprocess_start_time_secondsgauge is missing (#1921)- Fix trace jaeger conversion to internal traces zero time bug (#1957)
- Fix panic in otlp traces to zipkin (#1963)
- Fix OTLP/HTTP receiver's path to be /v1/traces (#1979)
v0.12.0 Beta
🚀 New components 🚀
configauthpackage with the auth settings that can be used by receivers (#1807, #1808, #1809, #1810)perfcounterspackage that uses perflib for host metrics receiver (#1835, #1836, #1868, #1869, #1870)
💡 Enhancements 💡
- Remove
queued_retryand enableotlpmetrics receiver in default config (#1823, #1838) - Add
limit_percentageandspike_limit_percentageoptions tomemorylimiterprocessor (#1622) hostmetricsreceiver:- Collect additional labels from partitions in the filesystems scraper (#1858)
- Add filters for mount point and filesystem type (#1866)
- Add cloud.provider semantic conventions (#1865)
attributeprocessor: Add log support (#1783)- Introduce SpanID data type, not yet used in Protobuf messages ($1854, #1855)
- Enable
otlptrace by default in the released docker image (#1883) tailsamplingprocessor: Combine batches of spans into a single batch (#1864)filterprocessor: Update to use pdata (#1885)- Allow MSI upgrades (#1914)
🚩 Deprecations 🚩
- Deprecate OpenCensus-based internal data structures (#1843)
🧰 Bug fixes 🧰
prometheusreceiver: Print a more informative message about 'up' metric value (#1826)- Use custom data type and custom JSON serialization for traceid (#1840)
- Skip creation of redundant nil resource in translation from OC if there are no combined metrics (#1803)
tailsamplingprocessor: Only send to next consumer once (#1735)- Report Windows pagefile usage in bytes (#1837)
- Fix issue where Prometheus SD config cannot be parsed (#1877)
v0.11.0 Beta
🛑 Breaking changes 🛑
- Rename service.Start() to Run() since it's a blocking call
- Fix slice Append to accept by value the element in pdata
- Change CreateTraceProcessor and CreateMetricsProcessor to use the same parameter order as receivers/logs processor and exporters.
- Prevent accidental use of LogsToOtlp and LogsFromOtlp and the OTLP data structs (#1703)
- Remove SetType from configmodels, ensure all registered factories set the type in config (#1798)
- Move process telemetry to service/internal (#1794)
💡 Enhancements 💡
- Add map and array attribute value type support (#1656)
- Add authentication support to kafka (#1632)
- Implement InstrumentationLibrary translation to jaeger (#1645)
- Add public functions to export pdata to ExportXServicesRequest Protobuf bytes (#1741)
- Expose telemetry level in the configtelemetry (#1796)
- Add configauth package (#1807)
- Add config to docker image (#1792)
🧰 Bug fixes 🧰
- Use zap int argument for int values instead of conversion (#1779)
- Add support for gzip encoded payload in OTLP/HTTP receiver (#1581)
- Return proto status for OTLP receiver when failed (#1788)
v0.10.0 Beta
🛑 Breaking changes 🛑
- Update OTLP to v0.5.0, incompatible metrics protocol.
- Remove support for propagating summary metrics in OtelCollector.
- This is a temporary change, and will affect mostly OpenCensus users who use metrics.
💡 Enhancements 💡
- Support zipkin proto in
kafkareceiver (#1646) - Prometheus Remote Write Exporter supporting Cortex (#1577, #1643)
- Add deployment environment semantic convention (#1722)
- Add logs support to
batchandresourceprocessors (#1723, #1729)
🧰 Bug fixes 🧰
- Identify config error when expected map is other value type (#1641)
- Fix Kafka receiver closing ready channel multiple times (#1696)
- Fix a panic issue while processing Zipkin spans with an empty service name (#1742)
- Zipkin Receiver: Always set the endtime (#1750)
v0.9.0 Beta
🛑 Breaking changes 🛑
- Remove old base factories:
ReceiverFactoryBase(#1583)ProcessorFactoryBase(#1596)ExporterFactoryBase(#1630)
- Remove logs factories and merge with normal factories (#1569)
- Remove
reconnection_delayfrom OpenCensus exporter (#1516) - Remove
ConsumerOldinterfaces (#1631)
🚀 New components 🚀
prometheusremotewriteexporter: Send metrics data in Prometheus TimeSeries format to Cortex or any Prometheus (#1544)kafkareceiver: Receive traces from Kafka (#1410)
💡 Enhancements 💡
kafkaexporter: Enable queueing, retry, timeout (#1455)- Add
Headersfield in HTTPClientSettings (#1552) - Change OpenCensus receiver (#1556) and exporter (#1571) to the new interfaces
- Add semantic attribute for
telemetry.auto.version(#1578) - Add uptime and RSS memory self-observability metrics (#1549)
- Support conversion for OpenCensus
SameProcessAsParentSpan(#1629) - Access application version in components (#1559)
- Make Kafka payload encoding configurable (#1584)
🧰 Bug fixes 🧰
- Stop further processing if
filterprocessorfilters all data (#1500) processscraper: Use same scrape time for all data points coming from same process (#1539)- Ensure that time conversion for 0 returns nil timestamps or Time where IsZero returns true (#1550)
- Fix multiple exporters panic (#1563)
- Allow
attributeprocessor for external use (#1574) - Do not duplicate filesystem metrics for devices with many mount points (#1617)
v0.8.0 Beta
🚀 New components 🚀
groupbytraceprocessor that waits for a trace to be completed (#1362)
💡 Enhancements 💡
- Migrate
zipkinreceiver/exporter to the new interfaces (#1484) - Migrate
prometheusreceiver/exporter to the new interfaces (#1477, #1515) - Add new FactoryUnmarshaler support to all components, deprecate old way (#1468)
- Update
fileexporterto write data in OTLP (#1488) - Add extension factory helper (#1485)
- Host scrapers: Use same scrape time for all data points coming from same source (#1473)
- Make logs SeverityNumber publicly available (#1496)
- Add recently included conventions for k8s and container resources (#1519)
- Add new config StartTimeMetricRegex to
prometheusreceiver (#1511) - Convert Zipkin receiver and exporter to use OTLP (#1446)
🧰 Bug fixes 🧰
- Infer OpenCensus resource type based on OpenTelemetry's semantic conventions (#1462)
- Fix log adapter in
prometheusreceiver (#1493) - Avoid frequent errors for process telemetry on Windows (#1487)
v0.7.0 Beta
🚀 New components 🚀
- Receivers
fluentforwardruns a TCP server that accepts events via the Fluent Forward protocol (#1173)
- Exporters
kafkaexports traces to Kafka (#1439)
- Extensions
- Experimental
fluentbitfacilitates running a FluentBit subprocess of the collector (#1381)
- Experimental
💡 Enhancements 💡
- Updated
golang/protobuffrom v1.3.5 to v1.4.2 (#1308) - Updated
opencensus-protofrom v0.2.1 to v0.3.0 (#1308) - Added round_robin
balancer_nameas an option to gRPC client settings (#1353) hostmetricsreceiver- Switch to using perf counters to get disk io metrics on Windows (#1340)
- Add device filter for file system (#1379) and disk (#1378) scrapers
- Record process physical & virtual memory stats separately (#1403)
- Scrape system.disk.time on Windows (#1408)
- Add disk.pending_operations metric (#1428)
- Add network interface label to network metrics (#1377)
- Add
exporterhelper(#1351) andprocessorhelper(#1359) factories - Update OTLP to latest version (#1384)
- Disable timeout, retry on failure and sending queue for
loggingexporter (#1400) - Add support for retry and sending queue for
jaegerexporter (#1401) - Add batch size bytes metric to
batchprocessor (#1270) otlpreceiver: Add Log Support (#1444)- Allow to configure read/write buffer sizes for http Client (#1447)
- Update DB conventions to latest and add exception conventions (#1452)
🧰 Bug fixes 🧰
- Fix
resourceprocessor for old metrics (#1412) jaegerreceiver: Do not try to stop if failed to start. Collector service will do that (#1434)
v0.6.0 Beta
🛑 Breaking changes 🛑
- Renamed the metrics generated by
hostmetricsreceiver to match the (currently still pending) OpenTelemetry system metric conventions (#1261) (#1269) - Removed
vmmetricsreceiver (#1282) - Removed
cpuscraperreport_per_cpuconfig option (#1326)
💡 Enhancements 💡
- Added disk merged (#1267) and process count (#1268) metrics to
hostmetrics - Log metric data points in
loggingexporter (#1258) - Changed the
batchprocessor to not ignore the errors returned by the exporters (#1259) - Build and publish MSI (#1153) and DEB/RPM packages (#1278, #1335)
- Added batch size metric to
batchprocessor (#1241) - Added log support for
memorylimiterprocessor (#1291) andloggingexporter (#1298) - Always add tags for
observability, other metrics may use them (#1312) - Added metrics support (#1313) and allow partial retries in
queued_retryprocessor (#1297) - Update
resourceprocessor: introduceattributesconfig parameter to specify actions on attributes similar toattributesprocessor, old config interface is deprecated (#1315) - Update memory state labels for non-Linux OSs (#1325)
- Ensure tcp connection value is provided for all states, even when count is 0 (#1329)
- Set
batchprocessor channel size to num cpus (#1330) - Add
send_batch_max_sizeconfig parameter tobatchprocessor enforcing hard limit on batch size (#1310) - Add support for including a per-RPC authentication to gRPC settings (#1250)
🧰 Bug fixes 🧰
- Fixed OTLP waitForReady, not set from config (#1254)
- Fixed all translation diffs between OTLP and Jaeger (#1222)
- Disabled
processscraper for any non Linux/Windows OS (#1328)
v0.5.0 Beta
🛑 Breaking changes 🛑
- Update OTLP to v0.4.0 (#1142): Collector will be incompatible with any other sender or receiver of OTLP protocol of different versions
- Make "--new-metrics" command line flag the default (#1148)
- Change
endpointtourlin Zipkin exporter config (#1186) - Change
tls_credentialstotls_settingsin Jaeger receiver config (#1233) - OTLP receiver config change for
protocolsto support mTLS (#1223) - Remove
export_resource_labelsflag from Zipkin exporter (#1163)
🚀 New components 🚀
- Receivers
- Added process scraper to the
hostmetricsreceiver (#1047)
- Added process scraper to the
💡 Enhancements 💡
- otlpexporter: send configured headers in request (#1130)
- Enable Collector to be run as a Windows service (#1120)
- Add config for HttpServer (#1196)
- Allow cors in HTTPServerSettings (#1211)
- Add a generic grpc server settings config, cleanup client config (#1183)
- Rely on gRPC to batch and loadbalance between connections instead of custom logic (#1212)
- Allow to tune the read/write buffers for gRPC clients (#1213)
- Allow to tune the read/write buffers for gRPC server (#1218)
🧰 Bug fixes 🧰
- Handle overlapping metrics from different jobs in prometheus exporter (#1096)
- Fix handling of SpanKind INTERNAL in OTLP OC translation (#1143)
- Unify zipkin v1 and v2 annotation/tag parsing logic (#1002)
- mTLS: Add support to configure client CA and enforce ClientAuth (#1185)
- Fixed untyped Prometheus receiver bug (#1194)
- Do not embed ProtocolServerSettings in gRPC (#1210)
- Add Context to the missing CreateMetricsReceiver method (#1216)
v0.4.0 Beta
Released 2020-06-16
🛑 Breaking changes 🛑
isEnabledconfiguration option removed (#909)thrift_tchannelprotocol moved fromjaegerreceiver tojaeger_legacyin contrib (#636)
⚠️ Major changes ⚠️
- Switch from
localhostto0.0.0.0by default for all receivers (#1006) - Internal API Changes (only impacts contributors)
- Add context to
StartandStopmethods in the component (#790) - Rename
AttributeValueandAttributeMapmethod names (#781) (other breaking changes in the internal trace data types) - Change entire repo to use the new vanityurl go.opentelemetry.io/collector (#977)
- Add context to
🚀 New components 🚀
- Receivers
hostmetricsreceiver with CPU (#862), disk (#921), load (#974), filesystem (#926), memory (#911), network (#930), and virtual memory (#989) support
- Processors
batchfor batching received metrics (#1060)filterfor filtering (dropping) received metrics (#1001)
💡 Enhancements 💡
otlpreceiver implement HTTP X-Protobuf (#1021)- Exporters: Support mTLS in gRPC exporters (#927)
- Extensions: Add
zpagesfor service (servicez, pipelinez, extensions) (#894)
🧰 Bug fixes 🧰
- Add missing logging for metrics at
debuglevel (#1108) - Fix setting internal status code in
jaegerreceivers (#1105) zipkinexport fails on span without timestamp when used withqueued_retry(#1068)- Fix
zipkinreceiver status code conversion (#996) - Remove extra send/receive annotations with using
zipkinv1 (#960) - Fix resource attribute mutation bug when exporting in
jaegerproto (#907) - Fix metric/spans count, add tests for nil entries in the slices (#787)
🧩 Components 🧩
Traces
| Receivers | Processors | Exporters |
|---|---|---|
| Jaeger | Attributes | File |
| OpenCensus | Batch | Jaeger |
| OTLP | Memory Limiter | Logging |
| Zipkin | Queued Retry | OpenCensus |
| Resource | OTLP | |
| Sampling | Zipkin | |
| Span |
Metrics
| Receivers | Processors | Exporters |
|---|---|---|
| HostMetrics | Batch | File |
| OpenCensus | Filter | Logging |
| OTLP | Memory Limiter | OpenCensus |
| Prometheus | OTLP | |
| VM Metrics | Prometheus |
Extensions
- Health Check
- Performance Profiler
- zPages
v0.3.0 Beta
Released 2020-03-30
Breaking changes
- Make prometheus receiver config loading strict. #697 Prometheus receiver will now fail fast if the config contains unused keys in it.
Changes and fixes
- Enable best effort serve by default of Prometheus Exporter (https://github.com/orijtech/prometheus-go-metrics-exporter/pull/6)
- Fix null pointer exception in the logging exporter #743
- Remove unnecessary condition to have at least one processor #744
Components
| Receivers / Exporters | Processors | Extensions |
|---|---|---|
| Jaeger | Attributes | Health Check |
| OpenCensus | Batch | Performance Profiler |
| OpenTelemetry | Memory Limiter | zPages |
| Zipkin | Queued Retry | |
| Resource | ||
| Sampling | ||
| Span |
v0.2.8 Alpha
Alpha v0.2.8 of OpenTelemetry Collector
- Implemented OTLP receiver and exporter.
- Added ability to pass config to the service programmatically (useful for custom builds).
- Improved own metrics / observability.
- Refactored component and factory interface definitions (breaking change #683)
v0.2.7 Alpha
Alpha v0.2.7 of OpenTelemetry Collector
- Improved error handling on shutdown
- Partial implementation of new metrics (new obsreport package)
- Include resource labels for Zipkin exporter
- New
HASHaction to attribute processor
v0.2.6 Alpha
Alpha v0.2.6 of OpenTelemetry Collector.
- Update metrics prefix to
otelcoland expose command line argument to modify the prefix value. - Extend Span processor to have include/exclude span logic.
- Batch dropped span now emits zero when no spans are dropped.
v0.2.5 Alpha
Alpha v0.2.5 of OpenTelemetry Collector.
- Regexp-based filtering of spans based on service names.
- Ability to choose strict or regexp matching for include/exclude filters.
v0.2.4 Alpha
Alpha v0.2.4 of OpenTelemetry Collector.
- Regexp-based filtering of span names.
- Ability to extract attributes from span names and rename span.
- File exporter for debugging.
- Span processor is now enabled by default.
v0.2.3 Alpha
Alpha v0.2.3 of OpenTelemetry Collector.
Changes:
21a70d6 Add a memory limiter processor (#498)
9778b16 Refactor Jaeger Receiver config (#490)
ec4ad0c Remove workers from OpenCensus receiver implementation (#497)
4e01fa3 Update k8s config to use opentelemetry docker image and configuration (#459)
v0.2.2 Alpha
Alpha v0.2.2 of OpenTelemetry Collector.
Main changes visible to users since previous release:
- Improved Testbed and added more E2E tests.
- Made component interfaces more uniform (this is a breaking change).
Note: v0.2.1 never existed and is skipped since it was tainted in some dependencies.
v0.2.0 Alpha
Alpha v0.2 of OpenTelemetry Collector.
Docker image: omnition/opentelemetry-collector:v0.2.0 (we are working on getting this under an OpenTelemetry org)
Main changes visible to users since previous release:
-
Rename from
servicetocollector, the binary is now namedotelcol -
Configuration reorganized and using strict mode
-
Concurrency issues for pipelines transforming data addressed
Commits:
0e505d5 Refactor config: pipelines now under service (#376)
402b80c Add Capabilities to Processor and use for Fanout cloning decision (#374)
b27d824 Use strict mode to read config (#375)
d769eb5 Fix concurrency handling when data is fanned out (#367)
dc6b290 Rename all github paths from opentelemetry-service to opentelemetry-collector (#371)
d038801 Rename otelsvc to otelcol (#365)
c264e0e Add Include/Exclude logic for Attributes Processor (#363)
8ce427a Pin a commit for Prometheus dependency in go.mod (#364)
2393774 Bump Jaeger version to 1.14.0 (latest) (#349)
63362d5 Update testbed modules (#360)
c0e2a27 Change dashes to underscores to separate words in config files (#357)
7609eaa Rename OpenTelemetry Service to Collector in docs and comments (#354)
bc5b299 Add common gRPC configuration settings (#340)
b38505c Remove network access popups on macos (#348)
f7727d1 Fixed loop variable pointer bug in jaeger translator (#341)
958beed Ensure that ConsumeMetricsData() is not passed empty metrics in the Prometheus receiver (#345)
0be295f Change log statement in Prometheus receiver from info to debug. (#344)
d205393 Add Owais to codeowners (#339)
8fa6afe Translate OC resource labels to Jaeger process tags (#325)
v0.0.2 Alpha
Alpha release of OpenTelemetry Service.
Docker image: omnition/opentelemetry-service:v0.0.2 (we are working on getting this under an OpenTelemetry org)
Main changes visible to users since previous release:
8fa6afe Translate OC resource labels to Jaeger process tags (#325)
047b0f3 Allow environment variables in config (#334)
96c24a3 Add exclude/include spans option to attributes processor (#311)
4db0414 Allow metric processors to be specified in pipelines (#332)
c277569 Add observability instrumentation for Prometheus receiver (#327)
f47aa79 Add common configuration for receiver tls (#288)
a493765 Refactor extensions to new config format (#310)
41a7afa Add Span Processor logic
97a71b3 Use full name for the metrics and spans created for observability (#316)
fed4ed2 Add support to record metrics for metricsexporter (#315)
5edca32 Add include_filter configuration to prometheus receiver (#298)
0068d0a Passthrough CORS allowed origins (#260)
v0.0.1 Alpha
This is the first alpha release of OpenTelemetry Service.
Docker image: omnition/opentelemetry-service:v0.0.1