Merge pull request #102482 from openshift-cherrypick-robot/cherry-pick-102189-to-enterprise-4.18

[enterprise-4.18] OBSDOCS-2675: Modularize otel-config-multicluster.adoc

Author: max-cx

_topic_maps/_topic_map.yml

@@ -3220,8 +3220,8 @@ Topics:
     File: otel-forwarding-telemetry-data
   - Name: Configuring the Collector metrics
     File: otel-configuring-otelcol-metrics
-  - Name: Gathering the observability data from multiple clusters
-    File: otel-config-multicluster
+  - Name: Receiving telemetry data
+    File: otel-receiving-telemetry-data
   - Name: Troubleshooting the Red Hat build of OpenTelemetry
     File: otel-troubleshooting
   - Name: Migrating to the Red Hat build of OpenTelemetry

observability/otel/otel-config-multicluster.adoc renamed to modules/otel-receiving-telemetry-data-from-multiple-clusters.adoc

@@ -1,10 +1,13 @@
-:_mod-docs-content-type: ASSEMBLY
-include::_attributes/common-attributes.adoc[]
-[id="otel-gathering-observability-data-from-multiple-clusters"]
-= Gathering the observability data from multiple clusters
-:context: otel-gathering-observability-data-from-multiple-clusters
+// Module included in the following assemblies:
+//
+// * observability/otel/otel-receiving-telemetry-data.adoc
 
-For a multicluster configuration, you can create one OpenTelemetry Collector instance in each one of the remote clusters and then forward all the telemetry data to one OpenTelemetry Collector instance.
+:_mod-docs-content-type: PROCEDURE
+[id="otel-receiving-telemetry-data-from-multiple-clusters_{context}"]
+= Receiving telemetry data from multiple clusters
+
+[role="_abstract"]
+If you need the Collector to receive telemetry data from multiple remote clusters, create one OpenTelemetry Collector instance in each one of the remote clusters, and then have all of their telemetry data forwarded to a central OpenTelemetry Collector instance.
 
 .Prerequisites
 
@@ -259,4 +262,4 @@ spec:
       mountPath: /certs
 ----
 <1> The Collector receiver requires the certificates listed in the first step.
-<2> The Collector exporter is configured to export OTLP and points to the Tempo distributor endpoint, which in this example is `"tempo-simplest-distributor:4317"` and already created.
+<2> The Collector exporter is configured to export OTLP and points to the Tempo distributor endpoint, which in this example is `"tempo-simplest-distributor:4317"` and already created.

observability/otel/otel-receiving-telemetry-data.adoc

@@ -0,0 +1,13 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/common-attributes.adoc[]
+:context: otel-receiving-telemetry-data
+[id="otel-receiving-telemetry-data"]
+= Receiving telemetry data
+
+toc::[]
+
+[role="_abstract"]
+After setting up the OpenTelemetry Collector and instrumenting your application, you need to connect the instrumentation and OpenTelemetry Collector so that the OpenTelemetry Collector can receive telemetry data from the instrumentation.
+
+include::modules/otel-receiving-telemetry-data-from-multiple-clusters.adoc[leveloffset=+1]
+

welcome/learn_more_about_openshift.adoc

@@ -218,7 +218,7 @@ a|* xref:../operators/understanding/crds/crd-extending-api-with-crds.adoc#crd-cr
 | xref:../observability/distr_tracing/distr-tracing-tempo-architecture.adoc#distr-tracing-tempo-architecture[{DTProductName}]
 
 | xref:../observability/otel/otel-installing.adoc#install-otel[Red Hat build of OpenTelemetry]
-| xref:../observability/otel/otel-config-multicluster.adoc#otel-config-multicluster[Gathering the observability data from multiple clusters]
+| xref:../observability/otel/otel-receiving-telemetry-data.adoc#otel-receiving-telemetry-data[Receiving telemetry data from multiple clusters]
 
 | xref:../observability/network_observability/network-observability-overview.adoc#network-observability-overview[About Network Observability]
 a|* xref:../observability/network_observability/metrics-alerts-dashboards.adoc#metrics-alerts-dashboards_metrics-alerts-dashboards[Using metrics with dashboards and alerts]