v0.103.0

The OpenTelemetry Collector Contrib contains everything in the opentelemetry-collector release, be sure to check the release notes there as well.

End User Changelog

🛑 Breaking changes 🛑

• cmd/opampsupervisor,extension/opamp: Upgrade the opamp-go library to v0.15.0 (#33416)
  With this change, UUIDv7 is recommended for the OpAMP extension's instance_uid field instead of ULID. ULIDs will continue to work, but may be displayed as UUIDs.
  The supervisor's persistent state (${storage_dir}/persistent_state.yaml) will need to be cleared to generate a new UUIDv7 instead of a ULID.
  This change may be incompatible with management servers using v0.14.0 of opamp-go.

• mongodbreceiver: Now only supports TCP connections (#32199)
  This fixes a bug where hosts had to explicitly set tcp as the transport type. The transport option has been removed.

• cmd/configschema: Removes the deprecated configschema command. This command will no longer be released or supported. (#33384)

• sqlserverreceiver: sqlserver.database.io.read_latency has been renamed to sqlserver.database.latency with a direction attribute. (#29865)

🚩 Deprecations 🚩

• healthcheckextension: Remove incorrect logic behind check_collector_pipeline config (#33469)
  This logic incorrectly set the pipeline to OK after waiting for enough callbacks from the
  opencensus library to be called. As this was broken, I'm removing it to remove the dependency
  on opencensus as well. Improvements will be available via healthcheckv2 extension.

• googlecloudspannerreceiver: Mark the component as unmaintained. If we don't find new maintainers, it will be deprecated and removed. (#32651)

💡 Enhancements 💡

• filelogreceiver: If include_file_record_number is true, it will add the file record number as the attribute log.file.record_number (#33530)

• kubeletstats: Add k8s.pod.cpu.node.utilization metric (#33390)

• awss3exporter: endpoint should contain the S3 bucket (#32774)

• awss3receiver: Add support for encoding extensions to be used in the AWS S3 Receiver. (#30750)

• gitproviderreceiver: Adds branch commit and line based metrics (#22028)
  Adds the following branch based metrics.

  • git.repository.branch.time
  • git.repository.branch.commit.aheadby.count
  • git.repository.branch.commit.behindby.count
  • git.repository.branch.line.deletion.count
  • git.repository.branch.line.addition.count

• statsdreceiver: update statsd receiver to use mdatagen (#33524)

• coralogixexporter: Allow setting application name from cx.application.name and cx.subsystem.name resource attributes (#33217)

• metricstransformprocessor: Adds the 'count' aggregation type to the Metrics Transform Processor. (#24978)

• elasticsearchexporter: Add support for confighttp options, notably "auth". (#33367)
  Add support for confighttp and related configuration settings, such as "auth".
  This change also means that the Elasticsearch URL may be specified as "endpoint",
  like the otlphttp exporter.

• elasticsearchexporter: Check that endpoints are valid URLs during config validation. (#33350)
  Check that endpoints are valid URLs during config validation so that
  an invalid endpoint causes a fatal error during startup, rather than
  leading to a persistent runtime error.

• opampsupervisor: Add config validation for the supervisor config (#32843)

• statsdreceiver: Added received/accepted/refused metrics (#24278)

• filelogreceiver: Add support for gzip compressed log files (#2328)

• confmap/provider/secretsmanagerprovider: Add support for JSON formatted secrets in secretsmanagerprovider confmap (#32143)
  The secretsmanagerprovider confmap will now allow to get secret by a json key if the secret value is json.
  To specify key separate key from secret name/arn by # e.g. mySecret#mySecretKey.

• geoipprocessor: Add initial processing based on source.address resource attribute (#32663)

• healthcheckv2extension: Add shared aggregation logic for status events. (#26661)

• tailsamplingprocessor: Simple LRU Decision Cache for "keep" decisions (#31583)

• processor/tailsampling: Migrates internal telemetry to OpenTelemetry SDK via mdatagen (#31581)
  The metric names and their properties, such as bucket boundaries for histograms, were kept like before, to keep backwards compatibility.

• kafka: Added disable_fast_negotiation configuration option for Kafka Kerberos authentication, allowing the disabling of PA-FX-FAST negotiation. (#26345)

• pkg/ottl: Added keep_matching_keys function to allow dropping all keys from a map that don't match the pattern. (#32989)

• OTel-Arrow: Update to OTel-Arrow v0.24.0 (#26491)

• pkg/ottl: Add debug logs to help troubleshoot OTTL statements/conditions (#33274)

• pkg/ottl: Introducing append function for appending items into an existing array (#32141)

• pkg/ottl: Introducing Uri converter parsing URI string into SemConv (#32433)

• probabilisticsamplerprocessor: Add Proportional and Equalizing sampling modes (#31918)
  Both the existing hash_seed mode and the two new modes use OTEP 235 semantic conventions to encode sampling probability.

• prometheusreceiver: Resource attributes produced by the prometheus receiver now include stable semantic conventions for server and url. (#32814)
  To migrate from the legacy net.host.name, net.host.port, and http.scheme resource attributes, |
  migrate to server.address, server.port, and url.scheme, and then |
  set the receiver.prometheus.removeLegacyResourceAttributes feature gate.

• datadogexporter: The Datadog Exporter now supports the proxy_url parameter to configure an HTTP proxy to use when sending telemetry to Datadog. (#33316)

• spanmetrics: Produce delta temporality span metrics with StartTimeUnixNano and TimeUnixNano values representing an uninterrupted series (#31671, #30688)
  This allows producing delta span metrics instead of the more memory-intensive cumulative metrics, specifically when a downstream component can convert the delta metrics to cumulative.

• sqlserverreceiver: Add support for more Database IO metrics (#29865)
  The following metrics have been added:

  • sqlserver.database.latency
  • sqlserver.database.io
  • sqlserver.database.operations

• cmd/opampsupervisor: Receive and report effective config to the OpAMP server (#30622)

• processor/transform: Add transform.flatten.logs featuregate to give each log record a distinct resource and scope. (#32080)
  This option is useful when applying transformations which alter the resource or scope. e.g. set(resource.attributes["to"], attributes["from"]), which may otherwise result in unexpected behavior. Using this option typically incurs a performance penalty as the processor must compute many hashes and create copies of resource and scope information for every log record.

• receiver/windowsperfcounters: Counter configuration now supports recreating the underlying performance query at scrape time. (#32798)

🧰 Bug fixes 🧰

• filelogreceiver: Container parser should add k8s metadata as resource attributes and not as log record attributes (#33341)
• deltatocumulative: properly drop samples when at limit (#33285)
  fixes a segfault in the limiting behavior, where streams exceeding the limit still had their samples processed. due to not being tracked, this led to a nil-pointer deref
• postgresqlreceiver: Fix bug where postgresql.rows always returning 0 for state="dead" (#33489)
• prometheusreceiver: Fall back to scrape config job/instance labels for aggregated metrics without instance/job labels (#32555)
• elasticsearchexporter: Duplicate Key in JSON (#33454)
• logzioexporter: Fix issue where log attributes were not correctly exported (#33231)
• exporter/datadog: Prevents collector shut down when Datadog logs pipeline fails to validate API key (#33195)

API Changelog

🛑 Breaking changes 🛑

• stanza: remove deprecated code (#33519)
  This change removes:
  • adapter.LogEmitter, use helper.LogEmitter instead
  • adapter.NewLogEmitter, use helper.NewLogEmitter instead
  • fileconsumer.Manager's SugaredLogger struct member
  • pipeline.DirectedPipeline's SugaredLogger struct member
  • testutil.Logger, use zaptest.NewLogger instead

💡 Enhancements 💡

• pkg/winperfcounters: It is now possible to force a watcher to re-create the PDH query of a given counter via the Reset() function. (#32798)

v0.102.0

The OpenTelemetry Collector Contrib contains everything in the opentelemetry-collector release, be sure to check the release notes there as well.

End User Changelog

🛑 Breaking changes 🛑

• k8sattributesprocessor: Move k8sattr.rfc3339 feature gate to stable. (#33304)

• extension/opamp: Redact all values in the effective config (#33267)
  All values will be treated as if they are a configopaque.String type. This will
  be changed once the Collector APIs are updated to unmarshal the config while
  only redacting actual configopaque.String-typed values.

  The exception to redaction is the service::pipelines section, which is useful
  for debugging and does not contain any configopaque.String values.

• extension/filestorage: Replace path-unsafe characters in component names (#3148)
  The feature gate extension.filestorage.replaceUnsafeCharacters is now removed.

• vcenterreceiver: vcenterreceiver replaces deprecated packet metrics by removing them and enabling by default the newer ones. (#32929, #32835)
  Removes the following metrics: vcenter.host.network.packet.errors, vcenter.host.network.packet.count, and
  vcenter.vm.network.packet.count.

  Also enables by default the following metrics: vcenter.host.network.packet.error.rate,
  vcenter.host.network.packet.rate, and vcenter.vm.network.packet.rate.

🚀 New components 🚀

• geoipprocessor: introduce the GeoIP processor (#32663)

💡 Enhancements 💡

• pkg/ottl: Add the Day Converter to extract the int Day component from a time.Time (#33106)
• pkg/ottl: Adds Month converter to extract the int Month component from a time.Time (#33106)
• cmd/telemetrygen: Add support for adding spanID and traceID as exemplars to datapoints generated by telemetrygen (#33320)
• cmd/telemetrygen: Add support for specifying trace ID and span ID in telemetrygen for logs (#33234)
• pkg/ottl: Adds a Year converter for extracting the int year component from a time.Time (#33106)
• filelogreceiver: Log when files are rotated/moved/truncated (#33237)
• stanza: Add monitoring metrics for open and harvested files in fileconsumer (#31256)
• awss3receiver: Uses obsreport to report metrics for the AWS S3 Receiver. (#30750)
• awsxrayexporter: AWS X-Ray exporter to make local root spans a segment for internal/service spans and subsegment + segment for client/producer/consumer spans. (#33000)
• prometheusreceiver: Allow to configure http client used by target allocator generated scrape targets (#18054)
• clickhouseexporter: Add create_schema option to ClickHouse exporter (#32282)
  The new create_schema option allows disabling default DDL to let the user manage their own schema.
• pkg/stanza: Expose recombine max log size option in the container parser configuration (#33186)
• sumologicexporter: add support for tracing (#32315)
• exceptionsconnector: Add support for exemplars in exceptionsconnector (#24409)
• processor/resourcedetectionprocessor: Add support for Azure tags in ResourceDetectionProcessor. (#32953)
• solarwindsapmsettingsextension: Added the first part of concrete implementation of solarwindsapmsettingsextension (#27668)
• kubeletstatsreceiver: Add k8s.container.cpu.node.utilization metric (#27885)
• pkg/ottl: Adds a Minute converter for extracting the int minute component from a time.Time (#33106)

🧰 Bug fixes 🧰

• podmanreceiver: add scraper's shutdown method (#29994)
• awsxrayexporter: Fix the DB subsegment(client span) name with JDBC conn string starts with "jdbc:" (#33225)
• exp/metrics: fixes staleness.Evict such that it only ever evicts actually stale metrics (#33265)
• receiver/mysql: Remove the order by clause for the column that does not exist (#33271)
• influxdb(exporter|receiver): remove Metric flags field to/from InfluxDB conversion (#29896)
• kafkareceiver: Fix bug that was blocking shutdown (#30789)
• exporter/datadog: Fixes a potential race condition when the traces exporter and metrics exporter are both shutting down. (#33291)

API Changelog

💡 Enhancements 💡

• prometheusreceiver: Allow to configure http client used by target allocator generated scrape targets (#18054)

🧰 Bug fixes 🧰

• exp/metrics: fixes staleness.Evict such that it only ever evicts actually stale metrics (#33265)

v0.101.0

The OpenTelemetry Collector Contrib contains everything in the opentelemetry-collector release, be sure to check the release notes there as well.

End User Changelog

🛑 Breaking changes 🛑

• sumologicexporter: change logs behavior (#31479)

  • set OTLP as default format
  • add support for OTLP format
  • do not support metadata attributes
  • do not support source headers

• sumologicexporter: change metrics behavior (#31479)

  • remove suppport for carbon2 and graphite
  • add support for otlp format
  • do not support metadata attributes
  • do not support source headers
  • set otlp as default metrics format

• sumologicexporter: remove deprecated configuration options (#32315)
  migration has been described in the following document
  https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.100.0/exporter/sumologicexporter#migration-to-new-architecture

• remotetapprocessor: Make the limit configuration work properly. (#32385)
  The limit configuration was ignored previously, but now it works according to the configuration and documentation.
  Nothing is required of users.
  See the remotetapprocessor's README.md for details.

• groupbytraceprocessor: Fix groupbytrace metrics contain duplicate prefix (#32698)

• vcenterreceiver: Removes vcenter.cluster.name attribute from vcenter.datastore metrics (#32674)
  If there were multiple Clusters, Datastore metrics were being repeated under Resources differentiated with a
  vcenter.cluster.name resource attribute. In the same vein, if there were standalone Hosts, in addition to
  clusters the metrics would be repeated under a Resource without the vcenter.cluster.name attribute. Now there
  will only be a single set of metrics for one Datastore (as there should be, as Datastores don't belong to
  Clusters).

• resourcedetectionprocessor: Move processor.resourcedetection.hostCPUModelAndFamilyAsString feature gate to stable. (#29025)

• filelog, journald, tcp, udp, syslog, windowseventlog receivers: The internal logger has been changed from zap.SugaredLogger to zap.Logger. (#32177)
  This should not have any meaningful impact on most users but the logging format for some logs may have changed.

• awsxrayexporter: change x-ray exporter's translator to make "." split annotation pass as-is (#32694, #31732)
  This change make below change to beta stage for feature gate 'exporter.xray.allowDot'，this change will let the change mention below enable by default | In the past, X-Ray doesn’t support “.”. So we have a translator in x-ray export to translates it to “_” before sending traces to X-Ray Service. | To match otel naming style, x-ray service team decide to change their service to support both "." type and "" type of naming. In this case the translator that translate "." to "" is no-longer needed. This PR change the way this translator work | X-Ray PMs agree on rolling out this change by using feature-gate

🚀 New components 🚀

• awss3receiver: Initial implementation of the AWS S3 receiver. (#30750)

• receiver/mysql: Adds INFORMATION_SCHEMA TABLES metrics (#32693)
  This adds table size metrics using the INFORMATION_SCHEMA TABLES table: https://dev.mysql.com/doc/refman/8.3/en/information-schema-tables-table.html.
  Specifically, we are adding the columns: TABLE_ROWS, AVG_ROW_LENGTH, DATA_LENGTH, INDEX_LENGTH.

• exporter/otelarrow: Implementation copied from opentelemetry/otel-arrow repository @v0.23.0. (#26491)

💡 Enhancements 💡

• filelogreceiver: Add container operator parser (#31959)

• jsonlogencodingextension: Move jsonlogencodingextension to alpha (#32697)

• exceptionsconnector: Make span name a default dimension for ouput metrics and log records. (#32162)

• azureblobreceiver: Support service principal authentication for Blob storage (#32705)

• deltatocumulativeprocessor: exponential histogram accumulation (#31340)
  accumulates exponential histogram datapoints by adding respective bucket counts. also handles downscaling, changing zero-counts, offset adaptions and optional fields

• sumologicexporter: add sticky session support (#32315)

• elasticsearchexporter: Replace go-elasticsearch BulkIndexer with go-docappender (#32378)
  Replace go-elasticsearch BulkIndexer with go-docappender bulk indexer, in preparation for future reliability fixes.
  As a result of this change, there are minor behavioral differences:

  • flush timeout is now enforced on client side
  • oversize payload special handling is now removed
  • go-docappender uses bulk request filterPath which means bulk response is smaller, less JSON parsing and lower CPU usage
  • document level retry debug logging is removed as retries are done transparently

• elasticsearchexporter: Converts more SemConv fields in OTel events to ECS fields in Elasticsearch documents when mapping.mode: ecs is specified. (#31694)

• extension/storage/filestorage: New flag cleanup_on_start for the compaction section (default=false). (#32863)
  It will remove all temporary files in the compaction directory (those which start with tempdb),
  temp files will be left if a previous run of the process is killed while compacting.

• opampsupervisor: Allows the supervisor to persist its instance ID between restarts. (#21073)

• opampsupervisor: Adds the ability to configure the agent description (#32824)

• vcenterreceiver: Refactors how and when client makes calls in order to provide for faster collection times. (#31837)

• resourcedetectionprocessor: Support GCP Bare Metal Solution in resource detection processor. (#32985)

• splunkhecreceiver: Make the channelID header check case-insensitive and allow hecreceiver endpoints able to extract channelID from query params (#32995)

• processor/transform: Allow common where clause (#27830)

• loadbalancingexporter: Improve the performance when merging traces belonging to the same backend (#32032)

• pkg/ottl: Added support for timezone in Time converter (#32140)

• jsonlogencodingextension: Adds a new encoding option for JSON log encoding exension to grab attributes and resources from a log and output that in JSON format. (#32679)

• probabilisticsamplerprocessor: Adds the FailClosed flag to solidify current behavior when randomness source is missing. (#31918)

• prometheusremotewriteexporter: Add exporter.prometheusremotewritexporter.RetryOn429 feature gate to retry on http status code 429 response. (#31032)
  The feature gate is initially disabled by default.

• vcenterreceiver: Changing various default configurations for vcenterreceiver and removing warnings about future release. (#32803, #32805, #32821, #32531, #32557)
  The resource attributes that will now be enabled by default are vcenter.datacenter.name, vcenter.virtual_app.name,
  vcenter.virtual_app.inventory_path, vcenter.vm_template.name, and vcenter.vm_template.id. The metric
  vcenter.cluster.memory.used will be removed. The metrics vcenter.cluster.vm_template.count and
  vcenter.vm.memory.utilization will be enabled by default.

• sqlserverreceiver: Add metrics for database status (#29865)

• sqlserverreceiver: Add more metrics (#29865)
  Added metrics are:

  • sqlserver.resource_pool.disk.throttled.read.rate
  • sqlserver.resource_pool.disk.throttled.write.rate
  • sqlserver.processes.blocked
    These metrics are only available when directly connecting to the SQL server instance

• extension/encoding/text_encoding: Add support for marshaling and unmarshaling text with separators. (#32679)

🧰 Bug fixes 🧰

• deltatocumulativeprocessor: Evict only stale streams (#33014)
  Changes eviction behavior to only evict streams that are actually stale.
  Currently, once the stream limit is hit, on each new stream the oldest tracked one is evicted.
  Under heavy load this can rapidly delete all streams over and over, rendering the processor useless.

• elasticsearchexporter: Retried docs are no longer included in failed docs in an edge case where all errors are retriable (#33092)
  Update dep go-docappender to 2.1.2.
  This fixes the bug when all errors are retriable in bulk request response, retried docs will be included in failed docs.

• cmd/opampsupervisor: The OpAMP supervisor now configures the ppid parameter of the opamp extension, which allows the collector to shut down if the supervisor is no longer running. (#32189)

• vcenterreceiver: Adds inititially disabled packet drop rate metric for VMs. (#32929)

• awskinesisexporter: fixed compressed data not generating the compression footers (#32860)

• splunkhecreceiver: Fix single metric value parsing (#33084)

• vcenterreceiver: vcenterreceiver client no longer returns error if no Virtual Apps are found. (#33073)

• vcenterreceiver: Adds inititially disabled new packet rate metrics to replace the existing ones for VMs & Hosts. (#32835)

• googlecloudpubsubreceiver: Fix memory leak during shutdown (#32361)

• datadogexporter: Compress host metadata before sending with gzip. (#32992)

• resourcedetectionprocessor: Change type of host.cpu.stepping from int to string. (#31136)

  • Disable the processor.resourcedetection.hostCPUSteppingAsString feature gate to get the old behavior.

• pkg/ottl: Fixes a bug where function name could be used in a condition, resulting in a cryptic error message. (#33051)

API Changelog

🛑 Breaking changes 🛑

• opampextension: Move custom message interfaces to separate package (#32950)
  Moves CustomCapabilityRegistry, CustomCapabilityHandler, and CustomCapabilityRegisterOption to a new module.
  These types can now be found in the new github.com/open-telemetry/opentelemetry-collector-contrib/extension/opampcustommessages module.

• `pkg/stan...

v0.100.0

The OpenTelemetry Collector Contrib contains everything in the opentelemetry-collector release, be sure to check the release notes there as well.

End User Changelog

🛑 Breaking changes 🛑

• receiver/hostmetrics: enable feature gate receiver.hostmetrics.normalizeProcessCPUUtilization (#31368)
  This changes the value of the metric process.cpu.utilization by dividing it by the number of CPU cores.
  For example, if a process is using 2 CPU cores on a 16-core machine,
  the value of this metric was previously 2, but now it will be 0.125.

• testbed: Remove deprecated GetAvailablePort function (#32800)

🚀 New components 🚀

• healthcheckv2extension: Introduce the skeleton for the temporary healthcheckv2 extension. (#26661)
• intervalprocessor: Implements the new interval processor. See the README for more info about how to use it (#29461)
• OpenTelemetry Protocol with Apache Arrow Receiver: Implementation copied from opentelemetry/otel-arrow repository @v0.20.0. (#26491)
• roundrobinconnector: Add a roundrobin connector, that can help single thread components to scale (#32853)

💡 Enhancements 💡

• telemetrygen: Add support to set metric name (#32840)

• exporter/kafkaexporter: Enable setting message topics using resource attributes. (#31178)

• exporter/datadog: Introduces the Datadog Agent logs pipeline for exporting logs to Datadog under the "exporter.datadogexporter.UseLogsAgentExporter" feature gate. (#32327)

• elasticsearchexporter: Add retry.retry_on_status config (#32584)
  Previously, the status codes that trigger retries were hardcoded to be 429, 500, 502, 503, 504.
  It is now configurable using retry.retry_on_status, and defaults to [429, 500, 502, 503, 504] to avoid a breaking change.
  To avoid duplicates, it is recommended to configure retry.retry_on_status to [429], which would be the default in a future version.

• exporter/splunkhec: add experimental exporter batcher config (#32545)

• windowsperfcountersreceiver: Returns partial errors for failures during scraping to prevent throwing out all successfully retrieved metrics (#16712)

• jaegerencodingextension: Promote jaegerencodingextension to alpha (#32699)

• kafkaexporter: add an ability to publish kafka messages with message key based on metric resource attributes - it will allow partitioning metrics in Kafka. (#29433, #30666, #31675)

• cmd/opampsupervisor: Switch the OpAMP Supervisor's bootstrap config to use the nopreceiver and nopexporter (#32455)

• otlpencodingextension: Move otlpencodingextension to alpha (#32701)

• prometheusreceiver: Prometheus receivers and exporters now preserve 'unknown', 'info', and 'stateset' types. (#16768)
  It uses the metric.metadata field with the 'prometheus.type' key to store the original type.

• ptracetest: Add support for ignore scope span instrumentation scope information (#32852)

• sqlserverreceiver: Enable direct connection to SQL Server (#30297)
  Directly connecting to SQL Server will enable the receiver to gather more metrics
  for observing the SQL Server instance. The first metric added with this update is
  sqlserver.database.io.read_latency.

• connector/datadog: The Datadog connector now has a config option to identify top-level spans by span kind. This new logic can be enabled by setting traces::compute_top_level_by_span_kind to true in the Datadog connector config. Default is false. (#32005)
  traces::compute_top_level_by_span_kind needs to be enabled in both the Datadog connector and Datadog exporter configs if both components are being used.
  With this new logic, root spans and spans with a server or consumer span.kind will be marked as top-level. Additionally, spans with a client or producer span.kind will have stats computed.
  Enabling this config option may increase the number of spans that generate trace metrics, and may change which spans appear as top-level in Datadog.

• exporter/datadog: The Datadog exporter now has a config option to identify top-level spans by span kind. This new logic can be enabled by setting traces::compute_top_level_by_span_kind to true in the Datadog exporter config. Default is false. (#32005)
  traces::compute_top_level_by_span_kind needs to be enabled in both the Datadog connector and Datadog exporter configs if both components are being used.
  With this new logic, root spans and spans with a server or consumer span.kind will be marked as top-level. Additionally, spans with a client or producer span.kind will have stats computed.
  Enabling this config option may increase the number of spans that generate trace metrics, and may change which spans appear as top-level in Datadog.

• exporter/datadog: Support stable semantic conventions for HTTP spans (#32823)

• cmd/opampsupervisor: Persist collector remote config & telemetry settings (#21078)

• cmd/opampsupervisor: Support AcceptsRestartCommand Capability. (#21077)

• telemetrygen: Add headers to gRPC metadata for logs (#32668)

• sshcheckreceiver: Add support for running this receiver on Windows (#30650)

• zipkinencodingextension: Move zipkinencodingextension to alpha (#32702)

🧰 Bug fixes 🧰

• prometheusremotewrite: Modify prometheusremotewrite.FromMetrics to only generate target_info if there are metrics, as otherwise you can't deduce the timestamp. (#32318)

• prometheusremotewrite: Change prometheusremotewrite.FromMetrics so that the target_info metric is only generated if at least one identifying OTel resource attribute (service.name and/or service.instance.id) is defined. (#32148)

• k8sclusterreceiver: Fix container state metadata (#32676)

• sumologicexporter: do not replace . with _ for prometheus format (#31479)

• pkg/stanza: Allow sorting by ascending order when using the mtime sort_type. (#32792)

• opampextension: Add a new ppid parameter that can be used to enable orphan detection for the supervisor. (#32189)

• awsxrayreceiver: Retain CloudWatch Log Group when translating X-Ray segments (#31784)

• pkg/stanza: Fix issue when exclude_older_than is enabled without ordering_criteria configured (#32681)

• awskinesisexporter: the compressor was crashing under high load due it not being thread safe. (#32589)
  removed compressor abstraction and each execution has its own buffer (so it's thread safe)

• filelogreceiver: When a flush timed out make sure we are at EOF (can't read more) (#31512, #32170)

• vcenterreceiver: Adds the vcenter.cluster.name resource attribute to resource pool with a ClusterComputeResource parent (#32535)

• vcenterreceiver: Updates vcenter.cluster.memory.effective (primarily that the value was reporting MiB when it should have been bytes) (#32782)

• vcenterreceiver: Adds warning to vcenter.cluster.memory.used metric if configured about its future removal (#32805)

• vcenterreceiver: Updates the vcenter.cluster.vm.count metric to also report suspended VM counts (#32803)

• vcenterreceiver: Adds vcenter.datacenter.name attributes to all resource types to help with resource identification (#32531)

• vcenterreceiver: Adds vcenter.cluster.name attributes warning log related to Datastore resource (#32674)

• vcenterreceiver: Adds new vcenter.virtual_app.name and vcenter.virtual_app.inventory_path resource attributes to appropriate VM Resources (#32557)

• vcenterreceiver: Adds functionality for vcenter.vm.disk.throughput while also changing to a gauge. (#32772)

• vcenterreceiver: Adds initially disabled functionality for VM Templates (#32821)

• remotetapprocessor: Fix memory leak on shutdown (#32571)

• haproxyreceiver: Fix reading stats larger than 4096 bytes (#32652)

• connector/count: Fix handling of non-string attributes in the count connector (#30314)

• datadogexporter: Fix nil pointer dereference when using beta infrastructure monitoring offering (#32865)
  The bug happened under the following conditions:

  • Setting datadog.host.use_as_host_metadata to true on a payload with data about the Datadog exporter host
  • Running using the official opentelemetry-collector-contrib Docker image

• pkg/translator/jaeger: translate binary attribute values to/from Jaeger as is, without encoding them as base64 strings (#32204)

• awscloudwatchreceiver: Fixed a bug where autodiscovery would not use nextToken in the paginated request (#32053)

• awsxrayexporter: make comma, as invalid char for x-ray segment name (#32610)

API Changelog

🛑 Breaking changes 🛑

• pkg/stanza: Pass TelemetrySettings to the Build method of the Builder interface (#32662, #31256)
  The reason for this breaking change is to pass in the component.TelemetrySettings
  so as to use them later in various ways:
  • be able to report state statistics and telemetry in general
  • be able to switch from SugaredLogger to Logger

🚩 Deprecations 🚩

• confmap/provider/s3: Deprecate s3provider.New in favor of s3provider.NewFactory (#32742)
• confmap/provider/secretsmanager: Deprecate secretsmanagerprovider.New in favor of secretsmanagerprovider.NewFactory (#32743)

🚀 New components 🚀

• roundrobinconnector: Add a roundrobin connector, that can help single thread components to scale (#32853)

💡 Enhancements 💡

• opampextension: Added support for other components to register custom capabilities and receive custom messages from an opamp extension (#32021)
• kafkaexporter: add an ability to publish kafka messages with message key based on metric resource attributes - it will allow partitioning metrics in Kafka. (#29433, #30666, #31675)
• sshcheckreceiver: Add support for running this receiver on Windows (#30650)

v0.99.0

The OpenTelemetry Collector Contrib contains everything in the opentelemetry-collector release, be sure to check the release notes there as well.

End User Changelog

🛑 Breaking changes 🛑

• dynatraceexporter: remove deprecated component (#32278)

• extension/filestorage: Replace path-unsafe characters in component names (#3148)
  The feature gate extension.filestorage.replaceUnsafeCharacters is now stable and cannot be disabled.
  See the File Storage extension's README for details.

• gitproviderreceiver: Changed git provider metrics to better match conventions (#31985)

  • Renamed git.repository.pull_request.open.time to git.repository.pull_request.time_open
  • Renamed git.repository.pull_request.merged.time to git.repository.pull_request.time_to_merge
  • Renamed git.repository.pull_request.approved.time to git.repository.pull_request.time_to_approval
  • Combined git.repository.pull_request.merged.count and git.repository.pull_request.open.count into git.repository.pull_request.count with an attribute of pull_request.state equal to open or merged

• all: Bump minimum version to go 1.21.0 (#32451)

• exporter/loadbalancing: Change AWS Cloud map resolver config fields from camelCase to snake_case. (#32331)
  The snake_case is required in OTel Collector config fields. It used to be enforced by tests in cmd/oteltestbedcol,
  but we had to disable them. Now, the tests are going to be enforced on every component independently.
  Hence, the camelCase config fields recently added with the new AWS Cloud Map resolver has to be fixed.

• connector/servicegraphconnector: Change connector.servicegraph.virtualNode feature gate from Alpha to Beta (now enabled by default) and change virtual_node_peer_attributes default values. (#31734)

🚀 New components 🚀

• googleclientauthextension: Add implementation of Google Client Auth Extension. (#32029)
• ackextension: Promote to alpha stability (#26376)

💡 Enhancements 💡

• deltatocumulativeprocessor: exposes max_stale as metric (#32441)
• sumologicexporter: use Sumo Logic Extension for authentication and to obtain endpoint (#31479)
• failoverconnector: This change puts the failoverconnector into alpha (#20766)
• vcenterreceiver: Changes process for collecting VMs & VM perf metrics used by the vccenterreceiver to be more efficient (one call now for all VMs) (#31837)
• opampextension: Added a new agent_description.non_identifying_attributes config option to allow setting user-defined non-identifying attributes (#32107)
• googleclientauthextension: Mark Google Client Auth Extension alpha stability. (#32442)
• splunkhecreceiver: adding support for ack in the splunkhecreceiver (#26376)
• hostmetricsreceiver: The hostmetricsreceiver now caches the system boot time at receiver start and uses it for all subsequent calls. The featuregate hostmetrics.process.bootTimeCache can be disabled to restore previous behaviour. (#28849)
  This change was made because it greatly reduces the CPU usage of the process and processes scrapers.
• filelogreceiver: Add send_quiet and drop_quiet options for on_error setting of operators (#32145)
• otlpjsonfilereceiver: Add a replay_file config option to support replaying static telemetry (#31533)
• pkg/ottl: Add IsList OTTL Function (#27870)
• rabbitmqexporter: Implements the RabbitMQ exporter (#28891)
• filelogreceiver: Add exclude_older_than configuration setting (#31053)
• pkg/stanza/operator/transformer/recombine: add a new "max_unmatched_batch_size" config parameter to configure the maximum number of consecutive entries that will be combined into a single entry before the match occurs (#31653)
• awsxrayreceiver: Add support for local namespace in subsegment (#31514)

🧰 Bug fixes 🧰

• awscloudwatchreceiver: The receiver now supports extracting data from named loggroups without requiring filters for log streams. This was already advertised as feature, but ignored during initialization. (#32345)
• awskinesisexporter: Wraps the AssumeRoleProvider in a CachedCredentials provider, in the case the AWS role is specified. This prevents a role assumption from happening every API call. (#32415)
• receiver/hostmetricsreceiver: do not extract the cpu count if the metric is not enabled; this will prevent unnecessary overhead, especially on windows (#32133)
• azuremonitorexporter: Fix: Use correct parentId for span events. (#27233)
• failoverconnector: This change adds a fix for an identified bug regarding extra failover switches (#32094)
• failoverconnector: Fix flaky test in pipeline selector component (#32396)
• pkg/stanza: Fix race condition which prevented jsonArrayParserFeatureGate from working correctly. (#32313)
• cmd/opampsupervisor: Fix collector subprocess not being stopped if bootstrapping fails (#31943)
• vcenterreceiver: Remove the vcenter.cluster.name resource attribute from Host resources if the Host is standalone (no cluster) (#32548)
• azureeventhubreceiver: Fix memory leak on shutdown (#32401)
• fluentforwardreceiver: Fix memory leak (#32363)
• processor/resourcedetection, exporter/datadog: Fix memory leak on AKS (#32574)
• mongodbatlasreceiver: Fix memory leak by closing idle connections on shutdown (#32206)
• haproxyreceiver: Fix show stat command on unix socket (#32291)
• opampsupervisor: Fix restart delay when agent process exits unexpectedly. (#27891)
• spanmetrics: Discard counter span metric exemplars after each flush interval to avoid unbounded memory growth (#31683)
  This aligns exemplar discarding for counter span metrics with the existing logic for histogram span metrics
• stanza: Unmarshaling now preserves the initial configuration. (#32169)
• resourcedetectionprocessor: Update to ec2 scraper so that core attributes are not dropped if describeTags returns an error (likely due to permissions) (#30672)

API Changelog

💡 Enhancements 💡

• prometheusremotewrite: Optimize the prometheusremotewrite.FromMetrics function, based around more performant metric identifier hashing. (#31385)
• pkg/pdatatest/plogtest: Add an option to ignore log timestamp (#32540)
• filelogreceiver: Add exclude_older_than configuration setting (#31053)

v0.98.0

The OpenTelemetry Collector Contrib contains everything in the opentelemetry-collector release, be sure to check the release notes there as well.

End User Changes

🛑 Breaking changes 🛑

• podmanreceiver: Adds metrics and resources metadata and sets seconds precision for cpu metrics (#28640)

• clickhouseexporter: Add ServiceName as column into Clickhouse metrics tables (#31670)
  It's a breaking change. users who upgrade to the latest version need to alter the Clickhouse table:

  ALTER TABLE otel_metrics_exponential_histogram ADD COLUMN ServiceName LowCardinality(String) CODEC(ZSTD(1));
  ALTER TABLE otel_metrics_gauge ADD COLUMN ServiceName LowCardinality(String) CODEC(ZSTD(1));
  ALTER TABLE otel_metrics_histogram ADD COLUMN ServiceName LowCardinality(String) CODEC(ZSTD(1));
  ALTER TABLE otel_metrics_sum ADD COLUMN ServiceName LowCardinality(String) CODEC(ZSTD(1));
  ALTER TABLE otel_metrics_summary ADD COLUMN ServiceName LowCardinality(String) CODEC(ZSTD(1));

• elasticsearchexporter: Initial pass in implementing the ecs mapping mode (#31553)
  Breaking change if mapping mode is set to ecs, use none to maintain existing format

• pkg/stanza: Revert recombine operator's 'overwrite_with' default value. (#30783)
  Restores the previous the default value of oldest, meaning that the recombine operator will emit the
  first entry from each batch (with the recombined field). This fixes the bug introduced by 30783 and restores
  the default setting so as to effectively cancel out the bug for users who were not using this setting.
  For users who were explicitly setting overwrite_with, this corrects the intended behavior.

• processor/attributes, processor/resource: Remove stable coreinternal.attraction.hash.sha256 feature gate. (#31997)

• receiver/dockerstats: Remove stable receiver.dockerstats.useScraperV2 feature gate. (#31999)

• awsxrayexporter: change x-ray exporter's translator to make "." split annotation pass as-is (#31732)
  In the past, X-Ray doesn’t support “.”. So we have a translator in x-ray export to translates it to “_” before sending traces to X-Ray Service. | To match otel naming style, x-ray service team decide to change their service to support both "." type and "" type of naming. In this case the translator that translate "." to "" is no-longer needed. This PR change the way this translator work | X-Ray PMs agree on rolling out this change by using feature-gate

• oracledbreceiver: Fix incorrect values being set for oracledb.tablespace_size.limit and oracledb.tablespace_size.usage (#31451)
  Please grant the DBA_TABLESPACE_USAGE_METRICS permission to the user connecting to the Oracle DB instance to ensure all enabled metrics are properly ingested.

🚩 Deprecations 🚩

• postgresqlreceiver: Minimal supported PostgreSQL version will be updated from 9.6 to 12.0 in a future release. (#30923)
  Aligning on the supported versions as can be seen in the PostgreSQL releases section

🚀 New components 🚀

• avrologencodingextension: Add new encoding extension to support mapping of AVRO messages to logs. (#21067)

💡 Enhancements 💡

• ottl: Add new Unix function to convert from epoch timestamp to time.Time (#27868)

• filelogreceiver: When reading a file on filelogreceiver not on windows, if include_file_owner_name is true, it will add the file owner name as the attribute log.file.owner.name and if include_file_owner_group_name is true, it will add the file owner group name as the attribute log.file.owner.group.name. (#30775)

• awsproxyextension: Make awsproxy extension more resilient by initiating the AWS client during Start. (#27849)

• deltatocumulativeprocessor: self-instrumentation to observe key metrics of the stream accumulation (#30705)

• datadog/connector: Enable connector to use any attribute from the resource as Container Tag (#32224)
  This change allows the connector to use any attribute from the resource as a container tag. This is useful when you want to use a custom attribute from the resource as a container tag. For example, you can use the namespace attribute from the resource as a container tag.

• exceptionsconnector: change stability of exceptionsconnector from development to alpha (#31820)

• exceptionsconnector: Copy span attributes to the generated log from exception. (#24410)

• prometheusreceiver: Allows receiving prometheus native histograms (#26555)

  • Native histograms are compatible with OTEL exponential histograms.
  • The feature can be enabled via the feature gate receiver.prometheusreceiver.EnableNativeHistograms.
    Run the collector with the command line option --feature-gates=receiver.prometheusreceiver.EnableNativeHistograms.
  • Currently the feature also requires that targets are scraped via the ProtoBuf format.
    To start scraping native histograms, set
    config.global.scrape_protocols to [ PrometheusProto, OpenMetricsText1.0.0, OpenMetricsText0.0.1, PrometheusText0.0.4 ] in the
    receiver configuration. This requirement will be lifted once Prometheus can scrape native histograms over text formats.
  • For more up to date information see the README.md file of the receiver at
    https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/prometheusreceiver/README.md#prometheus-native-histograms.

• all: Add support for ARM build (#12920)

• failoverconnector: Support ignoring max_retries setting in failover connector (#9868)

• spanmetricsconnector: Change default value of metrics_flush_interval from 15s to 60s (#31776)

• pkg/ottl: Adding a string converter into pkg/ottl (#27867)

• cmd/opampsupervisor: Handle OpAMP connection settings. (#21043)

• loadbalancingexporter: Support the timeout period of k8s resolver list watch can be configured. (#31757)

• cmd/telemetrygen: Add Support for specifying Log Severity (#26498)

🧰 Bug fixes 🧰

• datadog/connector: Fix data race in datadog metrics client (#31964)
  The PR ensures mutex protects gauges map in every code path.
• exporter/awskinesisexporter: Fixed issue with compression what was causing EOF exceptions when attempting to decompress the payload (#32081)
• filelogreceiver: Fix missing scope name and group logs based on scope (#23387)
• jaegerremotesamplingextension: Fix leaking goroutine on shutdown (#31157)
• jmxreceiver: Fix memory leak during component shutdown (#32289)
• k8sobjectsreceiver: Fix memory leak caused by the pull mode's interval ticker (#31919)
• kafkareceiver: fix kafka receiver panic on shutdown (#31926)
• prometheusreceiver: Fix a bug where a new prometheus receiver with the same name cannot be created after the previous receiver is Shutdown (#32123)
• resourcedetectionprocessor: Only attempt to detect Kubernetes node resource attributes when they're enabled. (#31941)
• syslogreceiver: Fix issue where static resource and attributes were ignored (#31849)

Go API Changes

💡 Enhancements 💡

• pkg/sampling: Usability improvements in the sampling API. (#31918)

v0.97.0

End User Changes

🛑 Breaking changes 🛑

• datadogconnector: Remove feature gate connector.datadogconnector.performance (#31638)
• cmd/mdatagen: Delete deprecated cmd/mdatagen from this project. Use go.opentelemetry.io/collector/cmd/mdatagen instead. (#30497)
• receiver/postgresql: Bump postgresqlreceiver.preciselagmetrics gate to beta (#31220)
• receiver/vcenter: Bump receiver.vcenter.emitPerfMetricsWithObjects feature gate to stable (#31215)
• prometheusreceiver: Remove enable_protobuf_negotiation option on the prometheus receiver. Use config.global.scrape_protocols = [ PrometheusProto, OpenMetricsText1.0.0, OpenMetricsText0.0.1, PrometheusText0.0.4 ] instead. (#30883)
  See https://prometheus.io/docs/prometheus/latest/configuration/configuration/#configuration-file for details on setting scrape_protocols.
• vcenterreceiver: Fixed the resource attribute model to more accurately support multi-cluster deployments (#30879)
  For more information on impacts please refer #31113. The main impacts are that
  the vcenter.resource_pool.name, vcenter.resource_pool.inventory_path, and vcenter.cluster.name are reported with more accuracy on VM metrics.

🚩 Deprecations 🚩

• instanaexporter: Mark the Instana Exporter as deprecated. (#31765)

🚀 New components 🚀

• awss3receiver: introduce the AWS S3 receiver (#30750)
• sumologicextension: promote to alpha stability (#29601)
• googleclientauthextension: Add boilerplate for Google Client Auth Extension (#31412)
• grafanacloudconnector: Adds a connector to generate metrics for Grafana Cloud. (#31647)
• rabbitmqexporter: Add new exporter for sending telemetry to RabbitMQ brokers using the AMQP 0.9.1 protocol (#28891)

💡 Enhancements 💡

• exporter/loadbalancingexporter: Adding AWS Cloud Map for service discovery of Collectors backend. (#27241)

• ottl: Add new function to decode a base64 encoded string and output the original string (#31543)

• ackextension: adding the in-memory implementation of the ackextension (#26376)

• awss3exporter: add compression option to enable file compression on S3 (#27872)
  Add compression option to compress files using compress/gzip library before uploading to S3.

• servicegraphprocessor: Added a new configuration option database_name_attribute to allow users to specify a custom attribute name for identifying the database name in span attributes. (#30726)

• awss3exporter: Add support for encoding extension to awss3exporter (#30554)

• processor/k8sattributes: Add support for k8s.node.uid metadata (#31637)

• awss3exporter: Add support for specifying the file extension for files uploaded to S3 when using an encoding extension. (#31818)

• datadogexporter: Datadog exporter uses the same default HTTP settings as Datadog Agent HTTP transport (#31733)

• datadogexporter: Datadog exporter respects a subset of settings in confighttp client configs (#31733)
  Currently the following configs are respected: read_buffer_size, write_buffer_size, timeout, max_idle_conns, max_idle_conns_per_host, max_conns_per_host, idle_conn_timeout, disable_keep_alives and tls.insecure_skip_verify.

• deltatocumulativeprocessor: introduce configurable stream limit (#31488)
  Adds max_streams option that allows to set upper bound (default = unlimited)
  to the number of tracked streams. Any additional streams exceeding the limit
  are dropped.

• deltatocumulativeprocessor: expire stale series (#30705, #31016)
  Adds max_stale option that allows to set an interval (default = 5min)
  after which a series that no longer receives new samples is removed from
  tracking.

• datadogconnector: Add a new option to the Datadog connector to enable container tags on stats Payloads. (#31642)
  This change adds a new option to the Datadog connector to enable container tags on stats Payloads. This is useful for users who want to use container tags as second primary tag for Datadog APM.

• dockerstatsreceiver: add metrics for online CPU count and memory fails count (#31366)

• fileexporter: Adopt the encoding extension with the file exporter. (#31774)

• pkg/ottl: Add ParseXML function for parsing XML from a target string. (#31133)

• fileexporter: Added the option to write telemetry data into multiple files, where the file path is based on a resource attribute. (#24654)

• fileexporter: File write mode is configurable now (truncate or append) (#31364)

• elasticsearchexporter: When timestamp is not set, use observedTimestamp (#11752)

• k8sclusterreceiver: add optional status_last_terminated_reason resource attribute (#31282)

• awsproxyextension: Expose service_name as configurable option. Previously, it was hardcoded as xray. (#29550)

• datadogexporter: Add new telemetry metric, otelcol_datadog_otlp_translator_resources_missing_source that counts OTLP resources missing a hostname-identifying attribute. (#31805)

  • Enable Collector metrics https://github.com/open-telemetry/opentelemetry-collector/blob/main/docs/troubleshooting.md#metrics to check for this metric.

• extension/opamp: Promote the OpAMP extension to alpha stability (#31616)

• prometheusremotewriteexporter: Publish telemetry about translation of metrics from Otel to Prometheus. Don't drop all data points if some fail translation. (#29729)

• prometheusreceiver: Use confighttp for target allocator client (#31449)

• spanmetricsconnector: Add metrics_expiration option to enable expiration of metrics if spans are not received within a certain time frame. (#30559)
  The feature can be configured by specifiying the desired duration in the metrics_expiration option. By default, the expiration is disabled (set to 0).

• splunkentreceiver: Updated the config.go and propogated these changes to other receiver components. Change was necessary to differentiate different configurable endpoints. (#30254)

• exporter/datadogexporter: Do not drop traces when payload channel is full. (#31893)

• connector/datadogconnector: Do not resolve container tags if payload already has tags associated with it. (#31893)

🧰 Bug fixes 🧰

• bigipreceiver: Fix potential nil pointer usage in GetPoolMembers (#31899)

• carbonreceiver: Do not report fatal error when closed normally (#31913)

• datadogexporter: Fix data race in metrics exporter shutdown (#31663)

• deltatocumulativeprocessor: timer-based expiry (#31615)
  converts expiry to 1m timer, eliminating a race condition and failing test

• telemetrygen: Do not use WithBlock when forming grpc connections for metrics/traces in telemetrygen to avoid infinite retry after failure (#31401)

• filestatsreceiver: Fix file.path to return the proper absolute path of the file (#31738)

• internal/docker: Updated docker dependency and fixed zap.String incompatibility (#31087)

• exporter/loadbalancing: Fix panic when a sub-exporter is shut down while still handling requests. (#31410)

• cmd/telemetrygen: Fixed key mapping for logs telemetry attributes. (#31309)

• exporter/awskinesisexporter: Fix the capacity of records slices in the initialized batch (#20914)

• hostmetricsreceiver: Adds the receiver.hostmetrics.normalizeProcessCPUUtilization feature gate to optionally normalize process.cpu.utilization values. (#31368)
  When enabled, the receiver.hostmetrics.normalizeProcessCPUUtilization feature gate will cause process.cpu.utilization values to be divided by the number of logical cores on the system. This is necessary to produce a value on the interval of [0-1], as the description of process.cpu.utilization the metric says.

• transformprocessor: Change metric unit for metrics extracted with extract_count_metric() to be the default unit (1) (#31575)
  The original metric unit does not apply to extracted count metrics the same way it does to sum, min or max.
  Metrics extracted using extract_count_metric() now use the more appropriate default unit (1) instead.

• dockerstatsreceiver: Add shutdown method to fix leaking goroutines (#30438)

• loadbalancingexporter: Fix memory leaks on shutdown (#31050)

• signalfxexporter: Fix memory leak in shutdown (#30864, #30438)

• servicegraphprocessor: Fix 'failed to find dimensions for key' error from race condition in metrics cleanup. (#31701)

• processor/k8sattributes: Allows k8sattributes processor to work with k8s role/rolebindings when filter::namespace is set. (#14742)

• exporter/datadog: Demote noisy gohai logs to debug level (#29741)
  These logs would be present at the info level when using the official Docker images but were not useful to end-users.

• opencensusreceiver: Refactor the opencensusreceiver to pass lifecycle tests and avoid leaking gRPC connections. (#31643)

• sqlqueryreceiver: Fix memory leak on shutdown for log telemetry (#31782)

Go API Changes

🛑 Breaking changes 🛑

• datadogexporter: Remove config structs LimitedClientConfig and LimitedTLSClientSettings (#31733)
  This should have no impact to end users as long as they do not import Datadog exporter config structs in their source code.
• cmd/mdatagen: Delete deprecated cmd/mdatagen from this project. Use go.opentelemetry.io/collector/cmd/mdatagen instead. (#30497)
• azuremonitorreceiver: Reduce the public API for this receiver. (#24850)
  This unexports the following types ArmClient, MetricsDefinitionsClientInterface, MetricsValuesClient.
• general: Update any component using scraperhelper.ScraperControllerSettings to use scraperhelper.ControllerConfig (#31816)
  This changes the config field name from ScraperControllerSettings to ControllerConfig
• prometheusreceiver: Remove enable_protobuf_negotiation option on the prometheus receiver. Use config.global.scrape_protocols = ...

v0.96.0

The OpenTelemetry Collector Contrib contains everything in the opentelemetry-collector release, be sure to check the release notes there as well.

User-Facing Changes

🛑 Breaking changes 🛑

• f5cloudexporter: Remove deprecated module (#31531)

• datadogconnector: Move feature gate connector.datadogconnector.performance to stable stage. (#31414)
  connector.datadogconnector.performance will be removed in the next release

• spanmetricsprocessor: Remove spanmetrics processor (#29567)

  • You can use the spanmetrics connector as a replacement

• httpforwarder: Remove extension named httpforwarder, use httpforwarderextension instead. (#24171)

• k8sclusterreceiver: Remove deprecated k8s.kubeproxy.version resource attribute (#29748)

🚀 New components 🚀

• ackextension: Adding an interface for Acknowledgement extension (#26376)
• sumologicextension: add implementation of Sumo Logic Extension (#29601)

💡 Enhancements 💡

• datadogexporter: Attach the collector version to stats payloads to improve the debugging experience. (#31454)

• awsxrayexporter: support both deprecated and stable http attributes translation for backward compatibility. (#30935)

• azuremonitorexporter: Added support for configuring the Azure Monitor Exporter connection string via the APPLICATIONINSIGHTS_CONNECTION_STRING environment variable. (#31523)

• datadogconnector: datadogconnector no longer mutates the input traces in trace-to-trace pipelines. (#31414)

• statsdreceiver: Add support for the latest version of DogStatsD protocol (v1.3) (#31295)

• fileexporter: Scope the behavior of the fileexporter to its lifecycle, so it is safe to shut it down or restart it. (#27489)

• processor/resourcedetection: Add processor.resourcedetection.hostCPUSteppingAsString feature gate to change the type of host.cpu.stepping from int to string. (#31136)
  This feature gate will graduate to beta in the next release.

• routingconnector: a warning is logged if there are two or more routing items with the same routing statement (#30663)

• pkg/ottl: Add new IsInt function to facilitate type checking. (#27894)

• cmd/mdatagen: Make lifecycle tests generated by default (#31532)

• opampextension: enables creating and using an http client (#31389)

• pkg/stanza: Improve timestamp parsing documentation (#31490)

• postgresqlreceiver: Add receiver.postgresql.connectionPool feature gate to reuse database connections (#30831)
  The default implementation recreates and closes connections on each scrape per database configured/discovered.
  This change offers a feature gated alternative to keep connections open. Also, it exposes connection configuration to control the behavior of the pool.

• datadogconnector: Add source:datadogconnector tag to trace agent telemetry metrics generated by the datadogconnector. (#31528)

• datadogexporter: Add source:datadogexporter tag to trace agent telemetry metrics generated by the datadogexporter. (#31528)

• datadogexporter: Automatically map cloud.region, cloud.availability_zone and cloud.provider to the region, zone and cloud_provider host tags. (#31372)

🧰 Bug fixes 🧰

• carbonreceiver: Accept carbon metrics with float timestamps (#31312)
• chronyreceiver: move initialization of the chrony client to the start function (#27849)
• deltatocumulativeprocessor: permits advancing delta start timestamps, as required by spec. (#31365)
• deltatocumulativeprocessor: due to an oversight, only the first sample of each stream was processed. now all samples are. (#31350)
• cmd/telemetrygen: Inherit root CAs from the host environment if not supplied on the command line. (#31191)
• syslogexporter: fix setting network connection, do not load TLS configuration for UDP (#31130)
• journaldreceiver: Fix bug where failed startup could bury error message due to panic during shutdown (#31476)
• loadbalancingexporter: Fixes a bug where the endpoint become required, despite not being used by the load balancing exporter. (#31371)
• oracledbreceiver: Use metadata.Type for the scraper id to avoid invalid scraper IDs. (#31457)
• filelogreceiver: Fix bug where delete_after_read would cause panic (#31383)
• receiver/filelog: Fix issue where file fingerprint could be corrupted while reading. (#22936)
• cmd/telemetrygen: Fix incorrect error logged in traces batch span processor shutdown (#31362)

API Changes

🛑 Breaking changes 🛑

• cmd/mdatagen: Use enum for stability levels in the Metadata struct (#31530)
• httpforwarder: Remove extension named httpforwarder, use httpforwarderextension instead. (#24171)

v0.95.0

The OpenTelemetry Collector Contrib contains everything in the opentelemetry-collector release, be sure to check the release notes there as well.

User-Facing Changes

🛑 Breaking changes 🛑

• all: Bump minimum version to go 1.21 (#31105)
• receiver/elasticsearch: Remove receiver.elasticsearch.emitNodeVersionAttr feature gate (#31221)
• receiver/mongodb: Bump receiver.mongodb.removeDatabaseAttr feature gate to beta (#31212)
• splunkenterprisereceiver: adds additional metrics specific to indexers (#30704)
• exporter/datadogexporter: Disable APM stats computation in Datadog Exporter by default, exporter.datadogexporter.DisableAPMStats is changed to beta (#31219)
• extension/storage: The filestorage and dbstorage extensions are now standalone modules. (#31040)
  If using the OpenTelemetry Collector Builder, you will need to update your import paths to use the new module(s).
  • github.com/open-telemetry/opentelemetry-collector-contrib/extension/storage/filestorage
  • github.com/open-telemetry/opentelemetry-collector-contrib/extension/storage/dbstorage

🚩 Deprecations 🚩

• f5cloudexporter: deprecating component that is no longer maintained (#31186)

🚀 New components 🚀

• confmap/secretsmanagerprovider: Initial implementation of secrets manager provider. Allows fetch variables from AWS Secrets Manager (#19368)
• deltatocumulative: adds processor to convert sums (initially) from delta to cumulative temporality (#30705)

💡 Enhancements 💡

• hostmetricsreceiver: Add a new optional resource attribute process.cgroup to the process scraper of the hostmetrics receiver. (#29282)

• datadogexporter: Adds support for stable JVM metrics introduced in opentelemetry-java-instrumentation v2.0.0 (#31194)
  See DataDog/opentelemetry-mapping-go#265 for details.

• datasetexporter: Release resources if they haven't been used for some time. (#31292)

• datadogconnector: Add a trace config peer_tags on supplementary peer tags on APM stats. (#31158)

• datadogexporter: Add a trace config peer_tags on supplementary peer tags on APM stats. (#31158)

• awss3exporter: Add a marshaler that stores the body of log records in s3. (#30318)

• pkg/ottl: Adds a new ParseCSV converter that can be used to parse CSV strings. (#30921)

• loadbalancingexporter: Add benchmarks for Metrics and Traces (#30915)

• pkg/ottl: Add support to specify the format for a replacement string (#27820)

• pkg/ottl: Add ParseKeyValue function for parsing key value pairs from a target string (#30998)

• receivercreator: Remove use of ReportFatalError (#30596)

• processor/tail_sampling: Add metrics that measure the number of sampled spans and the number of spans that are dropped due to sampling decisions. (#30482)

• exporter/signalfx: Send histograms in otlp format with new config send_otlp_histograms option (#26298)

• receiver/signalfx: Accept otlp protobuf requests when content-type is "application/x-protobuf;format=otlp" (#26298)

• signalfxreceiver: Remove deprecated use of host.ReportFatalError (#30598)

• syslogexporter: Adding support for sending rfc6587 octet counts in syslog messages (#31013)

• connector/datadogconnector: Internal telemetry metrics for the Datadog traces exporter are now reported through the Collector's self-telemetry (#31179)

  • These internal metrics may be dropped or change name without prior notice

• exporter/datadogexporter: Internal telemetry metrics for the Datadog traces exporter are now reported through the Collector's self-telemetry (#31179)

  • These internal metrics may be dropped or change name without prior notice

🧰 Bug fixes 🧰

• pkg/stanza: Add 'allow_skip_pri_header' flag to syslog setting. (#30397)
  Allow parsing syslog records without PRI header. Currently pri header is beng enforced although it's not mandatory by the RFC standard. Since influxdata/go-syslog is not maintained we had to switch to haimrubinstein/go-syslog.

• datadogexporter: Fix bug where multiple resources would cause datadogexporter to send extraneous additional stats buckets. (#31173)

• extension/storage: Ensure fsync is turned on after compaction (#20266)

• logstransformprocessor: Fix potential panic on shutdown due to incorrect shutdown order (#31139)

• logicmonitorexporter: Fix memory leak on shutdown (#31150)

• opencensusreceiver: Fix memory leak on shutdown (#31152)

• receiver/prometheusreceiver: prometheusreceiver fix translation of metrics with _created suffix (#30309)

• pkg/stanza: Fixed a bug in the keyvalue_parser where quoted values could be split if they contained a delimited. (#31034)

API Changes

🛑 Breaking changes 🛑

• pkg/stanza: Remove deprecated pkg/stanza/attrs (#30449)
• httpforwarderextension: Rename the extension httpforwarder to httpforwarderextension (#24171)
• extension/storage: The filestorage and dbstorage extensions are now standalone modules. (#31040)
  If using the OpenTelemetry Collector Builder, you will need to update your import paths to use the new module(s).
  • github.com/open-telemetry/opentelemetry-collector-contrib/extension/storage/filestorage
  • github.com/open-telemetry/opentelemetry-collector-contrib/extension/storage/dbstorage

💡 Enhancements 💡

• pkg/golden: Added an option to skip the metric timestamp normalization for WriteMetrics. (#30919)
• healthcheckextension: Remove usage of deprecated host.ReportFatalError (#30582)

v0.94.0

The OpenTelemetry Collector Contrib contains everything in the opentelemetry-collector release, be sure to check the release notes there as well.

User-Facing Changes

🛑 Breaking changes 🛑

• servicegraphprocessor: removed deprecated component, use the servicegraph connector instead. (#26091)

• datadogconnector: Enable feature gate connector.datadogconnector.performance by default. (#30829)
  See https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/connector/datadogconnector#feature-gate-for-performance for caveats of this feature gate.

• datadogprocessor: Delete datadogprocessor which has been deprecated since v0.84.0 (#31026)
  Use datadogconnector instead.

• kafkareceiver: standardizes the default topic name for metrics and logs receivers to the same topic name as the metrics and logs exporters of the kafkaexporter (#27292)
  If you are using the Kafka receiver in a logs and/or a metrics pipeline
  and you are not customizing the name of the topic to read from with the topic property,
  the receiver will now read from otlp_logs or otlp_metrics topic instead of otlp_spans topic.
  To maintain previous behavior, set the topic property to otlp_spans.

• pkg/stanza: Entries are no longer logged during error conditions. (#26670)
  This change is being made to ensure sensitive information contained in logs are never logged inadvertently.
  This change is a breaking change because it may change user expectations. However, it should require
  no action on the part of the user unless they are relying on logs from a few specific error cases.

• pkg/stanza: Invert recombine operator's 'overwrite_with' default value. (#30783)
  Previously, the default value was oldest, meaning that the recombine operator should emit the
  first entry from each batch (with the recombined field). However, the actual behavior was inverted.
  This fixes the bug but also inverts the default setting so as to effectively cancel out the bug fix
  for users who were not using this setting. For users who were explicitly setting overwrite_with,
  this corrects the intended behavior.

🚩 Deprecations 🚩

• skywalkingexporter: Mark the component as unmaintained. If we don't find new maintainers, it will be deprecated and removed. (#23796)

🚀 New components 🚀

• sumologicextension: add configuration and readme (#29601)
• failoverconnector: Refactor of connector to seperate concerns between managing indexes and core failover component (#20766)
• otelarrow: Skeleton of new OpenTelemetry Protocol with Apache Arrow Receiver (#26491)
• processor/interval: Adds the initial structure for a new processor that aggregates metrics and periodically forwards the latest values to the next component in the pipeline. (#29461)
  As per the CONTRIBUTING.md recommendations, this PR only creates the basic structure of the processor. The concrete implementation will come as a separate followup PR

💡 Enhancements 💡

• receiver/journald: add a new config option "all" that turns on full output from journalctl, including lines that are too long. (#30920)

• pkg/stanza: Add support in a header configuration for json array parser. (#30321)

• awss3exporter: Add the ability to export trace/log/metrics in OTLP ProtoBuf format. (#30682)

• dockerobserver: Upgrading Docker API version default from 1.22 to 1.24 (#30900)

• filterprocessor: move metrics from OpenCensus to OpenTelemetry (#30736)

• groupbyattrsprocessor: move metrics from OpenCensus to OpenTelemetry (#30763)

• datadogconnector: Add trace configs that mirror datadog exporter (#30787)
  ignore_resources: disable certain traces based on their resource name
  span_name_remappings: map of datadog span names and preferred name to map to
  span_name_as_resource_name: use OTLP span name as datadog operation name
  compute_stats_by_span_kind: enables an additional stats computation check based on span kind
  peer_tags_aggregation: enables aggregation of peer related tags
  trace_buffer: specifies the buffer size for datadog trace payloads

• elasticsearchexporter: Add mapping.mode: raw configuration option (#26647)
  Setting mapping.mode: raw in the Elasticsearch exporter's configuration
  will result logs and traces being indexed into Elasticsearch with their
  attribute fields directly at the root level of the document instead inside an
  Attributes object. Similarly, this setting will also result in traces being
  indexed into Elasticsearch with their event fields directly at the root level
  of the document instead of inside an Events object.

• loadbalancingexporter: Optimize metrics and traces export (#30141)

• gitproviderreceiver: Add pull request metrics (#22028)

  • git.repository.pull_request.open.count
  • git.repository.pull_request.open.time
  • git.repository.pull_request.merged.count
  • git.repository.pull_request.merged.time
  • git.repository.pull_request.approved.time

• all: Add component.UseLocalHostAsDefaultHost feature gate that changes default endpoints from 0.0.0.0 to localhost (#30702)
  This change affects the following components:

  • extension/awsproxy
  • extension/health_check
  • extension/jaegerremotesampling
  • internal/aws/proxy
  • processor/remotetap
  • receiver/awsfirehose
  • receiver/awsxray
  • receiver/influxdb
  • receiver/jaeger
  • receiver/loki
  • receiver/opencensus
  • receiver/sapm
  • receiver/signalfx
  • receiver/skywalking
  • receiver/splunk_hec
  • receiver/zipkin
  • receiver/zookeeper

• googlepubsubreceiver: Add support for GoogleCloud logging encoding (#29299)

• processor/resourcedetectionprocessor: Detect Azure cluster name from IMDS metadata (#26794)

• processor/transform: Add copy_metric function to allow duplicating a metric (#30846)

🧰 Bug fixes 🧰

• basicauthextension: Accept empty usernames. (#30470)
  Per https://datatracker.ietf.org/doc/html/rfc2617#section-2, username and password may be empty strings ("").
  The validation used to enforce that usernames cannot be empty.

• servicegraphconnector: update prefix to match the component type (#31023)

• datadog/connector: Create a separate connector in the Datadog connector for the trace-to-metrics and trace-to-trace pipelines. It should reduce the number of conversions we do and help with Datadog connector performance. (#30828)
  Simplify datadog/connector with two separate connectors in trace-to-metrics pipeline and trace-to-trace pipeline.

• datadogreceiver: Set AppVersion to allow Datadog version property to transform properly to service.version resource attribute (#30225)

• cmd/opampsupervisor: Fix memory leak on shutdown (#30438)

• exporter/datadog: Fixes a bug where empty histograms were not being sent to the backend in the distributions mode. (#31019)

• pkg/ottl: Fix parsing of string escapes in OTTL (#23238)

• pkg/stanza: Recombine operator should always recombine partial logs (#30797)
  Previously, certain circumstances could result in partial logs being emitted without any
  recombiniation. This could occur when using is_first_entry, if the first partial log from
  a source was emitted before a matching "start of log" indicator was found. This could also
  occur when the collector was shutting down.

• pkg/stanza: Fix bug where recombine operator's 'overwrite_with' condition was inverted. (#30783)

• exporter/signalfx: Use "unknown" value for the environment correlation calls as fallback. (#31052)
  This fixed the APM/IM correlation in the Splunk Observability UI for the users that send traces with no "deployment.environment" resource attribute value set.

• namedpipereceiver: Fix SIGSEGV when named pipe creation fails (#31088)

API Changes

🚩 Deprecations 🚩

• testbed: Deprecate testbed.GetAvailablePort in favor of testutil.GetAvailablePort (#30811)
  Move healthcheckextension to use testutil.GetAvailablePort

🚀 New components 🚀

• pkg_sampling: Package of code for parsing OpenTelemetry tracestate probability sampling fields. (#29738)