Skip to content
This repository was archived by the owner on Sep 2, 2025. It is now read-only.

Commit ddcdfd5

Browse files
Clarification
1 parent 12b1cf1 commit ddcdfd5

File tree

1 file changed

+12
-5
lines changed

1 file changed

+12
-5
lines changed

gdi/opentelemetry/deployment-modes.rst

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -85,12 +85,19 @@ Use data forwarding (gateway) mode when you want to do one of the following:
8585

8686
.. _collector-gateway-mode-tokens:
8787

88-
Consolidate tokens with a Collector in data forwarding (gateway) mode
88+
Token usage with a Collector in data forwarding (gateway) mode
89+
======================================================================
90+
91+
In a set-up where Collectors in host monitoring (agent) mode send data to another Collector in data forwarding or gateway mode, they don't send the data directly to Splunk Observability Cloud back-end. In this case, only the ingest token in the gateway Collector is used, and tokens in the Collectors that are sending data to a gateway are ignored, unless :ref:`they're using the SignalFx exporter <collector-signalfx-tokens>`. Therefore, you only need one valid token for the gateway Collector to see data in Splunk Observability Cloud, and the rest of Collectors could have invalid or expired tokens.
92+
93+
.. _collector-signalfx-tokens:
94+
95+
Token usage with the SignalFx exporter
8996
-------------------------------------------------------------------------------
9097

91-
When Collectors in host monitoring or agent mode send data to another Collector in data forwarding or gateway mode, they are not sending the data directly to Splunk Observability Cloud back-end. In this case, only the ingest token in the gateway Collector is used, and tokens in the Collectors that are sending data to a gateway are ignored.
98+
If any of your Collectors in agent mode is using the SignalFx exporter with the default configuration or if the exporter's setting ``access_token_passthrough`` is set to true, then data from that specific Collector will be sent to Splunk Observability Cloud using the Collector's access token instead of the Gateway Collector's token.
9299

93-
Therefore, you only need one valid token for the gateway Collector to see data in Splunk Observability Cloud, and the rest of Collectors could have invalid or expired tokens.
100+
Learn more at :ref:`signalfx-exporter`.
94101

95102
.. _collector-current-mode:
96103

@@ -152,7 +159,7 @@ You can find the different Helm charts in Github:
152159
Send data from an agent Collector to a gateway Collector
153160
======================================================================
154161

155-
You can manually configure a host monitoring (agent) Collector to send data to a Splunk Distribution of OpenTelemetry Collector gateway instance or cluster. This requires changing the :ref:`pipeline exporters <otel-data-processing>` in the agent to point to the gateway.
162+
You can manually configure a host monitoring (agent) Collector to send data to a Splunk Distribution of the OpenTelemetry Collector gateway instance or cluster. This requires changing the :ref:`pipeline exporters <otel-data-processing>` in the agent to point to the gateway.
156163

157164
To configure the Collector to send data to the another Collector in data forwarding (gateway) mode, see these configurations:
158165

@@ -303,7 +310,7 @@ Send metrics with the SignalFx exporter
303310

304311
If you want to use the :ref:`signalfx-exporter` for metrics on both agent and gateway, deactivate the aggregation at the Gateway. To do so, set the ``translation_rules`` and ``exclude_metrics`` to empty lists as in the following example.
305312

306-
.. note:: If you want to collect host metrics from the Gateway, use a different ``signalfx exporter`` with translation rules intact. For example, add the ``hostmetrics`` to the metrics/internal pipeline.
313+
.. note:: If you want to collect host metrics from the Gateway, use a different SignalFx exporter instance with translation rules intact. For example, add the ``hostmetrics`` to the metrics/internal pipeline.
307314

308315
.. code-block:: yaml
309316

0 commit comments

Comments
 (0)