Skip to content

Commit 6553bf7

Browse files
committed
Promote OTEL based ingestion but put the OTLP/HTTP endpoint under advanced topics
1 parent 355b3a6 commit 6553bf7

File tree

4 files changed

+21
-11
lines changed

4 files changed

+21
-11
lines changed

manage-data/data-store/data-streams/quickstart-tsds.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,12 @@ Use this quickstart to set up a time series data stream (TSDS), ingest a few doc
1313

1414
A _time series_ is a sequence of data points collected at regular time intervals. For example, you might track CPU usage or stock price over time. This quickstart uses simplified weather sensor readings to show how a TSDS helps you analyze metrics data over time.
1515

16+
::::{note}
17+
If you're looking to ingest OpenTelemetry metrics,
18+
follow the [OpenTelemetry quickstarts](/solutions/observability/get-started/opentelemetry/quickstart/index.md).
19+
This allows you to start sending data into a TSDS without having to worry about manually setting up data streams or configuring mappings.
20+
::::
21+
1622
## Prerequisites
1723

1824
* Access to [{{dev-tools-app}} Console](/explore-analyze/query-filter/tools/console.md) in {{kib}}, or another way to make {{es}} API requests
@@ -315,7 +321,6 @@ This quickstart introduced the basics of time series data streams. To learn more
315321

316322
* [](/manage-data/data-store/data-streams/time-series-data-stream-tsds.md)
317323
* [](/manage-data/data-store/data-streams/set-up-tsds.md)
318-
* [](/manage-data/data-store/data-streams/tsds-ingest-otlp.md)
319324

320325
For more information about the APIs used in this quickstart, review the {{es}} API reference documentation:
321326

manage-data/data-store/data-streams/set-up-tsds.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,9 @@ products:
1414
This page shows you how to manually set up a [time series data stream](/manage-data/data-store/data-streams/time-series-data-stream-tsds.md) (TSDS).
1515

1616
::::{note}
17-
For a simplified setup that doesn't require manually mapping dimension and metric fields via index templates,
18-
have a look at the [OpenTelemetry Protocol (OTLP)-based data ingestion](tsds-ingest-otlp.md).
17+
If you're looking to ingest OpenTelemetry metrics,
18+
follow the [OpenTelemetry quickstarts](/solutions/observability/get-started/opentelemetry/quickstart/index.md).
19+
This allows you to start sending data into a TSDS without having to worry about manually setting up data streams or configuring mappings.
1920
::::
2021

2122
## Before you begin [tsds-prereqs]

manage-data/data-store/data-streams/tsds-ingest-otlp.md

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,18 @@
11
---
2-
navigation_title: "Ingest OTLP metrics"
2+
navigation_title: "OTLP/HTTP endpoint"
33
applies_to:
44
stack: preview 9.2
55
products:
66
- id: elasticsearch
77
---
88

9-
# Ingest metrics using the OpenTelemetry Protocol (OTLP)
9+
# OTLP/HTTP endpoint
10+
11+
:::{important}
12+
Usually, you'll want to send data to an OpenTelemetry Collector or the [{{motlp}}](opentelemetry:/reference/motlp.md),
13+
rather than directly going to the {{es}} OTLP endpoint.
14+
See [Best practices](#best-practices) for more details.
15+
:::
1016

1117
In addition to the ingestion of metrics data through the bulk API,
1218
{{es}} offers an alternative way to ingest data via the [OpenTelemetry Protocol (OTLP)](https://opentelemetry.io/docs/specs/otlp).
@@ -25,10 +31,6 @@ Ingesting metrics data using the OTLP endpoint has the following advantages:
2531
there's no need to manually create data streams, index templates, or define dimensions and metrics.
2632
Metrics are dynamically mapped using the metadata included in the OTLP requests.
2733

28-
:::{important}
29-
On {{ecloud}} , use the [{{motlp}}](opentelemetry:/reference/motlp.md) instead of connecting directly to the {{es}} OTLP endpoint.
30-
:::
31-
3234
## How to send data to the OTLP endpoint
3335

3436
To send data from an OpenTelemetry Collector to the {{es}} OTLP endpoint,
@@ -69,7 +71,9 @@ use the [OpenTelemetry language SDK](https://opentelemetry.io/docs/getting-start
6971

7072
## Best practices
7173

72-
Do not send metrics from applications directly to the {{es}} OTLP endpoint, especially if there are many individual applications that periodically send a small amount of metrics. Instead, send data to an OpenTelemetry Collector first. This helps with handling many connections, and with creating bigger batches to improve ingestion performance. For more details on the recommended way to set up OpenTelemetry-based data ingestion, refer to the [EDOT reference architecture](opentelemetry:/reference/architecture/index.md).
74+
Do not send metrics from applications directly to the {{es}} OTLP endpoint, especially if there are many individual applications that periodically send a small amount of metrics. Instead, send data to an OpenTelemetry Collector first. This helps with handling many connections, and with creating bigger batches to improve ingestion performance. On {{ecloud}}, use the [{{motlp}}](opentelemetry:/reference/motlp.md) and for self-managed use cases, you can use the [Elastic Distribution of OpenTelemetry Collector](elastic-agent:/reference/edot-collector/index.md).
75+
76+
For more details on the recommended way to set up OpenTelemetry-based data ingestion, refer to the [EDOT reference architecture](opentelemetry:/reference/architecture/index.md).
7377

7478
## Send data to different data streams
7579

manage-data/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,6 @@ toc:
1515
children:
1616
- file: data-store/data-streams/quickstart-tsds.md
1717
- file: data-store/data-streams/set-up-tsds.md
18-
- file: data-store/data-streams/tsds-ingest-otlp.md
1918
- file: data-store/data-streams/downsampling-time-series-data-stream.md
2019
children:
2120
- file: data-store/data-streams/downsampling-concepts.md
@@ -25,6 +24,7 @@ toc:
2524
children:
2625
- file: data-store/data-streams/time-bound-tsds.md
2726
- file: data-store/data-streams/reindex-tsds.md
27+
- file: data-store/data-streams/tsds-ingest-otlp.md
2828
- file: data-store/data-streams/logs-data-stream.md
2929
- file: data-store/data-streams/failure-store.md
3030
children:

0 commit comments

Comments
 (0)