Enhance observability documentation by adding detailed information on OpenTelemetry destinations, including common OTLP endpoint formats for various providers. Update Grafana Cloud setup instructions for clarity and include a new section on known limitations regarding metrics export and OTLP support. Additionally, refine the spans and attributes section to indicate that names may change during the beta period, ensuring users are informed of potential updates.

Author: nevikashah

src/content/docs/workers/observability/exporting-opentelemetry-data/grafana-cloud.mdx

@@ -29,13 +29,15 @@ Before you begin, ensure you have:
 4. Select **Quickstart** then select **JavaScript**
 6. Click **Create a new token**
 7. Enter a name for your token (e.g., `cloudflare-workers-otel`) and click **create token**
+8. Click on **Close** without copying the token
+9. Copy and Save the value for `OTEL_EXPORTER_OTLP_ENDPOINT` and `OTEL_EXPORTER_OTLP_HEADERS` in the `Environment variables` code block as the OTel endpoint and as the Auth header value respectively
 
 
 ## Step 2: Set up destination 
 1. Navigate to your Cloudflare account's [Workers Observability](https://dash.cloudflare.com/?to=/:account/workers-and-pages/observability/pipelines) section
 2. Click **Add destination** and configure a destination name (e.g. `grafana-tracing`)
 3. From Grafana, copy your Otel endpoint, auth header, and auth value 
-  * Your OTEL endpoint will look like `https://otlp-gateway-prod-us-east-2.grafana.net/otlp` (append `/v1/traces for tracing and `/v1/logs` for logs) 
+  * Your OTEL endpoint will look like `https://otlp-gateway-prod-us-east-2.grafana.net/otlp` (append `/v1/traces` for traces and `/v1/logs` for logs) 
   * Your custom header should include: 
       * Your auth header name `Authorization`
       * Your auth header value `Basic MTMxxx...`

src/content/docs/workers/observability/exporting-opentelemetry-data/index.mdx

@@ -18,9 +18,27 @@ You can export the following types of telemetry data:
 
 **Note**: exporting Worker metrics and custom metrics is not yet supported. 
 
-### Supported OpenTelemtry destinations
-* [Honeycomb](/workers/observability/exporting-opentelemetry-data/honeycomb/)
-* [Grafana Cloud](/workers/observability/exporting-opentelemetry-data/grafana-cloud/)
+### Available OpenTelemetry destinations
+
+Below are common OTLP endpoint formats for popular observability providers. Refer to your provider's documentation for specific details and authentication requirements.
+
+| Provider | Traces Endpoint | Logs Endpoint |
+|----------|----------------|---------------|
+| [**Honeycomb**](/workers/observability/exporting-opentelemetry-data/honeycomb/) | `https://api.honeycomb.io/v1/traces` | `https://api.honeycomb.io/v1/logs` |
+| [**Grafana Cloud**](/workers/observability/exporting-opentelemetry-data/grafana-cloud/) | `https://otlp-gateway-{region}.grafana.net/otlp/v1/traces`[^1] | `https://otlp-gateway-{region}.grafana.net/otlp/v1/logs`[^1] |
+| **Axiom** | `https://api.axiom.co/v1/traces` | `https://api.axiom.co/v1/logs` |
+| **Datadog** | Not yet available. Pending release from Datadog[^2] | Not yet available. Pending release from Datadog[^2] |
+| **Sentry** | Not yet available. Pending release from Sentry[^3] | Not yet available. Pending release from Sentry[^3] |
+
+[^1]: Replace `{region}` with your Grafana Cloud stack region (e.g., `prod-us-east-0`)
+
+[^2]: Datadog's OTLP endpoints are currently being rolled out and may not be available for all accounts. Contact Datadog support to enable OTLP ingestion for your account.
+
+[^3]: Sentry's OTLP endpoints are currently being rolled out and may not be available for all accounts. Contact Sentry support to enable OTLP ingestion for your account.
+
+:::note[Authentication]
+Most providers require authentication headers. Refer to your provider's documentation for specific authentication requirements.
+:::
 
 ## Setting up OpenTelemetry-compatible destinations
 To start sending data to your destination, you'll need to create a destination in the Cloudflare dashboard.
@@ -91,3 +109,7 @@ This includes the following limits and pricing:
 | **Workers Free** | Not available | Not available | - |
 | **Workers Paid** | 10 million events per month included | 10 million events per month included | $0.05 per million additional events |
 
+## Known limitations
+OpenTelemetry data export is currently in beta. Please be aware of the following limitations:
+- **Metrics export not yet supported**: Exporting Worker infrastructure metrics and custom metrics via OpenTelemetry is not currently available. We are actively working to add metrics support in the future. 
+- **Limited OTLP support from some providers**: Some observability providers are still rolling out OTLP endpoint support. Check the [Available OpenTelemetry destinations](#available-opentelemetry-destinations) table above for current availability.

src/content/docs/workers/observability/traces/known-limitations.md

@@ -20,4 +20,7 @@ We are adding more automatic instrumentation for every part of the Workers platf
 ### Support for custom spans and attributes: 
 While automatic instrumentation covers the platform interactions, we know you need visibility into your own application logic too. We're working to support the [OpenTelemetry API](https://www.npmjs.com/package/@opentelemetry/api) to make it easier for you to instrument custom spans within your application. 
 
+### Span and attribute names subject to change
+As Workers tracing is currently in beta, span names and attribute names are not yet finalized. We may refine these names during the beta period to improve clarity and align with OpenTelemetry semantic conventions. We recommend reviewing the [spans and attributes documentation](/workers/observability/traces/spans-and-attributes) periodically for updates.
+
 ### 

src/content/docs/workers/observability/traces/spans-and-attributes.mdx

@@ -140,8 +140,6 @@ Cloudflare Workers provides automatic tracing instrumentation **out of the box**
 
 #### [`d1_exec`](/d1/worker-api/d1-database/#exec)
 
-- `N/A`
-
 #### [`d1_first`](/d1/worker-api/prepared-statements/#first)
 
 - `cloudflare.d1.query.bookmark`