Type to search.

Ingest metrics into a TSDS using the OTLP/HTTP endpoint

ECK

Elastic Cloud on Kubernetes extends Kubernetes orchestration capabilities to allow you to deploy and manage components of the Elastic Stack.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

ECE

Elastic Cloud Enterprise is a self-managed orchestration platform for deploying and managing the Elastic Stack at scale.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Self-managed 9.2+

Self-managed deployments are Elastic Stack deployments managed without the assistance of an orchestrator.

Availability

  • Generally available since 9.2

    This functionality is generally available and ready for production usage.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Elasticsearch accepts OpenTelemetry Protocol (OTLP) metrics on /_otlp/v1/metrics, one of the Elasticsearch OTLP/HTTP endpoint paths. The endpoint is a native ingest API, like the bulk API. To decide whether to use the OTLP endpoint for OpenTelemetry metrics, refer to When to use the Elasticsearch OTLP endpoint. In most setups, applications send metrics to the Elastic Cloud Managed OTLP Endpoint or to an Elastic Agent in Gateway mode rather than to this endpoint.

Elasticsearch stores metrics that arrive on /_otlp/v1/metrics as follows:

  • Elasticsearch writes records to time series data streams (TSDS). Built-in index templates create the data streams on first write, and routing follows the <type>-<dataset>.otel-<namespace> pattern.
  • The endpoint derives dimensions and metric mappings from OTLP metadata, so you don't need to set them up manually. Metric points are deduplicated based on their dimensions and timestamp.
  • Elasticsearch stores histogram metrics using the exponential_histogram or histogram field type, depending on your version and the histogram handling setting.
  • The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats. Availability Generally available since 9.5 This functionality is generally available and ready for production usage. Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes. The endpoint preserves the temporality of each metric in a temporality dimension, so ES|QL time series queries and downsampling interpret counters and histograms correctly.
  • The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats. Availability Planned We plan to add this functionality in a future Elastic Stack update. Subject to changes. Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes. Exemplars attached to metric data points are stored in matching exemplars-* time series data streams that share the dimensions of the metrics data stream. Exemplar ingestion is enabled by default and can be turned off.

For request details, authentication, and limitations, refer to the Elasticsearch OTLP/HTTP endpoint reference.

For an overview of all metrics ingest paths, including how this endpoint fits alongside the Managed OTLP Endpoint and Elastic Agent integrations, refer to Ingest metrics.