Add Datadog integration documentation

\# Main Changes
* Sidebar Updates: Restructures and adds links to the new documentaion.
* New Documentation:
   * Connecting to Datadog: Explains various connection methods (e.g., OpenTelemetry Collector, Datadog Agent).
   * Dashboard Template: Provides instructions for using preconfigured Datadog dashboards.
   * Router Instrumentation: Details settings for enhancing APM views, including error tracking and resource naming.
   * OpenTelemetry Collector Configuration: Comprehensive guide on setting up the collector.
* Enhancements to Existing Documentation:
   * Added links to new documentation to drive home the organization.
   * Move some router instrumentation from the datadog-agent-traces page to the new router-instrumentation page.

\# Noteworthy
* I explicitly mentioned ddot and agentless as methods to connect to Datadog, despite the fact that our own documentation for these methods is not yet available. Agentless support is currently in the backlog, and ddot requires a combination of OTEL collector and agent configurations. In the interim, the combined documentation from Datadog and our own will be sufficient.

Co-authored-by: Isaac M. Good <[email protected]>

Author: robert113289

docs/source/_sidebar.yaml

@@ -125,10 +125,24 @@ items:
               children:
                 - label: "Datadog"
                   children:
-                    - label: "Metrics"
-                      href: "./observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog/datadog-agent/datadog-agent-metrics"
-                    - label: "Traces"
-                      href: "./observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog/datadog-agent/datadog-agent-traces"
+                    - label: "Overview"
+                      href: "./observability/router-telemetry-otel/apm-guides/datadog"
+                    - label: "Router Instrumentation"
+                      href: "./observability/router-telemetry-otel/apm-guides/datadog/router-instrumentation"
+                    - label: "Connecting to Datadog"
+                      children:
+                        - label: "Overview"
+                          href: "./observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog"
+                        - label: "OTel-Collector"
+                          href: "./observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog/otel-collector"
+                        - label: "Datadog Agent"
+                          children:
+                            - label: "Metrics"
+                              href: "./observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog/datadog-agent/datadog-agent-metrics"
+                            - label: "Traces"
+                              href: "./observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog/datadog-agent/datadog-agent-traces"
+                    - label: "Dashboard Template"
+                      href: "./observability/router-telemetry-otel/apm-guides/datadog/observing-and-monitoring/dashboard-template"
                 - label: "New Relic"
                   children:
                     - label: "Metrics"

docs/source/routing/observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog/datadog-agent/datadog-agent-metrics.mdx

@@ -8,9 +8,23 @@ redirectFrom:
   - /graphos/routing/observability/telemetry/metrics-exporters/datadog
 ---
 
+This guide walks through configuring the Apollo Router to send metrics to Datadog via the Datadog Agent.
 This metrics exporter is a configuration of the [OTLP exporter](/router/configuration/telemetry/exporters/metrics/otlp) to use with [Datadog](https://www.datadoghq.com/).
 
-For general tracing configuration, refer to [Router Metrics Configuration](/router/configuration/telemetry/exporters/metrics/overview).
+For general metrics configuration, refer to [Router Metrics Configuration](/router/configuration/telemetry/exporters/metrics/overview).
+For router instrumentation with Datadog-specific attributes, see the [Router Instrumentation guide](/graphos/routing/observability/router-telemetry-otel/apm-guides/datadog/router-instrumentation).
+
+## Connection methods
+
+Datadog supports multiple methods for ingesting OpenTelemetry data:
+
+- **[Datadog OpenTelemetry collector (DDOT)](https://docs.datadoghq.com/opentelemetry/setup/)** - Datadog's distribution of the OpenTelemetry Collector
+- **[OpenTelemetry collector](../otel-collector)** - Vendor-neutral telemetry pipeline with advanced processing ([guide available](../otel-collector))
+- **[Datadog agent](./datadog-agent-metrics)** - Direct connection with native Datadog features (this guide)
+- **[Agentless](https://docs.datadoghq.com/opentelemetry/setup/)** - Direct OTLP ingestion to Datadog
+
+For a comprehensive overview of all OpenTelemetry setup options with Datadog, see [Datadog's OpenTelemetry setup documentation](https://docs.datadoghq.com/opentelemetry/setup/).
+
 
 ## Configuration 
 

docs/source/routing/observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog/datadog-agent/datadog-agent-traces.mdx

@@ -11,55 +11,22 @@ redirectFrom:
 import BatchProcessorPreamble from '../../../../../../../../shared/batch-processor-preamble.mdx';
 import BatchProcessorRef from '../../../../../../../../shared/batch-processor-ref.mdx';
 
+This guide walks through configuring the Apollo Router to send traces to Datadog via the Datadog Agent.
 This tracing exporter is a configuration of the [OTLP exporter](/graphos/routing/observability/telemetry/trace-exporters/otlp) to use with [Datadog](https://www.datadoghq.com/).
 
 For general tracing configuration, refer to [Router Tracing Configuration](/router/configuration/telemetry/exporters/tracing/overview).
+For router instrumentation with Datadog-specific attributes, see the [Router Instrumentation guide](/graphos/routing/observability/router-telemetry-otel/apm-guides/datadog/router-instrumentation).
 
-## Attributes for Datadog APM UI
+## Connection methods
 
-The router should set attributes that Datadog uses to organize its APM view and other UI:
+Datadog supports multiple methods for ingesting OpenTelemetry data:
+- **[Datadog OpenTelemetry collector (DDOT)](https://docs.datadoghq.com/opentelemetry/setup/)** - Datadog's distribution of the OpenTelemetry Collector
+- **[OpenTelemetry collector](../otel-collector)** - Vendor-neutral telemetry pipeline with advanced processing ([guide available](../otel-collector))
+- **[Datadog agent](./datadog-agent-traces)** - Direct connection with native Datadog features (this guide)
+- **[Agentless](https://docs.datadoghq.com/opentelemetry/setup/)** - Direct OTLP ingestion to Datadog
 
-- `otel.name`: span name that's fixed for Datadog
-- `resource.name`: Datadog resource name that's displayed in traces
-- `operation.name`: Datadog operation name that populates a dropdown menu in the Datadog service page
+For a comprehensive overview of all OpenTelemetry setup options with Datadog, see [Datadog's OpenTelemetry setup documentation](https://docs.datadoghq.com/opentelemetry/setup/).
 
-You should add these attributes to your `router.yaml` configuration file. The example below sets these attributes for the `router`, `supergraph`, and `subgraph` stages of the router's request lifecycle:
-
-```yaml title="router.yaml"
-telemetry:
-  instrumentation:
-    spans:
-      mode: spec_compliant
-      router:
-        attributes:
-          otel.name: router
-          operation.name: "router"
-          resource.name:
-            request_method: true
-
-      supergraph:
-        attributes:
-          otel.name: supergraph
-          operation.name: "supergraph"
-          resource.name:
-            operation_name: string
-
-      subgraph:
-        attributes:
-          otel.name: subgraph
-          operation.name: "subgraph"
-          resource.name:
-            subgraph_operation_name: string
-```
-
-Consequently you can filter for these operations in Datadog APM:
-
-<img
-  className="screenshot"
-  alt="Datadog APM showing operations set with example attributes set in router.yaml"
-  src="../../../../../../../images/router/datadog-apm-ops-example.png"
-  width="600"
-/>
 
 ## OTLP configuration
 

docs/source/routing/observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog/index.mdx

@@ -0,0 +1,56 @@
+---
+title: Connecting to Datadog
+subtitle: Choose the right connection method for your infrastructure
+description: Overview of different methods to connect Apollo Router to Datadog for telemetry collection
+---
+
+Connect your Apollo Router to Datadog using the method that best fits your infrastructure and requirements.
+
+## Connection methods
+
+This guide provides detailed configuration for the OpenTelemetry Collector and Datadog Agent methods.
+
+Datadog supports multiple methods for ingesting OpenTelemetry data: the most relevant are covered in this guide for your convenience, but there are others available.
+
+- **[Datadog OpenTelemetry collector (DDOT)](https://docs.datadoghq.com/opentelemetry/setup/)** - Datadog's distribution of the OpenTelemetry Collector
+- **[OpenTelemetry collector](/graphos/routing/observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog/otel-collector)** - Vendor-neutral telemetry pipeline with advanced processing (guide available)
+- **[Datadog agent](/graphos/routing/observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog/datadog-agent/datadog-agent-traces)** - Direct connection with native Datadog features (guide available)
+- **[Agentless](https://docs.datadoghq.com/opentelemetry/setup/)** - Direct OTLP ingestion to Datadog
+
+For complete information on all connection methods including DDOT Collector and Agentless options, refer to [Datadog's OpenTelemetry setup documentation](https://docs.datadoghq.com/opentelemetry/setup/) and [compatibility guide](https://docs.datadoghq.com/opentelemetry/compatibility/).
+
+## Quick start
+
+For the fastest setup, choose one of the following methods based on your current Datadog setup:
+
+1. If you already have Datadog Agent running, use the [Datadog Agent](/graphos/routing/observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog/datadog-agent/datadog-agent-traces).
+2. If you are starting fresh, use the [Datadog OpenTelemetry Collector (DDOT)](https://docs.datadoghq.com/opentelemetry/setup/) or the [OpenTelemetry Collector](/graphos/routing/observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog/otel-collector).
+3. For containerized deployments, consider the [Apollo Runtime container](https://github.com/apollographql/apollo-runtime) which includes pre-configured examples for the OpenTelemetry Collector.
+4. For a direct connection with no agent deployment required, use the [Agentless](https://docs.datadoghq.com/opentelemetry/setup/) method.
+
+### Datadog OpenTelemetry collector (Recommended)
+
+**[Datadog OpenTelemetry Collector](https://docs.datadoghq.com/opentelemetry/setup/)** is a Datadog-specific distribution of the OpenTelemetry collector that combines the OpenTelemetry Collector and the Datadog Agent. It is currently Datadog's recommended way to send OpenTelemetry to Datadog.
+This solution is tightly coupled to Datadog and is the most straightforward solution if you are committed to using Datadog.
+
+### OpenTelemetry collector
+
+**[OpenTelemetry collector](/graphos/routing/observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog/otel-collector)** provides a vendor-neutral telemetry pipeline with advanced processing capabilities including sampling, filtering, and multi-backend support.
+
+### Datadog agent
+
+The Datadog agent offers direct OTLP ingestion, integrating with Datadog's existing agent infrastructure for logs, infrastructure monitoring, and other telemetry collection.
+
+- [Datadog agent traces configuration](/graphos/routing/observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog/datadog-agent/datadog-agent-traces)
+- [Datadog agent metrics configuration](/graphos/routing/observability/router-telemetry-otel/apm-guides/datadog/connecting-to-datadog/datadog-agent/datadog-agent-metrics)
+
+### Agentless
+
+**[Agentless](https://docs.datadoghq.com/opentelemetry/setup/)** provides direct OTLP ingestion to Datadog without requiring additional infrastructure components.
+
+## Next steps
+
+After setting up your connection method:
+
+1. [Configure router instrumentation](/graphos/routing/observability/router-telemetry-otel/apm-guides/datadog/router-instrumentation) for Datadog-optimized telemetry
+2. [Import dashboard templates](/graphos/routing/observability/router-telemetry-otel/apm-guides/datadog/observing-and-monitoring/dashboard-template) for router monitoring