diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index 39c99035c3..f85f55c37f 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -3240,8 +3240,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 58bcfcad69..351958dffe 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 0000000000..96a3b9c74d --- /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 d343d9ebb9..54c17298bc 100644 --- a/welcome/learn_more_about_openshift.adoc +++ b/welcome/learn_more_about_openshift.adoc @@ -215,7 +215,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]