Skip to content

Commit e86aefe

Browse files
authored
Update tsds-ingest-otlp.md
1 parent a570a5f commit e86aefe

File tree

1 file changed

+9
-21
lines changed

1 file changed

+9
-21
lines changed

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

Lines changed: 9 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,6 @@
22
navigation_title: "Ingest OTLP metrics"
33
applies_to:
44
stack: preview 9.2
5-
serverless: preview
65
products:
76
- id: elasticsearch
87
---
@@ -15,11 +14,16 @@ In addition to the ingestion of metrics data through the bulk API,
1514
The endpoint is available under `/_otlp/v1/metrics`.
1615

1716
Ingesting metrics data using the OTLP endpoint has the following advantages:
17+
1818
* Improved ingestion performance, especially if the data contains many resource attributes.
1919
* Simplified index mapping:
2020
there's no need to manually create an index template, or define dimensions and metrics.
2121
Using the OTLP endpoint, metrics are dynamically mapped using the metadata included in the OTLP requests.
2222

23+
:::{important}
24+
On {{ecloud}} , use the [{{motlp}}](opentelemetry:/reference/motlp.md) instead of connecting directly to the {{es}} OTLP endpoint.
25+
:::
26+
2327
## How to send data to the OTLP endpoint
2428

2529
To send data from an OpenTelemetry Collector to the {{es}} OTLP endpoint,
@@ -60,27 +64,13 @@ use the [OpenTelemetry language SDK](https://opentelemetry.io/docs/getting-start
6064

6165
## When not to use the {{es}} OTLP endpoint
6266

63-
On Elastic Cloud, use the [Elastic Cloud Managed OTLP Endpoint](opentelemetry:/reference/motlp.md) instead of connecting directly to the Elasticsearch OTLP endpoint.
64-
65-
It's not recommended to send metrics from applications directly to the Elasticsearch OTLP endpoint,
66-
especially if there are many individual applications that each periodically send a small amount of metrics.
67-
Instead, send data to an OpenTelemetry collector first.
68-
This helps with handling many connections,
69-
and with creating bigger batches to improve ingestion performance.
70-
For more details on the recommended way to set up OpenTelemetry-based data ingestion,
71-
have a look at the [EDOT reference architecture](opentelemetry:/reference/architecture/index.md).
67+
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).
7268

73-
At this point, {{es}} only supports the OTLP metrics endpoint (`/_otlp/v1/metrics`).
74-
Other signals, are not supported as a native {{es}} OTLP endpoint at the moment.
75-
To ingest other signals,
76-
such as logs, traces, and profiles,
77-
use a distribution of the OpenTelemetry collector that includes the [Elasticsearch exporter](opentelemetry:/reference/edot-collector/components/elasticsearchexporter.md),
78-
such as the [Elastic distribution of OpenTelemetry (EDOT) Collector](opentelemetry:/reference/edot-collector/index.md).
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).
7970

8071
## Send data to different data streams
8172

82-
By default, metrics are ingested into the `metrics-generic.otel-default` data stream.
83-
You can influence the target data stream by setting specific attributes on your data:
73+
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:
8474

8575
- `data_stream.dataset` or `data_stream.namespace` in attributes, with the following order of precedence: data point attribute -> scope attribute -> resource attribute
8676
- Otherwise, if the scope name contains `/receiver/<somereceiver>`, `data_stream.dataset` is set to the receiver name.
@@ -92,7 +82,5 @@ The target data stream name is constructed as `metrics-${data_stream.dataset}.ot
9282

9383
## Limitations
9484

95-
* Histograms are only supported in delta temporality.
96-
Set the temporality preference to delta in your SDKs,
97-
or use the [`cumulativetodelta` processor](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/processor/cumulativetodeltaprocessor) to avoid cumulative histograms to be dropped.
85+
* 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.
9886
* Exemplars are not supported.

0 commit comments

Comments
 (0)