Skip to content

Commit 355b3a6

Browse files
committed
Address review comments
1 parent 4479c8c commit 355b3a6

File tree

2 files changed

+12
-4
lines changed

2 files changed

+12
-4
lines changed

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,10 @@ products:
1313

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

16+
::::{note}
1617
For a simplified setup that doesn't require manually mapping dimension and metric fields via index templates,
1718
have a look at the [OpenTelemetry Protocol (OTLP)-based data ingestion](tsds-ingest-otlp.md).
19+
::::
1820

1921
## Before you begin [tsds-prereqs]
2022

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

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,11 +13,16 @@ In addition to the ingestion of metrics data through the bulk API,
1313

1414
The endpoint is available under `/_otlp/v1/metrics`.
1515

16+
:::{note}
17+
{{es}} only supports [OTLP/HTTP](https://opentelemetry.io/docs/specs/otlp/#otlphttp),
18+
not [OTLP/gRPC](https://opentelemetry.io/docs/specs/otlp/#otlpgrpc).
19+
:::
20+
1621
Ingesting metrics data using the OTLP endpoint has the following advantages:
1722

1823
* Improved ingestion performance, especially if the data contains many resource attributes.
1924
* Simplified index mapping:
20-
there's no need to manually create an index template, or define dimensions and metrics.
25+
there's no need to manually create data streams, index templates, or define dimensions and metrics.
2126
Metrics are dynamically mapped using the metadata included in the OTLP requests.
2227

2328
:::{important}
@@ -62,12 +67,10 @@ The supported options for `compression` are `gzip` (default value of the `OTLP/H
6267
To track metrics in your custom application,
6368
use the [OpenTelemetry language SDK](https://opentelemetry.io/docs/getting-started/dev/) of your choice.
6469

65-
## When not to use the {{es}} OTLP endpoint
70+
## Best practices
6671

6772
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).
6873

69-
At this point, {{es}} only supports the OTLP metrics endpoint (`/_otlp/v1/metrics`). Other signals are not supported through a native {{es}} OTLP endpoint at the moment. To ingest logs, traces, and profiles, use a distribution of the OpenTelemetry Collector that includes the [{{es}} exporter](opentelemetry:/reference/edot-collector/components/elasticsearchexporter.md), like the [Elastic Distribution of OpenTelemetry (EDOT) Collector](opentelemetry:/reference/edot-collector/index.md).
70-
7174
## Send data to different data streams
7275

7376
By default, metrics are ingested into the `metrics-generic.otel-default` data stream. You can influence the target data stream by setting specific attributes on your data:
@@ -80,5 +83,8 @@ The target data stream name is constructed as `metrics-${data_stream.dataset}.ot
8083

8184
## Limitations
8285

86+
* Only the OTLP metrics endpoint (`/_otlp/v1/metrics`) is supported.
87+
To ingest logs, traces, and profiles, use a distribution of the OpenTelemetry Collector that includes the [{{es}} exporter](opentelemetry:/reference/edot-collector/components/elasticsearchexporter.md),
88+
such as the [Elastic Distribution of OpenTelemetry (EDOT) Collector](opentelemetry:/reference/edot-collector/index.md).
8389
* Histograms are only supported in delta temporality. Set the temporality preference to delta in your SDKs, or use the [`cumulativetodelta` processor](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/processor/cumulativetodeltaprocessor) to avoid cumulative histograms to be dropped.
8490
* Exemplars are not supported.

0 commit comments

Comments
 (0)