Skip to content
Merged
Show file tree
Hide file tree
Changes from 11 commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 16 additions & 4 deletions solutions/_snippets/edot-reference-arch.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,35 @@
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)
:::

::::

::::{tab-item} ECH
::::{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: ga 9.1
```

:::{image} /solutions/images/observability-apm-otel-distro-ech.png
:alt: APM data ingest path (ECH)
:::

::::

::::{tab-item} Self-managed
::::{applies-item} self:

:::{image} /solutions/images/observability-apm-otel-distro-self-managed.png
:alt: APM data ingest path (Self-managed)
Expand Down
Binary file added solutions/images/ech-preview-motlp.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 2 additions & 0 deletions solutions/observability/apm/get-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,8 @@ Follow these steps to send APM data to Elastic.
:::{include} /solutions/_snippets/obs-serverless-project.md
:::

:::::

:::::{step} Add data using EDOT or APM Agents

To send APM data to Elastic, you must install an Elastic Distribution of OpenTelemetry or an APM agent and configure it to send data to your project:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,9 @@ mapped_pages:
- https://www.elastic.co/guide/en/serverless/current/collect-data-with-native-otlp.html
applies_to:
serverless:
deployment:
ess:
stack: preview 9.2
---

# Quickstart: Send data to the {{motlp}}
Expand All @@ -15,14 +18,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).

## Get started
Keep reading to learn how to use the {{motlp}} to send logs, metrics, and traces to Elastic.

## Send data to Elastic

Expand All @@ -34,31 +30,34 @@ 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.

:::::

:::::{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:

::::{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.
:::

% ## 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.
% :::
:::{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.
:::

::::

:::::

Expand Down Expand Up @@ -175,13 +174,15 @@ 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/opentelemetry/index.md), which primarily focuses on traces and the APM use case.

## Troubleshoot
## 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.

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 few steps:

* [Kubernetes Quickstart](/solutions/observability/get-started/opentelemetry/quickstart/serverless/k8s.md)
* [Hosts & VMs Quickstart](/solutions/observability/get-started/opentelemetry/quickstart/serverless/hosts_vms.md)
Expand All @@ -201,7 +202,7 @@ You must format your API key as `"Authorization": "ApiKey <api-key-value-here>"`

### 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

Expand Down
Loading