From c92055162fcec1dabcbcd7bb6d3f9ea8225223da Mon Sep 17 00:00:00 2001 From: Kalyani Desai Date: Tue, 11 Nov 2025 12:22:05 +0530 Subject: [PATCH] OBSDOCS-2675: Extracted multicluster observability procedure into a new proc module from the assembly --- _topic_maps/_topic_map.yml | 4 ++-- ...g-telemetry-data-from-multiple-clusters.adoc | 17 ++++++++++------- .../otel/otel-receiving-telemetry-data.adoc | 13 +++++++++++++ welcome/learn_more_about_openshift.adoc | 2 +- 4 files changed, 26 insertions(+), 10 deletions(-) rename observability/otel/otel-config-multicluster.adoc => modules/otel-receiving-telemetry-data-from-multiple-clusters.adoc (90%) create mode 100644 observability/otel/otel-receiving-telemetry-data.adoc diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index b822aa345c05..81cea1c847db 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -3247,8 +3247,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 diff --git a/observability/otel/otel-config-multicluster.adoc b/modules/otel-receiving-telemetry-data-from-multiple-clusters.adoc similarity index 90% rename from observability/otel/otel-config-multicluster.adoc rename to modules/otel-receiving-telemetry-data-from-multiple-clusters.adoc index 58bcfcad6933..351958dffe9e 100644 --- a/observability/otel/otel-config-multicluster.adoc +++ b/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. \ No newline at end of file diff --git a/observability/otel/otel-receiving-telemetry-data.adoc b/observability/otel/otel-receiving-telemetry-data.adoc new file mode 100644 index 000000000000..96a3b9c74d77 --- /dev/null +++ b/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] + diff --git a/welcome/learn_more_about_openshift.adoc b/welcome/learn_more_about_openshift.adoc index 005fabb8383c..1174be1d969f 100644 --- a/welcome/learn_more_about_openshift.adoc +++ b/welcome/learn_more_about_openshift.adoc @@ -213,7 +213,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]