Skip to content

Commit 35e1cb1

Browse files
committed
OBSDOCS-1595: Release notes for Distributed tracing 3.5
1 parent aec9f93 commit 35e1cb1

9 files changed

+197
-26
lines changed

observability/distr_tracing/distr-tracing-rn.adoc

Lines changed: 114 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,120 @@ You can use the {TempoName} xref:../../observability/otel/otel-forwarding-teleme
1212

1313
include::snippets/distr-tracing-and-otel-disclaimer-about-docs-for-supported-features-only.adoc[]
1414

15+
[id="distr-tracing_3-5_{context}"]
16+
== Release notes for {DTProductName} 3.5
17+
18+
This release of the {DTProductName} includes the {TempoName} and the deprecated {JaegerName}.
19+
20+
////
21+
[id="distr-tracing_3-5_cves_{context}"]
22+
=== CVEs
23+
24+
This release fixes the following CVEs:
25+
26+
* ???
27+
////
28+
29+
[id="distr-tracing_3-5_tempo-release-notes_{context}"]
30+
=== {TempoName}
31+
32+
The {TempoName} 3.5 is provided through the link:https://catalog.redhat.com/software/containers/rhosdt/tempo-operator-bundle/642c3e0eacf1b5bdbba7654a/history[{TempoOperator} 0.15.3].
33+
34+
[NOTE]
35+
====
36+
The {TempoName} 3.5 is based on the open source link:https://grafana.com/oss/tempo/[Grafana Tempo] 2.7.1.
37+
====
38+
39+
[id="distr-tracing_3-5_tempo-release-notes_new-features-and-enhancements_{context}"]
40+
==== New features and enhancements
41+
42+
This update introduces the following enhancements:
43+
44+
* With this update, you can configure the Tempo backend services to report the internal tracing data by using the OpenTelemetry Protocol (OTLP).
45+
* With this update, the `traces.span.metrics` namespace becomes the default metrics namespace on which the Jaeger query retrieves the Prometheus metrics. The purpose of this change is to provide compatibility with the OpenTelemetry Collector version 0.109.0 and later where this namespace is the default. Customers who are still using an earlier OpenTelemetry Collector version can configure this namespace by adding the following field and value: `spec.template.queryFrontend.jaegerQuery.monitorTab.redMetricsNamespace: ""`.
46+
47+
[id="distr-tracing_3-5_tempo-release-notes_bug-fixes_{context}"]
48+
==== Bug fixes
49+
50+
This update introduces the following bug fix:
51+
52+
////
53+
* Before this update, the `oauth-proxy` container did not have any compute resources assigned to it. With this update, the container correctly sets the resources as specified in the `TempoStack` custom resource.
54+
////
55+
56+
* Before this update, the {TempoOperator} failed when the `TempoStack` custom resource had the `spec.storage.tls.enabled` field set to `true` and used an Amazon S3 object store with the Security Token Service (STS) authentication. With this update, such a `TempoStack` custom resource configuration does not cause the {TempoOperator} to fail.
57+
58+
[id="distr-tracing_3-5_jaeger-release-notes_{context}"]
59+
=== {JaegerName}
60+
61+
The {JaegerName} 3.5 is the last release of the {JaegerName} that Red Hat plans to support.
62+
63+
In the {DTProductName} 3.5, Jaeger and support for Elasticsearch remain deprecated.
64+
65+
[WARNING]
66+
====
67+
Support for the {JaegerName} ends on November 3, 2025.
68+
69+
The {JaegerOperator} Operator (Jaeger) will be removed from the `redhat-operators` catalog on November 3, 2025.
70+
====
71+
72+
You must migrate to the {OTELName} Operator and the {TempoOperator} for distributed tracing collection and storage. For more information, see the following resources:
73+
74+
* xref:../../observability/otel/otel-migrating.adoc#dist-tracing-otel-migrating[Migrating] ({OTELShortName} documentation)
75+
76+
* xref:../../observability/otel/otel-installing.adoc#install-otel[Installing] ({OTELName} documentation)
77+
78+
* xref:../../observability/distr_tracing/distr_tracing_tempo/distr-tracing-tempo-installing.adoc#dist-tracing-tempo-installing[Installing] ({TempoShortName} documentation)
79+
80+
* link:https://access.redhat.com/solutions/7083722[Jaeger Deprecation and Removal in OpenShift] (Red Hat Knowledgebase solution)
81+
82+
[NOTE]
83+
====
84+
The {JaegerName} 3.5 is based on the open source link:https://www.jaegertracing.io/[Jaeger] release 1.65.0.
85+
====
86+
// 1.62.0 was fixed until Jaeger's removal
87+
88+
The {JaegerName} 3.5 is provided through the link:https://catalog.redhat.com/software/containers/rhosdt/jaeger-operator-bundle/613b50f3a052bb39f2c5f31e/history[{JaegerOperator} Operator 1.65.0].
89+
90+
[IMPORTANT]
91+
====
92+
Jaeger does not use FIPS validated cryptographic modules.
93+
====
94+
95+
[id="distr-tracing_3-5_jaeger-release-notes_support-for-elasticsearch-operator_{context}"]
96+
==== Support for the {es-op}
97+
98+
The {JaegerName} 3.5 is supported for use with the {es-op} 5.6, 5.7, and 5.8.
99+
100+
[role="_additional-resources"]
101+
.Additional resources
102+
* link:https://access.redhat.com/solutions/7083722[Jaeger Deprecation and Removal in OpenShift] (Red Hat Knowledgebase)
103+
* xref:../../observability/otel/otel-migrating.adoc#dist-tracing-otel-migrating[Migrating] ({OTELName} documentation)
104+
* xref:../../observability/otel/otel-installing.adoc#install-otel[Installing] ({OTELName} documentation)
105+
* xref:../../observability/distr_tracing/distr_tracing_tempo/distr-tracing-tempo-installing.adoc#dist-tracing-tempo-installing[Installing] (Distributed tracing platform (Tempo) documentation)
106+
107+
////
108+
[id="distr-tracing_3-5_jaeger-release-notes_bug-fixes_{context}"]
109+
==== Bug fixes
110+
111+
This update introduces the following bug fix:
112+
113+
* ???
114+
115+
////
116+
117+
[id="distr-tracing_3-5_jaeger-release-notes_known-issues_{context}"]
118+
==== Known issues
119+
120+
There are currently known issues:
121+
122+
* Currently, Apache Spark is not supported.
123+
124+
ifndef::openshift-rosa[]
125+
126+
* Currently, the streaming deployment via AMQ/Kafka is not supported on the {ibm-z-title} and {ibm-power-title} architectures.
127+
endif::openshift-rosa[]
128+
15129
[id="distr-tracing_3-4_{context}"]
16130
== Release notes for {DTProductName} 3.4
17131

observability/distr_tracing/distr_tracing_jaeger/distr-tracing-jaeger-configuring.adoc

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ include::_attributes/common-attributes.adoc[]
66

77
toc::[]
88

9-
:FeatureName: The {JaegerName}
109
include::snippets/distr-tracing-assembly-tip-for-jaeger-replacements.adoc[]
1110

1211
The {JaegerName} Operator uses a custom resource definition (CRD) file that defines the architecture and configuration settings to be used when creating and deploying the {JaegerShortName} resources. You can install the default configuration or modify the file.

observability/distr_tracing/distr_tracing_jaeger/distr-tracing-jaeger-installing.adoc

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ include::_attributes/common-attributes.adoc[]
66

77
toc::[]
88

9-
:FeatureName: The {JaegerName}
109
include::snippets/distr-tracing-assembly-tip-for-jaeger-replacements.adoc[]
1110

1211
You can install {DTProductName} on {product-title} in either of two ways:

observability/distr_tracing/distr_tracing_jaeger/distr-tracing-jaeger-removing.adoc

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ include::_attributes/common-attributes.adoc[]
66

77
toc::[]
88

9-
:FeatureName: The {JaegerName}
109
include::snippets/distr-tracing-assembly-tip-for-jaeger-replacements.adoc[]
1110

1211
The steps for removing {DTProductName} from an {product-title} cluster are as follows:

observability/distr_tracing/distr_tracing_jaeger/distr-tracing-jaeger-updating.adoc

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ include::_attributes/common-attributes.adoc[]
66

77
toc::[]
88

9-
:FeatureName: The {JaegerName}
109
include::snippets/distr-tracing-assembly-tip-for-jaeger-replacements.adoc[]
1110

1211
Operator Lifecycle Manager (OLM) controls the installation, upgrade, and role-based access control (RBAC) of Operators in a cluster. The OLM runs by default in {product-title}.

observability/otel/otel-collector/otel-collector-receivers.adoc

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -106,9 +106,6 @@ The Jaeger Receiver ingests traces in the Jaeger formats.
106106

107107
The Host Metrics Receiver ingests metrics in the OTLP format.
108108

109-
:FeatureName: The Host Metrics Receiver
110-
include::snippets/technology-preview.adoc[]
111-
112109
.OpenTelemetry Collector custom resource with an enabled Host Metrics Receiver
113110
[source,yaml]
114111
----
@@ -290,9 +287,6 @@ spec:
290287

291288
The Kubelet Stats Receiver extracts metrics related to nodes, pods, containers, and volumes from the kubelet's API server. These metrics are then channeled through the metrics-processing pipeline for additional analysis.
292289

293-
:FeatureName: The Kubelet Stats Receiver
294-
include::snippets/technology-preview.adoc[]
295-
296290
.OpenTelemetry Collector custom resource with an enabled Kubelet Stats Receiver
297291
[source,yaml]
298292
----

observability/otel/otel-migrating.adoc

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,7 @@ include::_attributes/common-attributes.adoc[]
66

77
toc::[]
88

9-
:FeatureName: The {JaegerName}
10-
include::modules/deprecated-feature.adoc[]
9+
include::snippets/distr-tracing-assembly-tip-for-jaeger-replacements.adoc[]
1110

1211
If you are already using the {JaegerName} for your applications, you can migrate to the {OTELName}, which is based on the link:https://opentelemetry.io/[OpenTelemetry] open-source project.
1312

observability/otel/otel-rn.adoc

Lines changed: 75 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,76 @@ You can use the {OTELName} xref:../../observability/otel/otel-forwarding-telemet
1212

1313
include::snippets/distr-tracing-and-otel-disclaimer-about-docs-for-supported-features-only.adoc[]
1414

15+
[id="otel_3-5_{context}"]
16+
== Release notes for {OTELName} 3.5
17+
18+
The {OTELName} 3.5 is provided through the link:https://catalog.redhat.com/software/containers/rhosdt/opentelemetry-operator-bundle/615618406feffc5384e84400/history[{OTELOperator} 0.119.0].
19+
20+
[NOTE]
21+
====
22+
The {OTELName} 3.5 is based on the open source link:https://opentelemetry.io/docs/collector/[OpenTelemetry] release 0.119.0.
23+
====
24+
25+
////
26+
[id="otel_3-5_technology-preview-features_{context}"]
27+
=== Technology Preview features
28+
29+
This update introduces the following Technology Preview features:
30+
31+
* AWS CloudWatch Exporter
32+
* AWS EMF Exporter
33+
* AWS X-Ray Exporter
34+
35+
:FeatureName: Each of these features
36+
include::snippets/technology-preview.adoc[leveloffset=+1]
37+
////
38+
39+
[id="otel_3-5_new-features-and-enhancements_{context}"]
40+
=== New features and enhancements
41+
42+
This update introduces the following enhancements:
43+
44+
* The following link:https://access.redhat.com/support/offerings/techpreview[Technology Preview] features reach General Availability:
45+
** Host Metrics Receiver
46+
** Kubelet Stats Receiver
47+
* With this update, the OpenTelemetry Collector uses the OTLP HTTP Exporter to push logs to a LokiStack instance.
48+
* With this update, the Operator automatically creates RBAC rules for the Kubernetes Events Receiver (`k8sevents`), Kubernetes Cluster Receiver (`k8scluster`), and Kubernetes Objects Receiver (`k8sobjects`) if the Operator has sufficient permissions. For more information, see "Creating the required RBAC resources automatically" in _Configuring the Collector_.
49+
50+
[id="otel_3-5_deprecated-functionality_{context}"]
51+
=== Deprecated functionality
52+
53+
In the {OTELName} 3.5, the Loki Exporter, which is a temporary Technology Preview feature, is deprecated. The Loki Exporter is planned to be removed in the {OTELName} 3.6. If you currently use the Loki Exporter for the OpenShift Logging 6.1 or later, replace the Loki Exporter with the OTLP HTTP Exporter.
54+
55+
:FeatureName: The Loki Exporter
56+
include::snippets/technology-preview.adoc[leveloffset=+1]
57+
58+
////
59+
In the {OTELName} 3.5, ???. (link:https://issues.redhat.com/browse/TRACING-????/[TRACING-????])
60+
////
61+
62+
////
63+
[id="otel_3-5_removal-notice_{context}"]
64+
=== Removal notice
65+
66+
In the {OTELName} 3.5, 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.
67+
////
68+
69+
[id="otel_3-5_bug-fixes_{context}"]
70+
=== Bug fixes
71+
72+
This update introduces the following bug fix:
73+
74+
* Before this update, manually created routes for the Collector services were unintentionally removed when the Operator pod was restarted. With this update, restarting the Operator pod does not result in the removal of the manually created routes.
75+
76+
////
77+
[id="otel_3-5_known-issues_{context}"]
78+
=== Known issues
79+
80+
There are currently known issues:
81+
82+
* ???. (link:https://issues.redhat.com/browse/TRACING-????/[TRACING-????])
83+
////
84+
1585
[id="otel_3-4_{context}"]
1686
== Release notes for {OTELName} 3.4
1787

@@ -91,7 +161,7 @@ This update introduces the following enhancements:
91161
////
92162

93163
////
94-
[id="otel_3-3-1_jaeger-release-notes_deprecated-functionality_{context}"]
164+
[id="otel_3-3-1_deprecated-functionality_{context}"]
95165
=== Deprecated functionality
96166
97167
In the {OTELName} 3.3.1, ???. (link:https://issues.redhat.com/browse/TRACING-????/[TRACING-????])
@@ -158,7 +228,7 @@ This update introduces the following enhancements:
158228
* Support for automatically reloading certificates in both the OpenTelemetry Collector and instrumentation. (link:https://issues.redhat.com/browse/TRACING-4186[TRACING-4186])
159229

160230
////
161-
[id="otel_3-3_jaeger-release-notes_deprecated-functionality_{context}"]
231+
[id="otel_3-3_deprecated-functionality_{context}"]
162232
=== Deprecated functionality
163233
164234
In the {OTELName} 3.3, ???. (link:https://issues.redhat.com/browse/TRACING-????/[TRACING-????])
@@ -223,7 +293,7 @@ This update introduces the following enhancement:
223293
////
224294

225295
////
226-
[id="otel_3-2-2_jaeger-release-notes_deprecated-functionality_{context}"]
296+
[id="otel_3-2-2_deprecated-functionality_{context}"]
227297
=== Deprecated functionality
228298
229299
In the {OTELName} 3.2.2, ...
@@ -285,7 +355,7 @@ This update introduces the following enhancement:
285355
* {OTELName} 3.2.1 is based on the open source link:https://opentelemetry.io/[OpenTelemetry] release 0.102.1.
286356

287357
////
288-
[id="otel_3-2-1_jaeger-release-notes_deprecated-functionality_{context}"]
358+
[id="otel_3-2-1_deprecated-functionality_{context}"]
289359
=== Deprecated functionality
290360
291361
In the {OTELName} 3.2.1, ...
@@ -356,7 +426,7 @@ This update introduces the following enhancement:
356426

357427
* {OTELName} 3.2 is based on the open source link:https://opentelemetry.io/[OpenTelemetry] release 0.100.0.
358428

359-
[id="otel_3-2_jaeger-release-notes_deprecated-functionality_{context}"]
429+
[id="otel_3-2_deprecated-functionality_{context}"]
360430
=== Deprecated functionality
361431

362432
In {OTELName} 3.2, use of empty values and `null` keywords in the OpenTelemetry Collector custom resource is deprecated and planned to be unsupported in a future release. Red Hat will provide bug fixes and support for this syntax during the current release lifecycle, but this syntax will become unsupported. As an alternative to empty values and `null` keywords, you can update the OpenTelemetry Collector custom resource to contain empty JSON objects as open-closed braces `{}` instead.

snippets/distr-tracing-assembly-tip-for-jaeger-replacements.adoc

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -14,18 +14,16 @@
1414

1515
:_mod-docs-content-type: SNIPPET
1616

17-
[IMPORTANT]
17+
[WARNING]
1818
====
1919
[subs="attributes+"]
20-
{FeatureName} is a deprecated feature. Deprecated functionality is still included in {product-title} and continues to be supported; however, it will be removed in a future release of this product and is not recommended for new deployments.
20+
The {JaegerName} 3.5 is the last release of the {JaegerName} that Red Hat plans to support.
2121
22-
The {JaegerOperator} Operator (Jaeger) will be removed from the `redhat-operators` catalog in a future release. For more information, see the Red Hat Knowledgebase solution link:https://access.redhat.com/solutions/7083722[Jaeger Deprecation and Removal in OpenShift].
22+
In the {DTProductName} 3.5, Jaeger and support for Elasticsearch remain deprecated.
2323
24-
You must migrate to the {OTELName} Operator and the {TempoOperator} for distributed tracing collection and storage. For more information, see "Migrating" in the {OTELShortName} documentation, "Installing" in the {OTELName} documentation, and "Installing" in the {TempoShortName} documentation.
24+
Support for the {JaegerName} ends on November 3, 2025.
25+
26+
The {JaegerOperator} Operator (Jaeger) will be removed from the `redhat-operators` catalog on November 3, 2025. For more information, see the Red Hat Knowledgebase solution link:https://access.redhat.com/solutions/7083722[Jaeger Deprecation and Removal in OpenShift].
2527
26-
ifndef::openshift-rosa,openshift-dedicated[]
27-
For the most recent list of major functionality that has been deprecated or removed within {product-title}, refer to the _Deprecated and removed features_ section of the {product-title} release notes.
28-
endif::openshift-rosa,openshift-dedicated[]
28+
You must migrate to the {OTELName} Operator and the {TempoOperator} for distributed tracing collection and storage. For more information, see "Migrating" in the {OTELShortName} documentation, "Installing" in the {OTELName} documentation, and "Installing" in the {TempoShortName} documentation.
2929
====
30-
// Undefine {FeatureName} attribute, so that any mistakes are easily spotted
31-
:!FeatureName:

0 commit comments

Comments
 (0)