Restructure OpenTelemetry Documentation (#21749)

* Roughly map out new structure.

* Move content into appropriate folders to fix nav.

* Apply v2 of TOC.

* Split deployment, config, and management content.

* Fix broken links.

* Fix integration link.

* Fix host metadata link.

* Move delta temporality to guides.

* Add OTLP and exporter to config section.

* Fix delta temporality broken link.

* Add draft troubleshooting content.

* Link fix.

* Add OpenTelemetry tags to further reading.

* Move Resources page. Update troubleshooting page.

* Remove Receiver from ootb exporter config.

* Add missing content to TOC.

* Add guides to nav.

* Fix link.

* Code review from Juliano.

* Remove duplicate integration content from config.

* Apply suggestions from code review

Co-authored-by: Bryce Eadie <[email protected]>

* Final tweak to name.

* Remove link to outdated page.

* Fix link.

---------

Co-authored-by: Bryce Eadie <[email protected]>

Author: brett0000FF

config/_default/menus/menus.en.yaml

@@ -540,81 +540,160 @@ main:
     identifier: getting_started_otel_dd
     parent: opentelemetry_top_level
     weight: 1
-  - name: Set Up the Collector
-    url: opentelemetry/collector_exporter/
-    identifier: otel_gs_collector
+  - name: Terms and Concepts
+    url: opentelemetry/otel_terms/
+    identifier: otel_terms
     parent: opentelemetry_top_level
     weight: 2
-  - name: Hostnames and Tagging
-    url: opentelemetry/collector_exporter/hostname_tagging/
-    identifier: otel_gs_tagging
-    parent: otel_gs_collector
+  - name: OTLP Metrics Types
+    url: /metrics/open_telemetry/otlp_metric_types/
+    parent: otel_terms
     weight: 201
+  - name: Collector and Exporter
+    url: opentelemetry/collector_exporter/
+    identifier: otel_collector
+    parent: opentelemetry_top_level
+    weight: 3
+  - name: Deployment
+    url: opentelemetry/collector_exporter/deployment/
+    identifier: otel_collector_deployment
+    parent: otel_collector
+    weight: 301
+  - name: Configuration
+    url: opentelemetry/collector_exporter/configuration/
+    identifier: otel_collector_configuration
+    parent: otel_collector
+    weight: 302
   - name: OTLP Receiver
     url: opentelemetry/collector_exporter/otlp_receiver/
-    identifier: otel_gs_otlp_receiver
-    parent: otel_gs_collector
-    weight: 202
-  - name: Host Metrics
-    url: opentelemetry/collector_exporter/host_metrics/
-    identifier: otel_gs_host_metrics
-    parent: otel_gs_collector
-    weight: 203
+    identifier: otel_receiver
+    parent: otel_collector_configuration
+    weight: 3021
+  - name: Integrations
+    url: opentelemetry/integrations/
+    identifier: otel_integrations
+    parent: otel_collector
+    weight: 303
   - name: Docker Metrics
-    url: opentelemetry/collector_exporter/docker_metrics/
-    identifier: otel_gs_docker_metrics
-    parent: otel_gs_collector
-    weight: 204
-  - name: Log Collection
-    url: opentelemetry/collector_exporter/log_collection/
-    identifier: otel_gs_log_collection
-    parent: otel_gs_collector
-    weight: 205
+    url: opentelemetry/integrations/docker_metrics/
+    identifier: otel_docker_metrics
+    parent: otel_integrations
+    weight: 3031
+  - name: Host Metrics
+    url: opentelemetry/integrations/host_metrics/
+    identifier: otel_host_metrics
+    parent: otel_integrations
+    weight: 3032
+  - name: Trace Metrics
+    url: opentelemetry/integrations/trace_metrics/
+    identifier: otel_trace_metrics
+    parent: otel_integrations
+    weight: 3033
+  - name: Runtime Metrics
+    url: opentelemetry/integrations/runtime_metrics/
+    identifier: otel_runtime_metrics
+    parent: otel_integrations
+    weight: 3034
   - name: Collector Health Metrics
     url: opentelemetry/collector_exporter/collector_health_metrics/
-    identifier: otel_gs_coll_health
-    parent: otel_gs_collector
-    weight: 206
-  - name: Trace Metrics
-    url: opentelemetry/collector_exporter/trace_metrics/
-    identifier: otel_gs_trace_metrics
-    parent: otel_gs_collector
-    weight: 207
+    identifier: otel_heatlh_metrics
+    parent: otel_integrations
+    weight: 3035
+  - name: Log Collection
+    url: opentelemetry/integrations/log_collection/
+    identifier: otel_log_collection
+    parent: otel_integrations
+    weight: 3036
+  - name: Hostnames and Tagging
+    url: opentelemetry/collector_exporter/hostname_tagging/
+    identifier: otel_hostnames_tagging
+    parent: otel_collector_configuration
+    weight: 3037
   - name: Batch and Memory Settings
     url: opentelemetry/collector_exporter/collector_batch_memory/
-    identifier: otel_gs_batch_memory
-    parent: otel_gs_collector
-    weight: 208
-  - name: OTLP Ingestion by the Datadog Agent
-    url: opentelemetry/otlp_ingest_in_the_agent/
-    identifier: otel_ingest_agent
-    parent: opentelemetry_top_level
-    weight: 3
-  - name: Runtime Metrics
-    url: opentelemetry/runtime_metrics
-    identifier: otel_runtime_metrics
+    identifier: otel_batch_memory
+    parent: otel_collector_configuration
+    weight: 3038
+  - name: Schema and Semantics
+    url: opentelemetry/schema_semantics/
+    identifier: otel_schema
     parent: opentelemetry_top_level
     weight: 4
-  - name: Java
-    url: opentelemetry/runtime_metrics/java
-    identifier: otel_runtime_metrics_java
-    parent: otel_runtime_metrics
+  - name: Resource Attribute Mapping
+    url: opentelemetry/schema_semantics/semantic_mapping/
+    identifier: otel_semantic_mapping
+    parent: otel_schema
     weight: 401
-  - name: .NET
-    url: opentelemetry/runtime_metrics/dotnet
-    identifier: otel_runtime_metrics_dotnet
-    parent: otel_runtime_metrics
+  - name: Metrics Mapping
+    url: opentelemetry/schema_semantics/metrics_mapping/
+    identifier: otel_metrics_mapping
+    parent: otel_schema
     weight: 402
-  - name: Go
-    url: opentelemetry/runtime_metrics/go
-    identifier: otel_runtime_metrics_go
-    parent: otel_runtime_metrics
+  - name: Infrastructure Host Mapping
+    url: opentelemetry/schema_semantics/host_metadata/
+    identifier: otel_host_metadata
+    parent: otel_schema
     weight: 403
-  - name: Guides
+  - name: Ingestion Sampling
+    url: opentelemetry/ingestion_sampling_with_opentelemetry
+    identifier: otel_sampling
+    parent: opentelemetry_top_level
+    weight: 5
+  - name: Interoperability with Datadog
+    url: opentelemetry/interoperability/
+    identifier: otel_interoperability
+    parent: opentelemetry_top_level
+    weight: 6
+  - name: OTLP Ingestion by the Agent
+    url: opentelemetry/interoperability/otlp_ingest_in_the_agent/
+    identifier: otel_ingest
+    parent: otel_interoperability
+    weight: 601
+  - name: W3C Trace Context Propagation
+    url: /tracing/trace_collection/trace_context_propagation/
+    identifier: otel_propagation
+    parent: otel_interoperability
+    weight: 602
+  - name: Custom Instrumentation
+    url: /tracing/trace_collection/custom_instrumentation/otel_instrumentation/
+    identifier: otel_instrumentation
+    parent: otel_interoperability
+    weight: 603
+  - name: Correlate RUM and Traces 
+    url: /real_user_monitoring/connect_rum_and_traces/#opentelemetry-support
+    identifier: otel_rum
+    parent: otel_interoperability
+    weight: 604
+  - name: Correlate Logs and Traces 
+    url: /tracing/other_telemetry/connect_logs_and_traces/opentelemetry/
+    identifier: otel_logs
+    parent: otel_interoperability
+    weight: 605
+  - name: Troubleshooting
+    url: opentelemetry/troubleshooting/
+    identifier: otel_troubleshooting
+    parent: opentelemetry_top_level
+    weight: 7
+  - name: Guides and Resources
     url: opentelemetry/guide/
     identifier: otel_guides
     parent: opentelemetry_top_level
-    weight: 5
+    weight: 8
+  - name: Visualizing OTLP Histograms as Heatmaps
+    url: opentelemetry/guide/otlp_histogram_heatmaps/
+    identifier: otel_guides_heatmaps
+    parent: otel_guides
+    weight: 801
+  - name: Switching to Datadog Connector
+    url: opentelemetry/guide/switch_from_processor_to_connector/
+    identifier: otel_guides_connector
+    parent: otel_guides
+    weight: 802
+  - name: Producing Delta Temporality Metrics
+    url: opentelemetry/guide/otlp_delta_temporality/
+    identifier: otel_guides_delta_temporality
+    parent: otel_guides
+    weight: 803
   - name: Developers
     url: developers/
     pre: dev-code

content/en/opentelemetry/_index.md

@@ -49,13 +49,13 @@ If your applications and services are instrumented with OpenTelemetry libraries,
 
 Datadog supports the [W3C Trace Context standard][6], ensuring complete traces are captured even when a request travels between services that have been instrumented with different tools. Services need only be instrumented with any system, such as an OpenTelemetry library or Datadog tracing library, that follows the W3C Trace Context standard. Read [Propagating Trace Context][5] for more information.
 
-## Further Reading
+## Further reading
 
 {{< partial name="whats-next/whats-next.html" >}}
 
 [1]: https://opentelemetry.io/
 [2]: https://www.cncf.io/
-[3]: /opentelemetry/otel_collector_datadog_exporter/
+[3]: /opentelemetry/collector_exporter/
 [4]: /opentelemetry/otlp_ingest_in_the_agent/
 [5]: /tracing/trace_collection/trace_context_propagation/
 [6]: https://www.w3.org/TR/trace-context/