Skip to content

Commit 044a70a

Browse files
authored
Clean up OpenTelemetry content (#985)
1 parent 6895042 commit 044a70a

17 files changed

+27
-825
lines changed

redirects.yml

+10-4
Original file line numberDiff line numberDiff line change
@@ -30,10 +30,16 @@ redirects:
3030
'solutions/observability/apps/real-user-monitoring-rum.md': 'solutions/observability/apm/real-user-monitoring-rum.md'
3131
'solutions/observability/apps/create-upload-source-maps-rum.md': 'solutions/observability/apm/create-upload-source-maps-rum.md'
3232
'solutions/observability/apps/use-opentelemetry-with-apm.md': 'solutions/observability/apm/use-opentelemetry-with-apm.md'
33-
'solutions/observability/apps/upstream-opentelemetry-collectors-language-sdks.md': 'solutions/observability/apm/upstream-opentelemetry-collectors-language-sdks.md'
34-
'solutions/observability/apps/collect-metrics.md': 'solutions/observability/apm/collect-metrics.md'
35-
'solutions/observability/apps/limitations.md': 'solutions/observability/apm/limitations.md'
36-
'solutions/observability/apps/resource-atrributes.md': 'solutions/observability/apm/resource-attributes.md'
33+
'solutions/observability/apps/upstream-opentelemetry-collectors-language-sdks.md': 'solutions/observability/apm/use-opentelemetry-with-apm.md'
34+
'solutions/observability/apps/collect-metrics.md': 'solutions/observability/apm/use-opentelemetry-with-apm.md'
35+
'solutions/observability/apps/limitations.md': 'solutions/observability/apm/use-opentelemetry-with-apm.md'
36+
'solutions/observability/apps/resource-atrributes.md': 'solutions/observability/apm/use-opentelemetry-with-apm.md'
37+
'solutions/observability/apm/collect-metrics.md': 'solutions/observability/apm/use-opentelemetry-with-apm.md'
38+
'solutions/observability/apm/limitations.md': 'solutions/observability/apm/use-opentelemetry-with-apm.md'
39+
'solutions/observability/apm/resource-attributes.md': 'solutions/observability/apm/use-opentelemetry-with-apm.md'
40+
'solutions/observability/apm/upstream-opentelemetry-collectors-language-sdks.md': 'solutions/observability/apm/use-opentelemetry-with-apm.md'
41+
'solutions/observability/get-started/quickstart-monitor-hosts-with-opentelemetry.md': 'solutions/observability/get-started.md'
42+
'solutions/observability/get-started/quickstart-unified-kubernetes-observability-with-elastic-distributions-of-opentelemetry-edot.md': 'solutions/observability/get-started.md'
3743
'solutions/observability/apps/apm-k8s-attacher.md': 'solutions/observability/apm/apm-k8s-attacher.md'
3844
'solutions/observability/apps/monitoring-aws-lambda-functions.md': 'solutions/observability/apm/monitor-aws-lambda-functions.md'
3945
'solutions/observability/apps/integrate-with-jaeger-deprecated.md': 'solutions/observability/apm/jaeger.md'

solutions/observability/apm/collect-metrics.md

-54
This file was deleted.

solutions/observability/apm/get-started-apm-server-binary.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -732,9 +732,9 @@ const apm = initApm({
732732
::::::
733733
734734
::::::{tab-item} OpenTelemetry
735-
Elastic integrates with OpenTelemetry, allowing you to reuse your existing instrumentation to easily send observability data to the {{stack}}.
735+
Elastic integrates with OpenTelemetry using the Elastic Distribution of OpenTelemetry (EDOT), allowing you to reuse your existing instrumentation to easily send observability data to the {{stack}}.
736736
737-
For more information on how to combine Elastic and OpenTelemetry, see [OpenTelemetry integration](/solutions/observability/apm/use-opentelemetry-with-apm.md).
737+
For more information on how to combine Elastic and OpenTelemetry, see the [EDOT documentation](https://elastic.github.io/opentelemetry/).
738738
::::::
739739
740740
:::::::

solutions/observability/apm/get-started-fleet-managed-apm-server.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -773,9 +773,9 @@ const apm = initApm({
773773
::::::
774774
775775
::::::{tab-item} OpenTelemetry
776-
Elastic integrates with OpenTelemetry, allowing you to reuse your existing instrumentation to easily send observability data to the {{stack}}.
776+
Elastic integrates with OpenTelemetry using the Elastic Distribution of OpenTelemetry (EDOT), allowing you to reuse your existing instrumentation to easily send observability data to the {{stack}}.
777777
778-
For more information on how to combine Elastic and OpenTelemetry, see [OpenTelemetry integration](/solutions/observability/apm/use-opentelemetry-with-apm.md).
778+
For more information on how to combine Elastic and OpenTelemetry, see the [EDOT documentation](https://elastic.github.io/opentelemetry/).
779779
::::::
780780
781781
:::::::

solutions/observability/apm/limitations.md

-49
This file was deleted.

solutions/observability/apm/managed-intake-service-event-api.md

+1-3
Original file line numberDiff line numberDiff line change
@@ -4476,7 +4476,5 @@ The managed intake service supports two OTLP communication protocols on the same
44764476
| OTLP logs intake | `/v1/logs` |
44774477

44784478
::::{tip}
4479-
See our [OpenTelemetry docs](/solutions/observability/apm/upstream-opentelemetry-collectors-language-sdks.md) to learn how to send data to the managed intake service from an OpenTelemetry agent OpenTelemetry collector.
4480-
4479+
See our [OpenTelemetry documentation](https://elastic.github.io/opentelemetry/) to learn how to send data to the managed intake service.
44814480
::::
4482-

solutions/observability/apm/opentelemetry-intake-api.md

+1-3
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,6 @@
11
---
22
mapped_pages:
33
- https://www.elastic.co/guide/en/observability/current/apm-api-otlp.html
4-
applies_to:
5-
stack:
64
---
75

86
# OpenTelemetry intake API [apm-api-otlp]
@@ -31,6 +29,6 @@ APM Server supports two OTLP communication protocols on the same port:
3129
| OTLP logs intake | `/v1/logs` |
3230

3331
::::{tip}
34-
See our OpenTelemetry documentation to learn how to send data to the APM Server from an [OpenTelemetry agent](/solutions/observability/apm/upstream-opentelemetry-collectors-language-sdks.md#apm-instrument-apps-otel) or [OpenTelemetry collector](/solutions/observability/apm/upstream-opentelemetry-collectors-language-sdks.md#apm-connect-open-telemetry-collector).
32+
See our [OpenTelemetry documentation](https://elastic.github.io/opentelemetry/) to learn how to send data to the APM Server.
3533
::::
3634

solutions/observability/apm/resource-attributes.md

-48
This file was deleted.

solutions/observability/apm/traces.md

-6
Original file line numberDiff line numberDiff line change
@@ -37,12 +37,6 @@ In this example, Elastic’s Ruby agent communicates with Elastic’s Java agent
3737
:alt: How traceparent propagation works
3838
:::
3939

40-
In this example, Elastic’s Ruby agent communicates with OpenTelemetry’s Java agent. Both support the `traceparent` header, and trace data is successfully propagated.
41-
42-
:::{image} /solutions/images/observability-dt-trace-ex2.png
43-
:alt: How traceparent propagation works
44-
:::
45-
4640
In this example, the trace meets a piece of middleware that doesn’t propagate the `traceparent` header. The distributed trace ends and any further communication will result in a new trace.
4741

4842
:::{image} /solutions/images/observability-dt-trace-ex3.png

solutions/observability/apm/transaction-sampling.md

-23
Original file line numberDiff line numberDiff line change
@@ -84,23 +84,6 @@ In the example in *Figure 4*, `Service A` and `Service B` are Elastic-monitored
8484
:title: Using the `restart` trace continuation strategy
8585
:::
8686

87-
### OpenTelemetry [_opentelemetry]
88-
89-
Head-based sampling is implemented directly in the APM agents and SDKs. The sample rate must be propagated between services and the managed intake service in order to produce accurate metrics.
90-
91-
OpenTelemetry offers multiple samplers. However, most samplers do not propagate the sample rate. This results in inaccurate span-based metrics, like APM throughput, latency, and error metrics.
92-
93-
For accurate span-based metrics when using head-based sampling with OpenTelemetry, you must use a [consistent probability sampler](https://opentelemetry.io/docs/specs/otel/trace/tracestate-probability-sampling/). These samplers propagate the sample rate between services and the managed intake service, resulting in accurate metrics.
94-
95-
::::{note}
96-
OpenTelemetry does not offer consistent probability samplers in all languages. OpenTelemetry users should consider using tail-based sampling instead.
97-
98-
Refer to the documentation of your favorite OpenTelemetry agent or SDK for more information on the availability of consistent probability samplers.
99-
100-
::::
101-
102-
% Stateful only for tail-based sampling
103-
10487
## Tail-based sampling [apm-tail-based-sampling]
10588

10689
```{applies_to}
@@ -133,12 +116,6 @@ In this example, `Service A` initiates four transactions. If our sample rate is
133116
:alt: Distributed tracing and tail based sampling example one
134117
:::
135118

136-
### OpenTelemetry with tail-based sampling [_opentelemetry_with_tail_based_sampling]
137-
138-
Tail-based sampling is implemented entirely in APM Server, and will work with traces sent by either Elastic APM agents or OpenTelemetry SDKs.
139-
140-
Due to [OpenTelemetry tail-based sampling limitations](/solutions/observability/apm/limitations.md#apm-open-telemetry-tbs) when using [tailsamplingprocessor](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/processor/tailsamplingprocessor), we recommend using APM Server tail-based sampling instead.
141-
142119
### Tail-based sampling performance and requirements [_tail_based_sampling_performance_and_requirements]
143120

144121
Tail-based sampling (TBS), by definition, requires storing events locally temporarily, such that they can be retrieved and forwarded when a sampling decision is made.

0 commit comments

Comments
 (0)