Merge pull request #77237 from max-cx/OBSDOCS-1132

OBSDOCS-1132: Release notes for the Distributed Tracing 3.2.1 patch

Author: ShaunaDiaz

_topic_maps/_topic_map.yml

@@ -2825,8 +2825,8 @@ Topics:
   - Name: Release notes
     Dir: distr_tracing_rn
     Topics:
-    - Name: Distributed tracing 3.2
-      File: distr-tracing-rn-3-2
+    - Name: Distributed tracing 3.2.1
+      File: distr-tracing-rn-3-2-1
     - Name: Past releases
       File: distr-tracing-rn-past-releases
   - Name: Distributed tracing architecture
@@ -2863,8 +2863,8 @@ Topics:
   - Name: Release notes
     Dir: otel_rn
     Topics:
-    - Name: Red Hat build of OpenTelemetry 3.2
-      File: otel-rn-3-2
+    - Name: Red Hat build of OpenTelemetry 3.2.1
+      File: otel-rn-3-2-1
     - Name: Past releases
       File: otel-rn-past-releases
   - Name: Installing

observability/distr_tracing/distr_tracing_rn/distr-tracing-rn-3-2-1.adoc

@@ -0,0 +1,145 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/common-attributes.adoc[]
+[id="distributed-tracing-rn-3-2-1"]
+= Release notes for {DTProductName} 3.2.1
+:context: distributed-tracing-rn-3-2-1
+
+toc::[]
+
+include::modules/distr-tracing-product-overview.adoc[leveloffset=+1]
+
+You can use the {DTShortName} xref:../../otel/otel-forwarding.adoc#otel-forwarding-traces[in combination with] the xref:../../otel/otel-installing.adoc#install-otel[{OTELName}].
+
+This release of the {DTProductName} includes the {TempoName} and the deprecated {JaegerName}.
+
+[id="distributed-tracing-rn_3-2-1_cves_{context}"]
+== CVEs
+
+This release fixes link:https://access.redhat.com/security/cve/CVE-2024-25062/[CVE-2024-25062].
+
+////
+[id="distributed-tracing-rn_3-2-1_tempo-release-notes_{context}"]
+== {TempoName}
+
+The {TempoName} is provided through the {TempoOperator}.
+////
+
+////
+[id="distributed-tracing-rn_3-2-1_tempo-release-notes_technology-preview-features_{context}"]
+=== Technology Preview features
+
+This update introduces the following Technology Preview feature:
+
+* Support for the Tempo monolithic deployment.
+
+:FeatureName: The Tempo monolithic deployment
+include::snippets/technology-preview.adoc[leveloffset=+1]
+////
+
+////
+[id="distributed-tracing-rn_3-2-1_tempo-release-notes_new-features-and-enhancements_{context}"]
+=== New features and enhancements
+
+This update introduces the following enhancements:
+
+* {TempoName} 3.2.1 is based on the open source link:https://grafana.com/oss/tempo/[Grafana Tempo] 2.4.1.
+////
+
+////
+[id="distributed-tracing-rn_3-2-1_tempo-release-notes_deprecated-functionality_{context}"]
+=== Deprecated functionality
+
+In the {TempoName} 3.2.1, ???
+////
+
+////
+[id="distributed-tracing-rn_3-2-1_tempo-release-notes_removal-notice_{context}"]
+=== Removal notice
+
+In {TempoName} 3.2.1, the FEATURE has been removed. Bug fixes and support are provided only through the end of the 3.? lifecycle. As an alternative to the FEATURE for USE CASE, you can use the ALTERNATIVE instead.
+////
+
+////
+[id="distributed-tracing-rn_3-2-1_tempo-release-notes_bug-fixes_{context}"]
+=== Bug fixes
+
+This update introduces the following bug fixes:
+
+* Before this update, ... . (link:https://issues.redhat.com/browse/TRACING-????[TRACING-????])
+////
+
+////
+[id="distributed-tracing-rn_3-2-1_tempo-release-notes_known-issues_{context}"]
+=== Known issues
+
+There is currently a known issue:
+
+* Currently, the {TempoShortName} fails on the IBM Z (`s390x`) architecture. (link:https://issues.redhat.com/browse/TRACING-3545[TRACING-3545])
+////
+
+////
+[id="distributed-tracing-rn_3-2-1_jaeger-release-notes_{context}"]
+== {JaegerName}
+
+The {JaegerName} is provided through the {JaegerOperator} Operator.
+
+[IMPORTANT]
+====
+Jaeger does not use FIPS validated cryptographic modules.
+====
+////
+
+////
+[id="distributed-tracing-rn_3-2-1_jaeger-release-notes_support-for-elasticsearch-operator_{context}"]
+=== Support for {es-op}
+
+{JaegerName} 3.2.1 is supported for use with the {es-op} 5.6, 5.7, and 5.8.
+////
+
+////
+[id="distributed-tracing-rn_3-2-1_jaeger-release-notes_deprecated-functionality_{context}"]
+=== Deprecated functionality
+
+In the {DTProductName} 3.2.1, Jaeger and support for Elasticsearch remain deprecated, and both are planned to be removed in a future release.
+Red Hat will provide support for these components and fixes for CVEs and bugs with critical and higher severity during the current release lifecycle, but these components will no longer receive feature enhancements.
+The {TempoOperator} and the {OTELName} are the preferred Operators for distributed tracing collection and storage.
+Users must adopt the OpenTelemetry and Tempo distributed tracing stack because it is the stack to be enhanced going forward.
+
+In the {DTProductName} 3.2.1, the Jaeger agent is deprecated and planned to be removed in the following release.
+Red Hat will provide bug fixes and support for the Jaeger agent during the current release lifecycle, but the Jaeger agent will no longer receive enhancements and will be removed.
+The OpenTelemetry Collector provided by the {OTELName} is the preferred Operator for injecting the trace collector agent.
+////
+
+////
+[id="distributed-tracing-rn_3-2-1_jaeger-release-notes_removal-notice_{context}"]
+=== Removal notice
+
+In {DTProductName} 3.2.1, the FEATURE has been removed. Bug fixes and support are provided only through the end of the 3.? lifecycle. As an alternative to the FEATURE for USE CASE, you can use the ALTERNATIVE instead.
+////
+
+////
+[id="distributed-tracing-rn_3-2-1_jaeger-release-notes_new-features-and-enhancements_{context}"]
+=== New features and enhancements
+
+This update introduces the following enhancements for the {JaegerShortName}:
+
+* {JaegerName} 3.2.1 is based on the open source link:https://www.jaegertracing.io/[Jaeger] release 1.57.0.
+////
+
+////
+[id="distributed-tracing-rn_3-2-1_jaeger-release-notes_known-issues_{context}"]
+=== Known issues
+
+There is currently a known issue:
+
+* Currently, Apache Spark is not supported.
+
+ifndef::openshift-rosa[]
+
+* Currently, the streaming deployment via AMQ/Kafka is not supported on the {ibm-z-title} and {ibm-power-title} architectures.
+endif::openshift-rosa[]
+////
+
+include::modules/support.adoc[leveloffset=+1]
+
+include::modules/making-open-source-more-inclusive.adoc[leveloffset=+1]