Skip to content

Conversation

marciw
Copy link
Contributor

@marciw marciw commented Oct 13, 2025

(Replaces #3222, which was an ominshambles)

This PR restructures and edits time series data stream docs as part of #1502.

❗ Notes for reviewers:

  • Changes were approved by Product and Engineering in Edit time series docs for clarity #3222 🙈
  • The content is "MVP" quality overall. More improvements coming soon via the follow-up issue, including reconciling the time series section with recent similar changes to the general data stream docs
  • The various applies_to thingies could probably be better; I am committed to maintaining the thinnest of grasps on applies_to metadata

Summary of changes:

@marciw marciw marked this pull request as ready for review October 13, 2025 21:51
@marciw marciw requested review from a team as code owners October 13, 2025 21:51
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note for reviewers: The OTLP page was added in #3360 (written by @felixbarny)

Slated for more improvements in #3179

@florent-leborgne
Copy link
Contributor

I really like seeing advanced topics explicitly gathered together 👏

Copy link
Contributor

@kilfoyle kilfoyle left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! 🦕
This looks great @marciw! The new layout is a big improvement.

Comment on lines +3 to +6
applies_to:
stack: preview 9.2
deployment:
self:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is this accurate? the endpoint only works for self-managed deployments? I see references to elastic cloud below but I'm not sure what the relationship is between the note and the page

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@theletterf did you happen to check this when reviewing the original PR? #3360

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, we specifically want to document that the ES OLTP endpoint is for self-managed only. For Cloud, we link to the Cloud OTLP Endpoint in the important section.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@marciw might be worth explaining a little in the important note the takeaway for self-managed folks

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@felixbarny I'm thinking about moving the Best practices to the top of this page and restructuring the intro a bit.

But in the meantime, can you help clarify:

  1. does the Elastic Cloud Managed OTLP endpoint work for both Elastic Cloud Hosted and Serverless?

  2. are there basically 3 options?

  • collector in gateway mode (recommended)
  • Elastic Cloud Managed OTLP endpoint
  • the OTLP/HTTP endpoint for self-managed, as described on your new page

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sounds good.

  1. Yes. See also https://www.elastic.co/docs/reference/opentelemetry/motlp#send-data-to-elastic, which lists instructions for serverless and ECH
  2. It's more like 2 options:
  • For ECH/Serverless there's the managed OTLP Endpoint that users can send data to directly from their applications or from another OTel collector. (if you will, the managed OTLP Endpoint is a managed gateway collector)
  • For self-managed, it's recommended that applications send their metrics to a gateway collector rather than directly to ES. The gateway collector may use the new OTLP Endpoint using the otlphttp exporter rather than the elasticsearch exporter for metrics (but at this point not for other signals).

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@felixbarny when we say self-managed, do we mean ECE/ECK/vanilla cluster?

Copy link
Contributor

@leemthompo leemthompo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💅 I had to dig very deep for the nittiest of nits :)

marciw and others added 4 commits October 16, 2025 11:40
Co-authored-by: David Kilfoyle <[email protected]>
Co-authored-by: David Kilfoyle <[email protected]>
Co-authored-by: David Kilfoyle <[email protected]>
Co-authored-by: David Kilfoyle <[email protected]>
Co-authored-by: Liam Thompson <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants