From 7b1bf9301db93c4f4c45e32f86316b9dc2b17984 Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri Benedetti Date: Tue, 9 Sep 2025 10:29:28 +0200 Subject: [PATCH 01/16] First commit --- .../quickstart-elastic-cloud-otel-endpoint.md | 47 ++++++++++--------- 1 file changed, 24 insertions(+), 23 deletions(-) diff --git a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md index 43523c7c03..06e5f48f8b 100644 --- a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md +++ b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md @@ -4,6 +4,8 @@ mapped_pages: - https://www.elastic.co/guide/en/serverless/current/collect-data-with-native-otlp.html applies_to: serverless: + deployment: + ess: preview 9.2 --- # Quickstart: Send data to the {{motlp}} @@ -15,12 +17,7 @@ This endpoint is designed for the following use cases: * Logs & Infrastructure Monitoring: Logs forwarded in OTLP format and host and Kubernetes metrics in OTLP format. * APM: Application telemetry in OTLP format. -In this quickstart guide, you'll learn how to use the {{motlp}} to send logs, metrics, and traces to Elastic. - -## Prerequisites - -* An {{obs-serverless}} project. To learn more, refer to [create an Observability project](/solutions/observability/get-started.md). -* A system forwarding logs, metrics, or traces in OTLP (any EDOT Collector or SDK—EDOT or community). +Keep reading to learn how to use the {{motlp}} to send logs, metrics, and traces to Elastic. ## Get started @@ -34,7 +31,7 @@ Follow these steps to send data to Elastic using the {{motlp}}. To use the {{motlp}} you need the following: -* An Elastic Observability Serverless project. Security projects are not yet supported. +* An {{obs-serverless}} or an {{ech}} project. Security projects are not yet supported. * An OTLP-compliant shipper capable of forwarding logs, metrics, or traces in OTLP format. This can include the OpenTelemetry Collector (EDOT, Contrib, or other distributions), OpenTelemetry SDKs (EDOT, upstream, or other distributions), or any other forwarder that supports the OTLP protocol. ::::: @@ -43,22 +40,22 @@ To use the {{motlp}} you need the following: To retrieve your {{motlp}} endpoint address and an API key, follow these steps: +::::{tab-set} + +:::{tab-item} Elastic Cloud Serverless 1. In {{ecloud}}, create an Observability project or open an existing one. 2. Select your project's name and then select **Manage project**. 3. Locate the **Connection alias** and select **Edit**. 4. Copy the **Managed OTLP endpoint** URL. +::: -% ## commented out until mOTLP on ECH is available -% ### Elastic Cloud on Elasticsearch ({{ech}}) -% 1. Open your deployment in the Elastic Cloud console. -% 2. Navigate to **Integrations** and find **OpenTelemetry** or **Managed OTLP**. -% 3. Copy the endpoint URL shown. -% ## Self-Managed -% For self-managed environments, you can deploy and expose an OTLP-compatible endpoint using the EDOT Collector as a gateway. Refer to [EDOT deployment docs](https://www.elastic.co/docs/reference/opentelemetry/edot-collector/modes#edot-collector-as-gateway). -% -% :::{note} -% Please reach out to support, and then Engineering can look into increasing it based on the license tier or for experimentation purposes. -% ::: +:::{tab-item} Elastic Cloud Hosted +1. Open your deployment in the Elastic Cloud console. +2. Navigate to **Integrations** and find **OpenTelemetry** or **Managed OTLP**. +3. Copy the endpoint URL shown. +::: + +:::: ::::: @@ -181,13 +178,17 @@ When creating a Kubernetes secret, always encode the full string in Base64, incl The Elastic Cloud Managed OTLP Endpoint ensures that OpenTelemetry data is stored without any schema translation, preserving both OpenTelemetry semantic conventions and resource attributes. It supports ingesting OTLP logs, metrics, and traces in a unified manner, ensuring consistent treatment across all telemetry data. This marks a significant improvement over the [existing functionality](/solutions/observability/apm/use-opentelemetry-with-apm.md), which primarily focuses on traces and the APM use case. +## Self-managed environments + +To send data to the {{motlp}} from a self-managed environment, you can deploy and expose an OTLP-compatible endpoint using the EDOT Collector as a gateway. Refer to [EDOT deployment docs](https://www.elastic.co/docs/reference/opentelemetry/edot-collector/modes#edot-collector-as-gateway). + ## Troubleshoot The following sections provide troubleshooting information for the {{motlp}}. -### I don't have a Collector or SDK running +### You don't have a Collector or SDK running -Don't have a collector or SDK running? Spin up an EDOT collector in just a few steps: +Don't have a collector or SDK running? Spin up an EDOT collector in a few steps: * [Kubernetes Quickstart](opentelemetry://reference/quickstart/serverless/k8s.md) * [Hosts & VMs Quickstart](opentelemetry://reference/quickstart/serverless/hosts_vms.md) @@ -205,9 +206,9 @@ Exporting failed. Dropping data. You must format your API key as `"Authorization": "ApiKey "` or `"Authorization=ApiKey "` depending on whether you're using a collector or SDK. -### Error: too many requests +### Error: Too many requests -The Managed OTLP endpoint has per-project rate limits in place. If you hit this limit, reach out to our [support team](https://support.elastic.co). Refer to [Rate limiting](opentelemetry://reference/motlp.md#rate-limiting) for more information. +The Managed OTLP endpoint has per-project rate limits in place. If you reach this limit, reach out to our [support team](https://support.elastic.co). Refer to [Rate limiting](opentelemetry://reference/motlp.md#rate-limiting) for more information. ## Provide feedback @@ -215,6 +216,6 @@ Help improve the Elastic Cloud Managed OTLP Endpoint by sending us feedback in o For EDOT collector feedback, open an issue in the [elastic-agent repository](https://github.com/elastic/elastic-agent/issues). -## What's next? +## What's next Visualize your OpenTelemetry data. Learn more in [](/solutions/observability/otlp-visualize.md). From c110b2b6787d2d3fd262cb0198758f6bf343f299 Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri Benedetti Date: Tue, 9 Sep 2025 10:36:57 +0200 Subject: [PATCH 02/16] Phrase --- .../get-started/quickstart-elastic-cloud-otel-endpoint.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md index 06e5f48f8b..2dd7643086 100644 --- a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md +++ b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md @@ -38,7 +38,7 @@ To use the {{motlp}} you need the following: :::::{step} Locate your {{motlp}} -To retrieve your {{motlp}} endpoint address and an API key, follow these steps: +To retrieve your {{motlp}} endpoint address, follow these steps: ::::{tab-set} From 23cbf2ad8b0682cf18a6a2737d04a543ce2cbfb5 Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri-Benedetti Date: Wed, 10 Sep 2025 10:37:29 +0200 Subject: [PATCH 03/16] Update solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .../get-started/quickstart-elastic-cloud-otel-endpoint.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md index 2dd7643086..93d6fcd0da 100644 --- a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md +++ b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md @@ -188,7 +188,7 @@ The following sections provide troubleshooting information for the {{motlp}}. ### You don't have a Collector or SDK running -Don't have a collector or SDK running? Spin up an EDOT collector in a few steps: +Don't have a collector or SDK running? Spin up an EDOT collector in few steps: * [Kubernetes Quickstart](opentelemetry://reference/quickstart/serverless/k8s.md) * [Hosts & VMs Quickstart](opentelemetry://reference/quickstart/serverless/hosts_vms.md) From 29ba720145e1a8adae2e2cbcf833a18a3d45e6d7 Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri-Benedetti Date: Wed, 10 Sep 2025 10:37:36 +0200 Subject: [PATCH 04/16] Update solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .../get-started/quickstart-elastic-cloud-otel-endpoint.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md index 93d6fcd0da..c3b2aeff36 100644 --- a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md +++ b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md @@ -206,7 +206,7 @@ Exporting failed. Dropping data. You must format your API key as `"Authorization": "ApiKey "` or `"Authorization=ApiKey "` depending on whether you're using a collector or SDK. -### Error: Too many requests +### Error: too many requests The Managed OTLP endpoint has per-project rate limits in place. If you reach this limit, reach out to our [support team](https://support.elastic.co). Refer to [Rate limiting](opentelemetry://reference/motlp.md#rate-limiting) for more information. From a06a1f8510c17113d05593a4ab0269d993125609 Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri-Benedetti Date: Wed, 10 Sep 2025 10:37:53 +0200 Subject: [PATCH 05/16] Update solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .../get-started/quickstart-elastic-cloud-otel-endpoint.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md index c3b2aeff36..3f0a30a47d 100644 --- a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md +++ b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md @@ -216,6 +216,6 @@ Help improve the Elastic Cloud Managed OTLP Endpoint by sending us feedback in o For EDOT collector feedback, open an issue in the [elastic-agent repository](https://github.com/elastic/elastic-agent/issues). -## What's next +## What's next? Visualize your OpenTelemetry data. Learn more in [](/solutions/observability/otlp-visualize.md). From 7761ceaffd279fd4e2111645c6813052ebd6e07a Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri Benedetti Date: Wed, 1 Oct 2025 12:30:01 +0200 Subject: [PATCH 06/16] Add variant graphs and applicability tabs --- solutions/_snippets/edot-reference-arch.md | 17 +++++++++++++---- solutions/images/ech-preview-motlp.png | Bin 0 -> 129652 bytes solutions/observability/apm/get-started.md | 2 ++ .../quickstart-elastic-cloud-otel-endpoint.md | 6 +++--- 4 files changed, 18 insertions(+), 7 deletions(-) create mode 100644 solutions/images/ech-preview-motlp.png diff --git a/solutions/_snippets/edot-reference-arch.md b/solutions/_snippets/edot-reference-arch.md index 99963c5720..3b2ea16098 100644 --- a/solutions/_snippets/edot-reference-arch.md +++ b/solutions/_snippets/edot-reference-arch.md @@ -1,7 +1,8 @@ The following diagrams show the reference architecture for OpenTelemetry with Elastic, depending on your deployment model. -:::::{tab-set} -::::{tab-item} Serverless +:::::{applies-switch} + +::::{applies-item} serverless: :::{image} /solutions/images/observability-apm-otel-distro-serverless.png :alt: APM data ingest path (Serverless) @@ -9,7 +10,7 @@ The following diagrams show the reference architecture for OpenTelemetry with El :::: -::::{tab-item} ECH +::::{applies-item} ess: ga :::{image} /solutions/images/observability-apm-otel-distro-ech.png :alt: APM data ingest path (ECH) @@ -17,7 +18,15 @@ The following diagrams show the reference architecture for OpenTelemetry with El :::: -::::{tab-item} Self-managed +::::{applies-item} ess: preview 9.2 + +:::{image} /solutions/images/ech-preview-motlp.png +:alt: APM data ingest path (ECH) +::: + +:::: + +::::{applies-item} self: :::{image} /solutions/images/observability-apm-otel-distro-self-managed.png :alt: APM data ingest path (Self-managed) diff --git a/solutions/images/ech-preview-motlp.png b/solutions/images/ech-preview-motlp.png new file mode 100644 index 0000000000000000000000000000000000000000..b46ed9351edf8d2daacd9b84bf050c88f60b0283 GIT binary patch literal 129652 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 Date: Wed, 1 Oct 2025 15:10:18 +0200 Subject: [PATCH 07/16] Edit applies to --- solutions/_snippets/edot-reference-arch.md | 8 ++++---- .../quickstart-elastic-cloud-otel-endpoint.md | 12 +++++------- 2 files changed, 9 insertions(+), 11 deletions(-) diff --git a/solutions/_snippets/edot-reference-arch.md b/solutions/_snippets/edot-reference-arch.md index 3b2ea16098..ef1bc5f299 100644 --- a/solutions/_snippets/edot-reference-arch.md +++ b/solutions/_snippets/edot-reference-arch.md @@ -10,15 +10,15 @@ The following diagrams show the reference architecture for OpenTelemetry with El :::: -::::{applies-item} ess: ga +::::{applies-item} ess: + +Up to version 9.1: :::{image} /solutions/images/observability-apm-otel-distro-ech.png :alt: APM data ingest path (ECH) ::: -:::: - -::::{applies-item} ess: preview 9.2 +From version 9.2 {applies_to}`product: preview` onwards: :::{image} /solutions/images/ech-preview-motlp.png :alt: APM data ingest path (ECH) diff --git a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md index 0c1af13857..b320554ba6 100644 --- a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md +++ b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md @@ -5,7 +5,8 @@ mapped_pages: applies_to: serverless: deployment: - ess: preview 9.2 + ess: + stack: preview 9.2 --- # Quickstart: Send data to the {{motlp}} @@ -19,8 +20,6 @@ This endpoint is designed for the following use cases: Keep reading to learn how to use the {{motlp}} to send logs, metrics, and traces to Elastic. -## Get started - ## Send data to Elastic Follow these steps to send data to Elastic using the {{motlp}}. @@ -49,7 +48,8 @@ To retrieve your {{motlp}} endpoint address, follow these steps: 4. Copy the **Managed OTLP endpoint** URL. ::: -:::{applies-item} ess: preview 9.2 +:::{applies-item} ess: +{applies_to}`stack: preview 9.2` 1. Open your deployment in the Elastic Cloud console. 2. Navigate to **Integrations** and find **OpenTelemetry** or **Managed OTLP**. 3. Copy the endpoint URL shown. @@ -174,9 +174,7 @@ The Elastic Cloud Managed OTLP Endpoint ensures that OpenTelemetry data is store ## Self-managed environments -To send data to the {{motlp}} from a self-managed environment, you can deploy and expose an OTLP-compatible endpoint using the EDOT Collector as a gateway. Refer to [EDOT deployment docs](https://www.elastic.co/docs/reference/opentelemetry/edot-collector/modes#edot-collector-as-gateway). - -## Troubleshoot +To send data to the {{motlp}} from a self-managed environment, you can deploy and expose an OTLP-compatible endpoint using the EDOT Collector as a gateway. Refer to [EDOT deployment docs](https://www.elastic.co/docs/reference/opentelemetry/edot-collector/modes#edot-collector-as-gateway) for more information. The following sections provide troubleshooting information for the {{motlp}}. From 6986f67b488eae63d2001d67dbbe09ddf07b632b Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri Benedetti Date: Wed, 1 Oct 2025 15:14:15 +0200 Subject: [PATCH 08/16] Change applies to to block --- solutions/_snippets/edot-reference-arch.md | 8 ++++---- .../get-started/quickstart-elastic-cloud-otel-endpoint.md | 4 +++- 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/solutions/_snippets/edot-reference-arch.md b/solutions/_snippets/edot-reference-arch.md index ef1bc5f299..9d23fac326 100644 --- a/solutions/_snippets/edot-reference-arch.md +++ b/solutions/_snippets/edot-reference-arch.md @@ -12,15 +12,15 @@ The following diagrams show the reference architecture for OpenTelemetry with El ::::{applies-item} ess: -Up to version 9.1: +From version 9.2 {applies_to}`product: preview` onwards: -:::{image} /solutions/images/observability-apm-otel-distro-ech.png +:::{image} /solutions/images/ech-preview-motlp.png :alt: APM data ingest path (ECH) ::: -From version 9.2 {applies_to}`product: preview` onwards: +Up to version 9.1: -:::{image} /solutions/images/ech-preview-motlp.png +:::{image} /solutions/images/observability-apm-otel-distro-ech.png :alt: APM data ingest path (ECH) ::: diff --git a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md index b320554ba6..7b283a18e6 100644 --- a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md +++ b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md @@ -49,7 +49,9 @@ To retrieve your {{motlp}} endpoint address, follow these steps: ::: :::{applies-item} ess: -{applies_to}`stack: preview 9.2` +```{applies_to} +stack: preview 9.2 +``` 1. Open your deployment in the Elastic Cloud console. 2. Navigate to **Integrations** and find **OpenTelemetry** or **Managed OTLP**. 3. Copy the endpoint URL shown. From 757bb796e7e6b459ba0ee7e6193dd5c65e31b98e Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri Benedetti Date: Wed, 1 Oct 2025 15:22:07 +0200 Subject: [PATCH 09/16] Modify badges --- solutions/_snippets/edot-reference-arch.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/solutions/_snippets/edot-reference-arch.md b/solutions/_snippets/edot-reference-arch.md index 9d23fac326..29c969a53f 100644 --- a/solutions/_snippets/edot-reference-arch.md +++ b/solutions/_snippets/edot-reference-arch.md @@ -12,13 +12,16 @@ The following diagrams show the reference architecture for OpenTelemetry with El ::::{applies-item} ess: -From version 9.2 {applies_to}`product: preview` onwards: - +```{applies_to} +stack: preview 9.2 +``` :::{image} /solutions/images/ech-preview-motlp.png :alt: APM data ingest path (ECH) ::: -Up to version 9.1: +```{applies_to} +stack: ga 9.1 +``` :::{image} /solutions/images/observability-apm-otel-distro-ech.png :alt: APM data ingest path (ECH) From ff93231c4ce74cdc1df7370a3f20c3ca0b40bc48 Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri-Benedetti Date: Wed, 1 Oct 2025 17:26:27 +0200 Subject: [PATCH 10/16] Update solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md Co-authored-by: florent-leborgne --- .../get-started/quickstart-elastic-cloud-otel-endpoint.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md index 7b283a18e6..b320554ba6 100644 --- a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md +++ b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md @@ -49,9 +49,7 @@ To retrieve your {{motlp}} endpoint address, follow these steps: ::: :::{applies-item} ess: -```{applies_to} -stack: preview 9.2 -``` +{applies_to}`stack: preview 9.2` 1. Open your deployment in the Elastic Cloud console. 2. Navigate to **Integrations** and find **OpenTelemetry** or **Managed OTLP**. 3. Copy the endpoint URL shown. From d66444db5019a605b1e9e0758f4d43786ca244ed Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri-Benedetti Date: Wed, 1 Oct 2025 17:26:35 +0200 Subject: [PATCH 11/16] Update solutions/_snippets/edot-reference-arch.md Co-authored-by: florent-leborgne --- solutions/_snippets/edot-reference-arch.md | 21 +++++++++------------ 1 file changed, 9 insertions(+), 12 deletions(-) diff --git a/solutions/_snippets/edot-reference-arch.md b/solutions/_snippets/edot-reference-arch.md index 29c969a53f..9324f9ff5a 100644 --- a/solutions/_snippets/edot-reference-arch.md +++ b/solutions/_snippets/edot-reference-arch.md @@ -12,20 +12,17 @@ The following diagrams show the reference architecture for OpenTelemetry with El ::::{applies-item} ess: -```{applies_to} -stack: preview 9.2 -``` -:::{image} /solutions/images/ech-preview-motlp.png -:alt: APM data ingest path (ECH) -::: +- {applies_to}`stack: preview 9.2` -```{applies_to} -stack: ga 9.1 -``` + :::{image} /solutions/images/ech-preview-motlp.png + :alt: APM data ingest path (ECH) + ::: -:::{image} /solutions/images/observability-apm-otel-distro-ech.png -:alt: APM data ingest path (ECH) -::: +- {applies_to}`stack: ga 9.1` + + :::{image} /solutions/images/observability-apm-otel-distro-ech.png + :alt: APM data ingest path (ECH) + ::: :::: From 3691c5fef5a5f74d30eb24c4cf2c94cdcd2edd49 Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri-Benedetti Date: Mon, 6 Oct 2025 13:52:18 +0200 Subject: [PATCH 12/16] Edits following review --- .../quickstart-elastic-cloud-otel-endpoint.md | 67 ++++++------------- 1 file changed, 20 insertions(+), 47 deletions(-) diff --git a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md index b320554ba6..6724b92ecf 100644 --- a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md +++ b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md @@ -1,5 +1,5 @@ --- -description: Learn how to use the Elastic Cloud Managed OTLP Endpoint to send logs, metrics, and traces to Elastic Observability. +description: Learn how to use the Elastic Cloud Managed OTLP Endpoint to send logs, metrics, and traces to Elastic Serverless and Elastic Cloud Hosted. mapped_pages: - https://www.elastic.co/guide/en/serverless/current/collect-data-with-native-otlp.html applies_to: @@ -9,16 +9,21 @@ applies_to: stack: preview 9.2 --- -# Quickstart: Send data to the {{motlp}} +# Quickstart: Send OTLP data to Elastic Serverless and Elastic Cloud Hosted The {{motlp}} is a fully managed offering exclusively for Elastic Cloud users that simplifies OpenTelemetry data ingestion. It provides an endpoint for OpenTelemetry SDKs and Collectors to send telemetry data, with Elastic handling scaling, data processing, and storage. Refer to [{{motlp}}](opentelemetry://reference/motlp.md) for more information. -This endpoint is designed for the following use cases: +The {{moltp}} is designed for the following use cases: * Logs & Infrastructure Monitoring: Logs forwarded in OTLP format and host and Kubernetes metrics in OTLP format. * APM: Application telemetry in OTLP format. -Keep reading to learn how to use the {{motlp}} to send logs, metrics, and traces to Elastic. +Keep reading to learn how to use the {{motlp}} to send logs, metrics, and traces to your Serverless project or {{ech}} cluster. + +:::{note} +:applies_to: { ess:, stack: preview 9.2 } +The Managed OTLP endpoint might not be available in all {{ech}} regions during the Technical Preview. +::: ## Send data to Elastic @@ -26,65 +31,33 @@ Follow these steps to send data to Elastic using the {{motlp}}. ::::::{stepper} -:::::{step} Check the requirements - -To use the {{motlp}} you need the following: - -* An {{obs-serverless}} or an {{ech}} project. Security projects are not yet supported. -* An OTLP-compliant shipper capable of forwarding logs, metrics, or traces in OTLP format. This can include the OpenTelemetry Collector (EDOT, Contrib, or other distributions), OpenTelemetry SDKs (EDOT, upstream, or other distributions), or any other forwarder that supports the OTLP protocol. - -::::: +:::::{step} Retrieve your endpoint and API key -:::::{step} Locate your {{motlp}} - -To retrieve your {{motlp}} endpoint address, follow these steps: +To retrieve your {{motlp}} endpoint address and API key, follow these steps: ::::{applies-switch} :::{applies-item} serverless: 1. In {{ecloud}}, create an Observability project or open an existing one. -2. Select your project's name and then select **Manage project**. -3. Locate the **Connection alias** and select **Edit**. -4. Copy the **Managed OTLP endpoint** URL. +2. Go to **Add data**, select **Applications** and then select **OpenTelemetry**. +3. Copy the endpoint and authentication headers values. + +Alternatively, go to **Manage project**, locate the **Connection alias** and select **Edit** to see the **Managed OTLP endpoint** URL. ::: :::{applies-item} ess: {applies_to}`stack: preview 9.2` -1. Open your deployment in the Elastic Cloud console. -2. Navigate to **Integrations** and find **OpenTelemetry** or **Managed OTLP**. -3. Copy the endpoint URL shown. +1. In {{ecloud}}, create an {{ech}} deployment or open an existing one. +2. Go to **Add data**, select **Applications** and then select **OpenTelemetry**. +3. Copy the endpoint and authentication headers values. + +Alternatively, go to **Manage project**, locate the **Connection alias** and select **Edit** to see the **Managed OTLP endpoint** URL. ::: :::: ::::: -:::::{step} Create an API key - -Generate an API key with appropriate ingest privileges to authenticate OTLP traffic: - -1. In {{ecloud}}, go to **Manage project** → **API Keys**. -2. Select **Create API Key**. -3. Name the key. For example, `otlp-client`. -4. Edit the optional security settings. -5. Select **Create API Key**. -6. Copy the key to the clipboard. - -Add this key to your final API key string. For example: - -``` -Authorization: ApiKey -``` - -:::{important} -The API key copied from Kibana does not include the `ApiKey` scheme. Always prepend `ApiKey ` before using it in your configuration or encoding it for Kubernetes secrets. For example: - - - Correct: `Authorization: ApiKey abc123` - - Incorrect: `Authorization: abc123` -::: - -::::: - :::::{step} Send data to the {{motlp}} The final step is to use the {{motlp}} endpoint and your Elastic API key to send data to {{ecloud}}. From 5dd0f3541da6d50f595332fcfcd1fac94403a4ca Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri-Benedetti Date: Mon, 6 Oct 2025 13:58:51 +0200 Subject: [PATCH 13/16] Edits following review --- .../quickstart-elastic-cloud-otel-endpoint.md | 23 ++++++------------- 1 file changed, 7 insertions(+), 16 deletions(-) diff --git a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md index 6724b92ecf..708d42b38f 100644 --- a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md +++ b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md @@ -13,7 +13,7 @@ applies_to: The {{motlp}} is a fully managed offering exclusively for Elastic Cloud users that simplifies OpenTelemetry data ingestion. It provides an endpoint for OpenTelemetry SDKs and Collectors to send telemetry data, with Elastic handling scaling, data processing, and storage. Refer to [{{motlp}}](opentelemetry://reference/motlp.md) for more information. -The {{moltp}} is designed for the following use cases: +The {{motlp}} is designed for the following use cases: * Logs & Infrastructure Monitoring: Logs forwarded in OTLP format and host and Kubernetes metrics in OTLP format. * APM: Application telemetry in OTLP format. @@ -70,14 +70,11 @@ To send data to the {{motlp}} from the {{edot}} Collector or the contrib Collect ```yaml exporters: otlp: - endpoint: https:// <1> + endpoint: https:// headers: - Authorization: ApiKey <2> + Authorization: ApiKey ``` -1. The endpoint retrieved at [step 2](#locate-your-motlp) -2. The API key created at [step 3](#create-an-api-key) - Set the API key as an environment variable or directly in the configuration as shown in the example. ::: @@ -85,12 +82,9 @@ Set the API key as an environment variable or directly in the configuration as s To send data to the {{motlp}} from {{edot}} SDKs or contrib SDKs, set the following variables in your application's environment: ```bash -export OTEL_EXPORTER_OTLP_ENDPOINT="https://" <1> -export OTEL_EXPORTER_OTLP_HEADERS="Authorization=ApiKey " <2> +export OTEL_EXPORTER_OTLP_ENDPOINT="https://" +export OTEL_EXPORTER_OTLP_HEADERS="Authorization=ApiKey " ``` - -1. The endpoint retrieved at [step 2](#locate-your-motlp) -2. The API key created at [step 3](#create-an-api-key) ::: :::{tab-item} Kubernetes example @@ -111,14 +105,11 @@ Mount the secret as an environment variable or file, then reference it in your O ```yaml exporters: otlp: - endpoint: https:// <1> + endpoint: https:// headers: - Authorization: ${API_KEY} <2> + Authorization: ${API_KEY} ``` -1. The endpoint retrieved at [step 2](#locate-your-motlp) -2. The API key created at [step 3](#create-an-api-key) - And in your deployment spec: ```yaml From 923f003aab3deb10e811e7e048ecab9bbee796cf Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri Benedetti Date: Mon, 6 Oct 2025 14:15:39 +0200 Subject: [PATCH 14/16] Edits --- .../quickstart-elastic-cloud-otel-endpoint.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md index 708d42b38f..8d518ed760 100644 --- a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md +++ b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md @@ -36,13 +36,12 @@ Follow these steps to send data to Elastic using the {{motlp}}. To retrieve your {{motlp}} endpoint address and API key, follow these steps: ::::{applies-switch} - :::{applies-item} serverless: 1. In {{ecloud}}, create an Observability project or open an existing one. 2. Go to **Add data**, select **Applications** and then select **OpenTelemetry**. 3. Copy the endpoint and authentication headers values. -Alternatively, go to **Manage project**, locate the **Connection alias** and select **Edit** to see the **Managed OTLP endpoint** URL. +Alternatively, you can retrieve the endpoint from the **Manage project** page and create an API key manually from the **API keys** page. ::: :::{applies-item} ess: @@ -51,16 +50,15 @@ Alternatively, go to **Manage project**, locate the **Connection alias** and sel 2. Go to **Add data**, select **Applications** and then select **OpenTelemetry**. 3. Copy the endpoint and authentication headers values. -Alternatively, go to **Manage project**, locate the **Connection alias** and select **Edit** to see the **Managed OTLP endpoint** URL. +Alternatively, you can retrieve the endpoint from the **Manage project** page and create an API key manually from the **API keys** page. ::: - :::: ::::: -:::::{step} Send data to the {{motlp}} +:::::{step} Configure your OTLP shipper -The final step is to use the {{motlp}} endpoint and your Elastic API key to send data to {{ecloud}}. +The final step is to configure your Collector or SDK to use the {{motlp}} endpoint and your Elastic API key to send data to {{ecloud}}. ::::{tab-set} @@ -172,6 +170,6 @@ Help improve the Elastic Cloud Managed OTLP Endpoint by sending us feedback in o For EDOT collector feedback, open an issue in the [elastic-agent repository](https://github.com/elastic/elastic-agent/issues). -## What's next? +## What's next Visualize your OpenTelemetry data. Learn more in [](/solutions/observability/otlp-visualize.md). From c0460e2861a31f46c7f44171cb0dc8b6f18e03d6 Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri Benedetti Date: Mon, 6 Oct 2025 14:26:35 +0200 Subject: [PATCH 15/16] Rewrite intro --- .../get-started/quickstart-elastic-cloud-otel-endpoint.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md index 8d518ed760..d7bc1ea2aa 100644 --- a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md +++ b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md @@ -11,7 +11,9 @@ applies_to: # Quickstart: Send OTLP data to Elastic Serverless and Elastic Cloud Hosted -The {{motlp}} is a fully managed offering exclusively for Elastic Cloud users that simplifies OpenTelemetry data ingestion. It provides an endpoint for OpenTelemetry SDKs and Collectors to send telemetry data, with Elastic handling scaling, data processing, and storage. Refer to [{{motlp}}](opentelemetry://reference/motlp.md) for more information. +You can send OpenTelemetry data to Elastic Serverless and Elastic Cloud Hosted using the {{motlp}} endpoint. + +The {{motlp}} provides an endpoint for OpenTelemetry SDKs and Collectors to send telemetry data, with Elastic handling scaling, data processing, and storage. Refer to [{{motlp}}](opentelemetry://reference/motlp.md) for more information. The {{motlp}} is designed for the following use cases: From 73725f24b2a259522ff68372efc299aaab9de756 Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri Benedetti Date: Mon, 6 Oct 2025 16:11:27 +0200 Subject: [PATCH 16/16] Fix heading --- .../get-started/quickstart-elastic-cloud-otel-endpoint.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md index d7bc1ea2aa..2faa9ec8cf 100644 --- a/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md +++ b/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md @@ -9,7 +9,7 @@ applies_to: stack: preview 9.2 --- -# Quickstart: Send OTLP data to Elastic Serverless and Elastic Cloud Hosted +# Quickstart: Send OTLP data to Elastic Serverless or Elastic Cloud Hosted You can send OpenTelemetry data to Elastic Serverless and Elastic Cloud Hosted using the {{motlp}} endpoint. @@ -134,11 +134,9 @@ When creating a Kubernetes secret, always encode the full string in Base64, incl ## Differences from the Elastic APM Endpoint -The Elastic Cloud Managed OTLP Endpoint ensures that OpenTelemetry data is stored without any schema translation, preserving both OpenTelemetry semantic conventions and resource attributes. It supports ingesting OTLP logs, metrics, and traces in a unified manner, ensuring consistent treatment across all telemetry data. This marks a significant improvement over the [existing functionality](/solutions/observability/apm/opentelemetry/index.md), which primarily focuses on traces and the APM use case. +The Elastic Cloud Managed OTLP Endpoint ensures that OpenTelemetry data is stored without any schema translation, preserving both OpenTelemetry semantic conventions and resource attributes. It supports ingesting OTLP logs, metrics, and traces in a unified manner, ensuring consistent treatment across all telemetry data. -## Self-managed environments - -To send data to the {{motlp}} from a self-managed environment, you can deploy and expose an OTLP-compatible endpoint using the EDOT Collector as a gateway. Refer to [EDOT deployment docs](https://www.elastic.co/docs/reference/opentelemetry/edot-collector/modes#edot-collector-as-gateway) for more information. +## Troubleshooting The following sections provide troubleshooting information for the {{motlp}}.