elastic / elastic/docs-content

limitations.md calls the elasticsearch exporter unsupported, but it's the recommended gateway exporter

Open Beginner friendly
#8,238 1 comment 0 reactions 0 assignees View on GitHub
docs-fix:coherence Team:SKI
Dominant language
No language data
Stars
47
Forks
261
Avg merge
3d 21h
Merged PRs (30d)
141

Description

`limitations.md` says the `elasticsearch` exporter must not be used with Elastic APM / Observability. That's wrong: it's the recommended exporter for an Elastic Agent gateway on self-managed, ECE, and ECK. The distinction should be **edge vs gateway**, not supported vs unsupported.

## Incorrect

`solutions/observability/apm/opentelemetry/limitations.md:57`

> The [OpenTelemetry Collector exporter for Elastic](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/elasticsearchexporter) (which is different from the legacy exporter mentioned above) is not intended to be used with Elastic APM and Elastic Observability.

`solutions/observability/apm/opentelemetry/upstream-opentelemetry-collectors-language-sdks.md:148` repeats the claim and links to `limitations.md` as its justification:

> Using the [`elasticsearch` exporter](...) instead bypasses Elastic's data processing pipeline and is [not supported for use with {{product.observability}}](...).

Surfaced while working on #6569.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the cited passages at lines 57 and 148 of limitations.md and upstream-opentelemetry-collectors-language-sdks.md, then review the linked exporter context. Update both statements to distinguish edge and gateway deployments, including the documented self-managed, ECE, and ECK gateway use case. Done means the two pages no longer contradict the recommended gateway exporter guidance.

Written by the indexing model from the issue text.

Assessment

Tech stack
elasticsearch
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
84/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.