Collect data with Elastic Cloud Native OpenTelemetry Endpoint

solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md

@@ -0,0 +1,161 @@
+---
+mapped_urls:
+  - https://www.elastic.co/guide/en/serverless/current/collect-data-with-native-otlp.html
+applies_to:
+  serverless:
+---
+
+# Quickstart: Send data to the Elastic Cloud Managed OTLP Endpoint
+
+In this quickstart guide, you'll learn how to use the Elastic Cloud Managed OTLP Endpoint to send logs, metrics, and traces to Elastic.
+
+## What is the Elastic Cloud Managed OTLP endpoint?
+
+The Managed OTLP Endpoint is a fully managed offering exclusively for Elastic Cloud users (initially available in Elastic Cloud Serverless only) 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.
+
+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.
+
+:::{dropdown} Differences from the existing 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/apps/use-opentelemetry-with-apm.md), which primarily focuses on traces and the APM use case.
+:::
+
+## Prerequisites
+
+* An {{obs-serverless}} project. To learn more, refer to [create an Observability project](/solutions/observability/get-started/create-an-observability-project.md).
+* A system forwarding logs, metrics, or traces in OTLP (any OTel Collector or SDK—EDOT or community).
+
+### Limitations
+
+* The OTLP endpoint only supports histograms with delta temporality. Cumulative histograms are dropped.
+* Latency distributions based on histogram values have limited precision due to the fixed boundaries of explicit bucket histograms.
+
+## Get started
+
+### Get your native OTLP endpoint credentials
+
+1. [create a new Observability project](/solutions/observability/get-started/create-an-observability-project.md), or open an existing one.
+
+1. In your {{obs-serverless}} project, go to **Add Data**.
+
+1. Under **What do you want to monitor?** select **Application**, and then under **Monitor your application using** select **OpenTelemetry**.
+
+    :::{note}
+    Follow this flow for all use cases, including logs and infrastructure monitoring.
+    :::
+
+1. Copy the `OTEL_EXPORTER_OTLP_ENDPOINT` URL. Replace `.apm` with `.ingest` and save this value for later.
+
+### Create an API key
+
+1. Click "Create an API Key" to generate a new API key. Copy this value for later.
+1. (Optional) Test your new API key. You can do this by sending an empty JSON object to the `/v1/traces` endpoint. For example:
+
+    ```bash
+    curl -X POST \
+      -H "Content-Type: application/json" \
+      -H "Authorization: ApiKey <api-key>" \
+      https://{YOUR_CLUSTER}.ingest.us-east-1.aws.elastic.cloud:443/v1/traces \
+      -d '{}'
+    ```
+
+    The response should be similar to:
+
+    ```txt
+    {"partialSuccess":{}}% 
+    ```
+
+### Send data to your Elastic Cloud Managed OTLP endpoint
+
+* [I have an OTel Collector/SDK running](#otel-sdk-running)
+* [I need an OTel Collector/SDK](#no-sdk-running)
+* [I just want to use the instrumentation](#instrumentation-please)
+
+#### I have an OTel Collector/SDK running [otel-sdk-running]
+
+If you have an OpenTelemetry Collector or SDK exporting telemetry data,
+configure it with the endpoint and API key generated in the previous steps.
+
+**OpenTelemetry Collector configuration**
+
+Configure your OTel Collector as follows:
+
+```yaml
+exporters:
+  otlp:
+    endpoint: "https://my_cluster.ingest.us-east-1.aws.elastic.cloud:443/v1/traces"
+    headers: "Authorization": "ApiKey <api-key-value-here>"
+```
+
+For more information, see [OTLP Collector configuration](https://opentelemetry.io/docs/collector/configuration/).
+
+**Elastic Distributions of OpenTelemetry (EDOT) Collector configuration**
+
+Configure an EDOT Collector using the same method described above in **OpenTelemetry Collector configuration**.
+See the [EDOT Language SDK documentation](https://elastic.github.io/opentelemetry/edot-collector/index.html) for more information.
+
+**OpenTelemetry SDK configuration**
+
+Configure your OTel SDK with the following environment variables:
+
+* Elastic Cloud Managed OTLP endpoint: `OTEL_EXPORTER_OTLP_ENDPOINT` 
+* Elastic API key: `OTEL_EXPORTER_OTLP_HEADERS`
+
+For example:
+
+```bash
+export OTEL_EXPORTER_OTLP_ENDPOINT="https://my-api-endpoint:443"
+export OTEL_EXPORTER_OTLP_HEADERS="Authorization=ApiKey <api-key>"
+```
+
+For more information, see [OTLP Exporter configuration](https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/).
+
+**Elastic Distributions of OpenTelemetry (EDOT) SDK configuration**
+
+Configure an EDOT SDK using the same method described above in **OpenTelemetry SDK configuration**.
+See the [EDOT Language SDK documentation](https://elastic.github.io/opentelemetry/edot-sdks/index.html) for more information.
+
+#### I need an OTel Collector/SDK [no-sdk-running]
+
+Don't have a collector or SDK running? No problem. Spin up an EDOT collector in just a few steps:
+
+* [Kubernetes Quickstart](https://elastic.github.io/opentelemetry/quickstart/serverless/k8s.html)
+* [Hosts & VMs Quickstart](https://elastic.github.io/opentelemetry/quickstart/serverless/hosts_vms.html)
+
+% Commenting out Docker until the docs are ready
+% * [Docker Quickstart](https://elastic.github.io/opentelemetry/quickstart/serverless/docker.html)
+
+#### I just want to use the instrumentation [instrumentation-please]
+
+See [application use-cases](https://elastic.github.io/opentelemetry/use-cases/application/) for more information.
+
+## Troubleshoot
+
+**Api Key prefix not found**
+
+The following error is due to an improperly formatted API key:
+
+```txt
+Exporting failed. Dropping data.
+{"kind": "exporter", "data_type": }
+"Unauthenticated desc = ApiKey prefix not found"
+```
+
+You must format your API key as `"Authorization": "ApiKey <api-key-value-here>"` or `"Authorization=ApiKey <api-key>"` depending on whether you're using a collector or SDK. See [I have an OTel Collector/SDK running](#otel-sdk-running) for more information.
+
+**Error: too many requests**
+
+The Managed endpoint has per-project rate limits in place. If you hit this limit, reach out to our [support team](https://support.elastic.co).
+
+## Provide feedback
+
+We love to hear from you!
+Help improve the Elastic Cloud Managed OTLP Endpoint by sending us feedback in our [discussion forum](https://discuss.elastic.co/c/apm) or [community Slack](https://elasticstack.slack.com/signup#/domain-signup).
+
+For EDOT collector feedback, please open an issue in the [elastic-agent repository](https://github.com/elastic/elastic-agent/issues).
+
+## What's next?
+
+Visualize your OpenTelemetry data. Learn more in [](/solutions/observability/otlp-visualize.md).

solutions/observability/otlp-visualize.md

@@ -0,0 +1,56 @@
+---
+mapped_urls:
+  - https://www.elastic.co/guide/en/serverless/current/otlp-visualize.html
+applies_to:
+  serverless:
+---
+
+# Visualize OTLP data
+
+:::{tip}
+Want to ingest OpenTelemetry data? See [](/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md).
+:::
+
+## Get creative with Discover
+
+Discover allows you to quickly search and filter your data, get information about the structure of the fields in your data, and display your findings in a visualization.
+Find **Discover** in your {{obs-serverless}} project's UI under **Analyze** --> **Discover**.
+
+Attributes and resource attributes are prefixed with `attributes.*` and `resource.attributes.*`.
+You can correlate all signals with a single `resource.attributes.*`.
+
+:::{image} ../images/resource-attrs.png
+:screenshot:
+:alt: resource attributes
+:::
+
+See [](/explore-analyze/discover.md) to learn more.
+
+## Monitor application performance
+
+The Applications UI allows you to monitor your software services and applications in real-time. You can visualize detailed performance information on your services, identify and analyze errors, and monitor host-level metrics.
+
+## Check the health of your infrastructure
+
+To access the **Hosts** page, in your {{obs-serverless}} project, go to
+**Infrastructure** → **Hosts**.
+
+On the Hosts page, you can view health and performance metrics to help you quickly:
+
+* Analyze and compare hosts without having to build new dashboards.
+* Identify which hosts trigger the most alerts.
+* Troubleshoot and resolve issues quickly.
+
+:::{image} ../images/hosts-ui-otlp.png
+:screenshot:
+:alt: resource attributes
+:::
+
+See [](/solutions/observability/infra-and-hosts/analyze-compare-hosts.md) to learn more.
+
+### (Optional) Install the OpenTelemetry Assets integration
+
+Install the OpenTelemetry Assets integrations to access the "[OTEL][Metrics Kubernetes] Cluster Overview" dashboard.
+
+In your {{obs-serverless}} project, go to **Integrations** and toggle **Display beta integrations**.
+Search for "OpenTelemetry" and select and install **Kubernetes OpenTelemetry Assets**.

solutions/toc.yml

@@ -93,6 +93,7 @@ toc:
           - file: observability/get-started/quickstart-monitor-hosts-with-opentelemetry.md
           - file: observability/get-started/quickstart-unified-kubernetes-observability-with-elastic-distributions-of-opentelemetry-edot.md
           - file: observability/get-started/quickstart-collect-data-with-aws-firehose.md
+          - file: observability/get-started/quickstart-elastic-cloud-otel-endpoint.md
           - file: observability/get-started/add-data-from-splunk.md
           - file: observability/get-started/get-started-with-dashboards.md
       - file: observability/apps.md
@@ -313,6 +314,7 @@ toc:
                   - file: observability/apps/analyze-monitors.md
                   - file: observability/apps/inspect-uptime-duration-anomalies.md
               - file: observability/apps/configure-settings.md
+          - file: observability/otlp-visualize.md
           - file: observability/apps/tutorial-monitor-java-application.md
       - file: observability/cicd.md
       - file: observability/cloud.md