From 570e97f3d4f5a3d7934c2c14526aae9384ef4d05 Mon Sep 17 00:00:00 2001 From: Max Leonov Date: Tue, 18 Nov 2025 18:33:05 +0100 Subject: [PATCH] Release notes for Distributed tracing and OpenTelemetry 3.8 --- modules/distr-tracing-tempo-about-rn.adoc | 5 +++- modules/distr-tracing-tempo-rn-bug-fixes.adoc | 15 ++++++++++-- .../distr-tracing-tempo-rn-enhancements.adoc | 3 +-- .../distr-tracing-tempo-rn-known-issues.adoc | 14 ++++++----- ...-tempo-rn-technology-preview-features.adoc | 8 +++++++ modules/otel-about-rn.adoc | 5 +++- modules/otel-rn-bug-fixes.adoc | 20 +++++++++++++++- modules/otel-rn-deprecated-features.adoc | 24 +------------------ modules/otel-rn-enhancements.adoc | 5 ++-- modules/otel-rn-known-issues.adoc | 7 ++++++ modules/otel-rn-removed-features.adoc | 6 +---- .../otel-rn-technology-preview-features.adoc | 13 ++++++++-- .../distr_tracing/distr-tracing-rn.adoc | 6 ++--- observability/otel/otel-rn.adoc | 11 +++++---- 14 files changed, 88 insertions(+), 54 deletions(-) diff --git a/modules/distr-tracing-tempo-about-rn.adoc b/modules/distr-tracing-tempo-about-rn.adoc index e098bf56159e..5edc7c829c8e 100644 --- a/modules/distr-tracing-tempo-about-rn.adoc +++ b/modules/distr-tracing-tempo-about-rn.adoc @@ -6,9 +6,12 @@ [id="distr-tracing-product-overview_{context}"] = About this release -{DTShortName} 3.7 is provided through the link:https://catalog.redhat.com/software/containers/rhosdt/tempo-operator-bundle/642c3e0eacf1b5bdbba7654a/history[{TempoOperator} 0.18.0] and based on the open source link:https://grafana.com/oss/tempo/[Grafana Tempo] 2.8.2. +[role="_abstract"] +{DTShortName} 3.8 is provided through the link:https://catalog.redhat.com/software/containers/rhosdt/tempo-operator-bundle/642c3e0eacf1b5bdbba7654a/history[{TempoOperator} 0.??.0] and based on the open source link:https://grafana.com/oss/tempo/[Grafana Tempo] 2.?.?. +//// [NOTE] ==== Some linked Jira tickets are accessible only with Red Hat credentials. ==== +//// diff --git a/modules/distr-tracing-tempo-rn-bug-fixes.adoc b/modules/distr-tracing-tempo-rn-bug-fixes.adoc index d558376a40ed..bf7ea1e657e9 100644 --- a/modules/distr-tracing-tempo-rn-bug-fixes.adoc +++ b/modules/distr-tracing-tempo-rn-bug-fixes.adoc @@ -6,6 +6,17 @@ [id="fixed-issues_{context}"] = Fixed issues -This release fixes the following CVE: +Resolved issue with TLS certificates affecting Tempo pods:: +Before this update, the Tempo pods would stop to communicate because internal TLS certificates were renewed. With this update, the Tempo pods automatically restart when certificates are renewed. ++ +link:https://issues.redhat.com/browse/TRACING-5622[TRACING-5622] -* link:https://access.redhat.com/security/cve/cve-2025-22874[CVE-2025-22874] +Tempo query frontend no longer fails to fetch trace JSON:: +Before this update, clicking on *Trace* in the Jaeger UI and refreshing the page, or accessing *Trace* -> *Trace Timeline* -> *Trace JSON* from the Tempo query frontend, might result in the Tempo query pod failing with an EOF error. With this update, this issue is resolved. ++ +link:https://issues.redhat.com/browse/TRACING-5483[TRACING-5483] + +[NOTE] +==== +Some linked Jira tickets are accessible only with Red Hat credentials. +==== diff --git a/modules/distr-tracing-tempo-rn-enhancements.adoc b/modules/distr-tracing-tempo-rn-enhancements.adoc index 341376d1b84a..642353c02712 100644 --- a/modules/distr-tracing-tempo-rn-enhancements.adoc +++ b/modules/distr-tracing-tempo-rn-enhancements.adoc @@ -6,5 +6,4 @@ [id="new-features-and-enhancements_{context}"] = New features and enhancements -Network policy to restrict API access:: -With this update, the {TempoOperator} creates a network policy for the Operator to restrict access to the used APIs. +None. diff --git a/modules/distr-tracing-tempo-rn-known-issues.adoc b/modules/distr-tracing-tempo-rn-known-issues.adoc index 3af762896e94..6f247616567c 100644 --- a/modules/distr-tracing-tempo-rn-known-issues.adoc +++ b/modules/distr-tracing-tempo-rn-known-issues.adoc @@ -6,9 +6,11 @@ [id="known-issues_{context}"] = Known issues -Tempo query frontend fails to fetch trace JSON:: -In the Jaeger UI, clicking on *Trace* and refreshing the page, or accessing *Trace* -> *Trace Timeline* -> *Trace JSON* from the Tempo query frontend, might result in the Tempo query pod failing with an EOF error. -+ -To work around this problem, use the distributed tracing UI plugin to view traces. -+ -link:https://issues.redhat.com/browse/TRACING-5483[TRACING-5483] +None. + +//// +[NOTE] +==== +Some linked Jira tickets are accessible only with Red Hat credentials. +==== +//// diff --git a/modules/distr-tracing-tempo-rn-technology-preview-features.adoc b/modules/distr-tracing-tempo-rn-technology-preview-features.adoc index 4804e534952c..9c0f6d682e2b 100644 --- a/modules/distr-tracing-tempo-rn-technology-preview-features.adoc +++ b/modules/distr-tracing-tempo-rn-technology-preview-features.adoc @@ -8,5 +8,13 @@ None. +[IMPORTANT] +==== +[subs="attributes+"] +Technology Preview features are not supported with Red{nbsp}Hat production service level agreements (SLAs) and might not be functionally complete. Red{nbsp}Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process. + +For more information about the support scope of Red{nbsp}Hat Technology Preview features, see link:https://access.redhat.com/support/offerings/techpreview/[Technology Preview Features Support Scope]. +==== + //:FeatureName: Each of these features //include::snippets/technology-preview.adoc[leveloffset=+1] diff --git a/modules/otel-about-rn.adoc b/modules/otel-about-rn.adoc index a161ef6e99c0..17ca0a8d95be 100644 --- a/modules/otel-about-rn.adoc +++ b/modules/otel-about-rn.adoc @@ -6,9 +6,12 @@ [id="otel-product-overview_{context}"] = About this release -{OTELName} 3.7 is provided through the link:https://catalog.redhat.com/software/containers/rhosdt/opentelemetry-operator-bundle/615618406feffc5384e84400/history[{OTELOperator} 0.135.0] and based on the open source link:https://opentelemetry.io/docs/collector/[OpenTelemetry] release 0.135.0. +[role="_abstract"] +{OTELName} 3.8 is provided through the link:https://catalog.redhat.com/software/containers/rhosdt/opentelemetry-operator-bundle/615618406feffc5384e84400/history[{OTELOperator} 0.140.0] and based on the open source link:https://opentelemetry.io/docs/collector/[OpenTelemetry] release 0.140.0. +//// [NOTE] ==== Some linked Jira tickets are accessible only with Red Hat credentials. ==== +//// diff --git a/modules/otel-rn-bug-fixes.adoc b/modules/otel-rn-bug-fixes.adoc index f6cd0b710328..83e653cc6b98 100644 --- a/modules/otel-rn-bug-fixes.adoc +++ b/modules/otel-rn-bug-fixes.adoc @@ -6,4 +6,22 @@ [id="fixed-issues_{context}"] = Fixed issues -None. +Fixed BearerTokenAuth Extension errors:: +Before this update, the BearerTokenAuth Extension might log errors when the service account token was refreshed. With this update, the extension correctly handles token file refresh without producing errors. ++ +link:https://issues.redhat.com/browse/TRACING-5678[TRACING-5678] + +Fixed errors from the CA Injector of cert-manager:: +Before this update, the CA Injector of cert-manager was logging errors related to fetching the certificates for the {OTELOperator}. With this update, the OpenTelemetry Collector no longer relies on cert-manager, preventing unnecessary error logs. ++ +link:https://issues.redhat.com/browse/TRACING-5590[TRACING-5590] + +Fixed short-term token authentication for the AWS Cloud Watch Exporter:: +Before this update, the AWS Cloud Watch Exporter ignored short-term token authentication using an Amazon Resource Name (ARN). With this update, the exporter correctly handles short-term token authentication. ++ +link:https://issues.redhat.com/browse/TRACING-5528[TRACING-5528] + +[NOTE] +==== +Some linked Jira tickets are accessible only with Red Hat credentials. +==== diff --git a/modules/otel-rn-deprecated-features.adoc b/modules/otel-rn-deprecated-features.adoc index d81b7869e1a1..d753564e6fac 100644 --- a/modules/otel-rn-deprecated-features.adoc +++ b/modules/otel-rn-deprecated-features.adoc @@ -6,26 +6,4 @@ [id="deprecated-features_{context}"] = Deprecated features -The OpenCensus Receiver is deprecated:: -The OpenCensus Receiver, which provided backward compatibility with the OpenCensus format, is deprecated and might be removed in a future release. - -The Collector's service metrics telemetry address is deprecated:: -The `metrics.address` field in the `OpenTelemetryCollector` custom resource (CR) is deprecated and might be removed in a future release. As an alternative, use the `metrics.readers` field instead. -+ -Example of using the `readers` field: -+ -[source,yaml] ----- -# ... - config: - service: - telemetry: - metrics: - readers: - - pull: - exporter: - prometheus: - host: 0.0.0.0 - port: 8888 -# ... ----- +None. diff --git a/modules/otel-rn-enhancements.adoc b/modules/otel-rn-enhancements.adoc index ac1419f1a65d..5673e00dc041 100644 --- a/modules/otel-rn-enhancements.adoc +++ b/modules/otel-rn-enhancements.adoc @@ -6,6 +6,5 @@ [id="new-features-and-enhancements_{context}"] = New features and enhancements -Network policy to restrict API access:: With this update, the {OTELOperator} creates a network policy for itself and the OpenTelemetry Collector to restrict access to the used APIs. - -Native sidecars:: With this update, the {OTELOperator} uses native sidecars on {product-title} 4.16 or later. +Operator Network policy improvements:: +With this update, the Operator Network policy for the Kubernetes API server becomes more specific and uses the API Server namespace and pod labels. diff --git a/modules/otel-rn-known-issues.adoc b/modules/otel-rn-known-issues.adoc index 5671fd676015..92a8e78c2ace 100644 --- a/modules/otel-rn-known-issues.adoc +++ b/modules/otel-rn-known-issues.adoc @@ -7,3 +7,10 @@ = Known issues None. + +//// +[NOTE] +==== +Some linked Jira tickets are accessible only with Red Hat credentials. +==== +//// diff --git a/modules/otel-rn-removed-features.adoc b/modules/otel-rn-removed-features.adoc index c9b63b60f76a..59824b3453ca 100644 --- a/modules/otel-rn-removed-features.adoc +++ b/modules/otel-rn-removed-features.adoc @@ -6,8 +6,4 @@ [id="removed-features_{context}"] = Removed features -The LokiStack Exporter is removed:: -The LokiStack Exporter, which exported data to a LokiStack instance, is removed and no longer supported. You can export data to a LokiStack instance by using the OTLP HTTP Exporter instead. - -The Routing Processor is removed:: -The Routing Processor, which routed telemetry data to an exporter is removed and no longer supported. You can route telemetry data by using the Routing Connector instead. +None. diff --git a/modules/otel-rn-technology-preview-features.adoc b/modules/otel-rn-technology-preview-features.adoc index bb9a051b7d25..11f4ef93b3dd 100644 --- a/modules/otel-rn-technology-preview-features.adoc +++ b/modules/otel-rn-technology-preview-features.adoc @@ -6,6 +6,15 @@ [id="technology-preview-features_{context}"] = Technology Preview features +Google Cloud Exporter (Technology Preview):: +This release introduces the Google Cloud Exporter as a Technology Preview feature for the Collector of the {OTELName}. You can use the Google Cloud Exporter to export metrics, logs, and traces to Google Cloud's observability services: Cloud Monitoring, Cloud Logging, and Cloud Trace. + +Profile signal (Technology Preview):: +This release introduces support for the Profile signal as a Technology Preview feature for receiving, processing, and exporting data in the Profile signal format. The Profile signal is a new observability data format for capturing the low-level performance of application code. + +Prometheus Remote Write Receiver (Technology Preview):: +This release introduces the Prometheus Remote Write Receiver as a Technology Preview feature for the Collector of the {OTELName}. You can use the Prometheus Remote Write Receiver to export metrics from the Prometheus server. + [IMPORTANT] ==== [subs="attributes+"] @@ -14,5 +23,5 @@ Technology Preview features are not supported with Red{nbsp}Hat production servi For more information about the support scope of Red{nbsp}Hat Technology Preview features, see link:https://access.redhat.com/support/offerings/techpreview/[Technology Preview Features Support Scope]. ==== -Probabilistic Sampling Processor (Technology Preview):: -This release introduces the Probabilistic Sampling Processor as a Technology Preview feature for the {OTELShortName} Collector. The Probabilistic Sampling Processor samples a specified percentage of trace spans or log records statelessly and per request. You can use the Probabilistic Sampling Processor if you handle high volumes of telemetry data and seek to reduce costs by reducing processed data volumes. +//:FeatureName: Each of these features +//include::snippets/technology-preview.adoc[leveloffset=+1] diff --git a/observability/distr_tracing/distr-tracing-rn.adoc b/observability/distr_tracing/distr-tracing-rn.adoc index 745b4ff61a1f..5b60bdc8a423 100644 --- a/observability/distr_tracing/distr-tracing-rn.adoc +++ b/observability/distr_tracing/distr-tracing-rn.adoc @@ -1,7 +1,7 @@ :_mod-docs-content-type: ASSEMBLY include::_attributes/common-attributes.adoc[] [id="distr-tracing-rn"] -= Release notes for the {TempoName} 3.7 += Release notes for the {TempoName} 3.8 :context: distr-tracing-rn @@ -11,7 +11,7 @@ include::modules/distr-tracing-tempo-about-rn.adoc[leveloffset=+1] include::snippets/distr-tracing-and-otel-disclaimer-about-docs-for-supported-features-only.adoc[] -include::modules/distr-tracing-tempo-rn-enhancements.adoc[leveloffset=+1] +// include::modules/distr-tracing-tempo-rn-enhancements.adoc[leveloffset=+1] // None included with this release // include::modules/distr-tracing-tempo-rn-technology-preview-features.adoc[leveloffset=+1] @@ -22,7 +22,7 @@ include::modules/distr-tracing-tempo-rn-enhancements.adoc[leveloffset=+1] // None included with this release // include::modules/distr-tracing-tempo-rn-removed-features.adoc[leveloffset=+1] -include::modules/distr-tracing-tempo-rn-known-issues.adoc[leveloffset=+1] +// include::modules/distr-tracing-tempo-rn-known-issues.adoc[leveloffset=+1] include::modules/distr-tracing-tempo-rn-bug-fixes.adoc[leveloffset=+1] diff --git a/observability/otel/otel-rn.adoc b/observability/otel/otel-rn.adoc index 987ebd26a3f8..c769d253ca88 100644 --- a/observability/otel/otel-rn.adoc +++ b/observability/otel/otel-rn.adoc @@ -1,7 +1,7 @@ :_mod-docs-content-type: ASSEMBLY include::_attributes/common-attributes.adoc[] [id="otel_rn"] -= Release notes for the {OTELName} 3.7 += Release notes for the {OTELName} 3.8 :context: otel-rn toc::[] @@ -14,14 +14,15 @@ include::modules/otel-rn-enhancements.adoc[leveloffset=+1] include::modules/otel-rn-technology-preview-features.adoc[leveloffset=+1] -include::modules/otel-rn-deprecated-features.adoc[leveloffset=+1] +// None included with this release +// include::modules/otel-rn-deprecated-features.adoc[leveloffset=+1] -include::modules/otel-rn-removed-features.adoc[leveloffset=+1] +// None included with this release +// include::modules/otel-rn-removed-features.adoc[leveloffset=+1] // None included with this release // include::modules/otel-rn-known-issues.adoc[leveloffset=+1] -// None included with this release -// include::modules/otel-rn-bug-fixes.adoc[leveloffset=+1] +include::modules/otel-rn-bug-fixes.adoc[leveloffset=+1] include::modules/support.adoc[leveloffset=+1]