You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: manage-data/data-store/data-streams/tsds-ingest-otlp.md
+9-21Lines changed: 9 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,6 @@
2
2
navigation_title: "Ingest OTLP metrics"
3
3
applies_to:
4
4
stack: preview 9.2
5
-
serverless: preview
6
5
products:
7
6
- id: elasticsearch
8
7
---
@@ -15,11 +14,16 @@ In addition to the ingestion of metrics data through the bulk API,
15
14
The endpoint is available under `/_otlp/v1/metrics`.
16
15
17
16
Ingesting metrics data using the OTLP endpoint has the following advantages:
17
+
18
18
* Improved ingestion performance, especially if the data contains many resource attributes.
19
19
* Simplified index mapping:
20
20
there's no need to manually create an index template, or define dimensions and metrics.
21
21
Using the OTLP endpoint, metrics are dynamically mapped using the metadata included in the OTLP requests.
22
22
23
+
:::{important}
24
+
On {{ecloud}} , use the [{{motlp}}](opentelemetry:/reference/motlp.md) instead of connecting directly to the {{es}} OTLP endpoint.
25
+
:::
26
+
23
27
## How to send data to the OTLP endpoint
24
28
25
29
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
60
64
61
65
## When not to use the {{es}} OTLP endpoint
62
66
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).
72
68
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).
79
70
80
71
## Send data to different data streams
81
72
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:
84
74
85
75
- `data_stream.dataset` or `data_stream.namespace` in attributes, with the following order of precedence: data point attribute -> scope attribute -> resource attribute
86
76
- 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
92
82
93
83
## Limitations
94
84
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.
0 commit comments