Skip to content

Add further clarification and align with wording in internal docs #62

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
nicklas-dohrn wants to merge 2 commits into
base: main
Choose a base branch
from
+15 −3
Open

Add further clarification and align with wording in internal docs #62

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
339b6a1
Add further clarification and align with wording in internal docs
nicklas-dohrn Sep 17, 2026
61c2295
Update docs/ingest-via-opentelemetry-api-endpoint-fdc78af.md
nicklas-dohrn Sep 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions docs/configuration-parameters-1830bca.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -544,10 +544,12 @@ Boolean
</td>
<td valign="top">

When set to true, spans are written to OpenSearch individually as they arrive, without assembling complete traces.
When set to `true`, spans are written to OpenSearch individually as they arrive, without assembling complete traces. Defaults to `false`.

This can be useful if you know that root/parent spans will be missing from your telemetry \(e.g., when only a subset of services in a request path emit spans\), so trace assembly cannot succeed anyway. In this case it lowers ingestion latency at the cost of trace completeness.

> ### Note:
> When span\_passthrough is enabled, the service map \(otel-v1-apm-service-map index\) is not populated and trace views in OpenSearch Dashboards may show incomplete traces. Use this only when you need raw span data and do not require service map or full trace assembly.
> When `span_passthrough` is enabled, the `otel-v1-apm-service-map` index is not populated, so the Service Map view in the Observability plugin of OpenSearch Dashboards will not function and the Trace Analytics view may show orphaned spans rather than complete trace trees.



Expand Down
12 changes: 11 additions & 1 deletion docs/ingest-via-opentelemetry-api-endpoint-fdc78af.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,17 @@ OpenTelemetry support in SAP Cloud Logging needs to be enabled with a service in
> }
> ```
>
> When `span_passthrough` is set to `true`, spans are written to OpenSearch individually as they arrive. The service map is not populated and trace views may show incomplete traces.
> ### Note:
> If you only need raw span data and do not require service map or full trace assembly, you can enable span passthrough mode (see [ingest_otlp configuration parameter](configuration-parameters-1830bca.md#loio1830bca1b060484e9cfabc0e62472e8e__table_zcy_jjx_jzb)):
>
> ```
> {
> "ingest_otlp": {
> "enabled": true,
> "span_passthrough": true
> }
> }
> ```

2. Retrieve Endpoint and Certificates.

Expand Down
Loading