Limitations
editLimitations
editOpenTelemetry traces
editOpenTelemetry logs
edit- [preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. The OpenTelemetry logs intake via APM Server is in technical preview.
-
The application logs data stream (
app_logs
) has dynamic mapping disabled. This means the automatic detection and mapping of new fields is disabled (see issue #9093).
OpenTelemetry Line Protocol (OTLP)
editAPM Server supports both the OTLP/gRPC and OTLP/HTTP protocol with ProtoBuf payload. APM Server does not yet support JSON Encoding for OTLP/HTTP.
OpenTelemetry Collector exporter for Elastic
editThe OpenTelemetry Collector exporter for Elastic has been deprecated and replaced by the native support of the OpenTelemetry Line Protocol in Elastic Observability (OTLP).
The Elasticsearch exporter for the OpenTelemetry Collector (which is different from the legacy exporter mentioned above) is not intended to be used with Elastic APM and Elastic Observability. Use Upstream OpenTelemetry Collectors and language SDKs instead.
OpenTelemetry’s tail-based sampling
editTail-based sampling allows to make sampling decisions after all spans of a trace have been completed. This allows for more powerful and informed sampling rules.
When using OpenTelemetry with Elastic APM, there are two different implementations available for tail-based sampling:
- Tail-based sampling using the tailsamplingprocessor in the OpenTelemetry Collector
- Native tail-based sampling in the Elastic APM backend
Using the tailsamplingprocessor in the OpenTelemetry Collector comes with an important limitation. Elastic’s APM backend calculates span and transaction metrics based on the incoming span events. These metrics are accurate for 100% sampling scenarios. In scenarios with probabilistic sampling, Elastic’s APM backend is being informed about the sampling rate of spans and can extrapolate throughput metrics based on the incoming, partial data. However, with tail-based sampling there’s no clear probability for sampling decisions as the rules can be more complex and the OpenTelemetry Collector does not provide sampling probability information to the Elastic backend that could be used for extrapolation of data. Therefore, there’s no way for Elastic APM to properly extrapolate throughput and count metrics that are derived from span events that have been tail-based sampled in the OpenTelemetry Collector. In these scenarios, derived throughput and count metrics are likely to be inaccurate.
Therefore, we recommend using Elastic’s native tail-based sampling when integrating with OpenTelemetry.