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
+10-4Lines changed: 10 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,11 +13,16 @@ In addition to the ingestion of metrics data through the bulk API,
13
13
14
14
The endpoint is available under `/_otlp/v1/metrics`.
15
15
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
+
16
21
Ingesting metrics data using the OTLP endpoint has the following advantages:
17
22
18
23
* Improved ingestion performance, especially if the data contains many resource attributes.
19
24
* 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.
21
26
Metrics are dynamically mapped using the metadata included in the OTLP requests.
22
27
23
28
:::{important}
@@ -62,12 +67,10 @@ The supported options for `compression` are `gzip` (default value of the `OTLP/H
62
67
To track metrics in your custom application,
63
68
use the [OpenTelemetry language SDK](https://opentelemetry.io/docs/getting-started/dev/) of your choice.
64
69
65
-
## When not to use the {{es}} OTLP endpoint
70
+
## Best practices
66
71
67
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).
68
73
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
-
71
74
## Send data to different data streams
72
75
73
76
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
80
83
81
84
## Limitations
82
85
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).
83
89
* 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