Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
17 changes: 6 additions & 11 deletions hugo/config/_default/menus/main.en.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -752,16 +752,11 @@ menu:
identifier: otel-setup-ddot-migrate
parent: otel-setup-ddot
weight: 4013
- name: Other Setup Options
url: /opentelemetry/setup/
identifier: otel-setup-other
parent: otel_collect
weight: 402
- name: OpenTelemetry Collector
url: /opentelemetry/setup/collector_exporter/
identifier: otel-setup-collector-exporter
parent: otel-setup-other
weight: 4021
parent: otel_collect
weight: 402
- name: Deploy
url: /opentelemetry/setup/collector_exporter/deploy
identifier: otel-setup-collector-exporter-deploy
Expand Down Expand Up @@ -790,13 +785,13 @@ menu:
- name: OTLP Ingest in the Agent
url: /opentelemetry/setup/otlp_ingest_in_the_agent
identifier: otel-setup-otlp-ingest
parent: otel-setup-other
weight: 4022
parent: otel_collect
weight: 403
- name: Direct OTLP Ingest
url: /opentelemetry/setup/otlp_ingest
identifier: otel-setup-intake-endpoint
parent: otel-setup-other
weight: 4023
parent: otel_collect
weight: 404
- name: Logs Endpoint
url: /opentelemetry/setup/otlp_ingest/logs
parent: otel-setup-intake-endpoint
Expand Down
4 changes: 2 additions & 2 deletions hugo/content/en/opentelemetry/compatibility.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,14 +19,14 @@ Datadog supports several configurations for using OpenTelemetry. The primary dif
|------------------------------------------------------|-------------------------|-------------|-----------------------------------------------|
| [**Datadog SDK + DDOT (Recommended)**][29] | Datadog API or OTel API | Datadog SDK | Datadog Distribution of OTel Collector (DDOT) |
| [**OTel SDK + DDOT**][29] | OTel API | OTel SDK | Datadog Distribution of OTel Collector (DDOT) |
| [**OTel SDK + Community OTel Collector**][7] | OTel API | OTel SDK | Community OTel Collector |
| [**OTel SDK + Pure OTel Collector**][7] | OTel API | OTel SDK | Pure OTel Collector |
| [**Direct OTLP Ingest**][28] | OTel API | OTel SDK | N/A (Direct to Datadog endpoint) |

## Feature compatibility

The following table shows feature compatibility across different setups:

| Feature | Datadog SDK + DDOT (Recommended) | OTel SDK + DDOT | OTel SDK + Community OTel Collector | Direct OTLP Ingest |
| Feature | Datadog SDK + DDOT (Recommended) | OTel SDK + DDOT | OTel SDK + Pure OTel Collector | Direct OTLP Ingest |
|---|---|---|---|---|
| [Cloud SIEM][18] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} |
| [Correlated Traces, Metrics, Logs][19] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ This guide falls under the <strong>Custom Components</strong> <a href="/opentele

## Prerequisites

- An OpenTelemetry-compatible backend configured to send data to Datadog. See [Send OpenTelemetry Data to Datadog][4] for setup options including the DDOT Collector, Community OTel Collector with Datadog Exporter, or direct OTLP ingest.
- An OpenTelemetry-compatible backend configured to send data to Datadog. See [Send OpenTelemetry Data to Datadog][4] for setup options including the DDOT Collector, OTel Collector with Datadog Exporter, or direct OTLP ingest.
- [Bun][2] installed (v1.0 or later).
- A Bun application you want to instrument.

Expand Down Expand Up @@ -115,7 +115,7 @@ export OTEL_SERVICE_NAME="<YOUR_SERVICE_NAME>"
```

The `OTEL_EXPORTER_OTLP_ENDPOINT` value depends on your setup:
- **Local collector** (DDOT or Community OTel Collector): `http://localhost:4318` (default HTTP) or `http://localhost:4317` (gRPC)
- **Local collector** (DDOT or OTel Collector): `http://localhost:4318` (default HTTP) or `http://localhost:4317` (gRPC)
- **Remote collector**: Use the collector's address and port

For additional configuration options, see the [OpenTelemetry environment variable specification][5].
Expand Down
Original file line number Diff line number Diff line change
@@ -1,9 +1,10 @@
---
title: Set Up the Community OpenTelemetry Collector
title: Set Up the Pure OpenTelemetry Collector

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Issue: The title (and description at L7) now use "Pure OpenTelemetry Collector", but the body still says "Community" in several places that were left unchanged:

  • L22 (Overview intro): "...using the Community OpenTelemetry Collector, which is based on..."
  • L36 (Prerequisites): "...see the [feature compatibility table][7] under OTel SDK + Community OTel Collector."
  • L934 (info alert under dd-otel-metric-config): "The recommended Community OTel Collector configuration uses..."

If the rename is intentional, please update these occurrences (and coordinate the corresponding heading rename in hugo/content/en/opentelemetry/compatibility.md, which still uses "OTel SDK + Community OTel Collector" — otherwise the L36 link anchor breaks) so the naming is consistent.

aliases:
- /opentelemetry/setup/collector_exporter/oss_setup/
- /opentelemetry/setup/collector_exporter/community_collector/
private: true
description: 'Send OpenTelemetry data to Datadog using the Community OpenTelemetry Collector'
description: 'Send OpenTelemetry data to Datadog using the Pure OpenTelemetry Collector'
further_reading:
- link: "https://opentelemetry.io/docs/collector/"
tag: "External Site"
Expand All @@ -18,11 +19,11 @@ further_reading:

## Overview

Send traces, metrics, and logs to Datadog using the Community OpenTelemetry Collector, which is based on the [OpenTelemetry Collector Contrib][1] distribution and standard OpenTelemetry components. This setup uses the following key components:
Send traces, metrics, and logs to Datadog using the Pure OpenTelemetry Collector, which is based on the [OpenTelemetry Collector Contrib][1] distribution and standard OpenTelemetry components. This setup uses the following key components:

- **OTLP HTTP exporter**: Sends telemetry to Datadog's OTLP intake endpoints.
- **Span metrics connector**: Generates RED (Rate, Error, Duration) metrics from trace data to power APM features such as the Service Catalog and Service Page.
- **Resource detection processor**: Extracts host and cloud metadata for hostname resolution and tagging in Datadog.
- **Resource detection processor**: Detects host and cloud resource attributes, which Datadog uses for hostname resolution and tagging.

{{< img src="/opentelemetry/setup/oss-collector.png" alt="Diagram: OpenTelemetry SDK in code sends data through OTLP to host running any OpenTelemetry Collector with OTLP HTTP exporter, which forwards to Datadog's Observability Platform." style="width:100%;" >}}

Expand All @@ -32,7 +33,7 @@ Send traces, metrics, and logs to Datadog using the Community OpenTelemetry Coll

This setup supports bare metal, VMs, Docker, and Kubernetes. Supported managed Kubernetes distributions include Amazon EKS (including Auto Mode), Google GKE (Standard and Autopilot), and Azure AKS (including Automatic).

This setup does not support serverless or task-based container runtimes such as ECS Fargate or AWS Lambda. For supported Datadog features, see the [feature compatibility table][7] under **OTel SDK + Community OTel Collector**.
This setup does not support serverless or task-based container runtimes such as ECS Fargate or AWS Lambda. For supported Datadog features, see the [feature compatibility table][7] under **OTel SDK + Pure OTel Collector**.

- [OpenTelemetry Collector Contrib][1] v0.154.0 or later
- A [Datadog API key][2]
Expand Down Expand Up @@ -64,7 +65,7 @@ receivers:
endpoint: 0.0.0.0:4317
http:
endpoint: 0.0.0.0:4318
# Collect host-level metrics for the Infrastructure List
# Collect host system metrics (CPU, memory, disk, network); populates the Infrastructure List
host_metrics:
collection_interval: 10s
scrapers:
Expand Down Expand Up @@ -98,7 +99,7 @@ receivers:
processes: {}

processors:
# Detect host and cloud metadata for hostname resolution and tagging
# Detect host and cloud resource attributes for hostname resolution and tagging
resource_detection:
detectors: [env, system]
timeout: 2s
Expand Down Expand Up @@ -167,7 +168,7 @@ exporters:
endpoint: https://otlp.${env:DD_SITE}
headers:
dd-api-key: ${env:DD_API_KEY}
# Send resource attributes and scope metadata as metric tags
# Map resource attributes and instrumentation scope metadata to Datadog metric tags
dd-otel-metric-config: >-
{
"resource_attributes_as_tags": true,
Expand Down Expand Up @@ -253,7 +254,7 @@ receivers:
endpoint: 0.0.0.0:4317
http:
endpoint: 0.0.0.0:4318
# Collect host-level metrics for the Infrastructure List
# Collect host system metrics (CPU, memory, disk, network); populates the Infrastructure List
# root_path maps to the host filesystem mounted at /hostfs
host_metrics:
root_path: /hostfs
Expand Down Expand Up @@ -289,7 +290,7 @@ receivers:
processes: {}

processors:
# Detect host and cloud metadata for hostname resolution and tagging
# Detect host and cloud resource attributes for hostname resolution and tagging
resource_detection:
detectors: [env]
timeout: 2s
Expand Down Expand Up @@ -358,7 +359,7 @@ exporters:
endpoint: https://otlp.${env:DD_SITE}
headers:
dd-api-key: ${env:DD_API_KEY}
# Send resource attributes and scope metadata as metric tags
# Map resource attributes and instrumentation scope metadata to Datadog metric tags
dd-otel-metric-config: >-
{
"resource_attributes_as_tags": true,
Expand Down Expand Up @@ -454,7 +455,7 @@ receivers:
endpoint: 0.0.0.0:4317
http:
endpoint: 0.0.0.0:4318
# Collect host-level metrics for the Infrastructure List
# Collect host system metrics (CPU, memory, disk, network); populates the Infrastructure List
# root_path maps to the host filesystem mounted at /hostfs
host_metrics:
root_path: /hostfs
Expand Down Expand Up @@ -502,7 +503,7 @@ receivers:
- volume

processors:
# Detect host and cloud metadata for hostname resolution and tagging
# Detect host and cloud resource attributes for hostname resolution and tagging
resource_detection:
detectors: [env, system]
timeout: 2s
Expand Down Expand Up @@ -617,7 +618,7 @@ exporters:
endpoint: https://otlp.${env:DD_SITE}
headers:
dd-api-key: ${env:DD_API_KEY}
# Send resource attributes and scope metadata as metric tags
# Map resource attributes and instrumentation scope metadata to Datadog metric tags
dd-otel-metric-config: >-
{
"resource_attributes_as_tags": true,
Expand Down Expand Up @@ -877,7 +878,7 @@ env:
{{% /tab %}}
{{< /tabs >}}

Apply [Unified Service Tagging][4] by setting the `service.name`, `deployment.environment.name`, and `service.version` resource attributes in your application's OpenTelemetry configuration.
Set the `service.name`, `deployment.environment.name`, and `service.version` resource attributes in your application's OpenTelemetry configuration. Datadog maps these to [Unified Service Tagging][4], which correlates your traces, metrics, and logs.

## Verify the setup

Expand Down Expand Up @@ -930,7 +931,7 @@ Example with instrumentation metrics enabled:
}
```

<div class="alert alert-info">The recommended Community OTel Collector configuration uses the <code>span_metrics</code> connector to generate the RED metrics that power APM views. The <code>trace_metrics.instrumentation_metrics_calc</code> and <code>raw_instrumentation_metrics_drop</code> fields support an alternative configuration for setups that derive APM trace metrics from HTTP instrumentation metrics instead. Do not enable <code>instrumentation_metrics_calc</code> alongside the <code>span_metrics</code> connector, as this computes trace metrics from both sources.</div>
<div class="alert alert-info">The recommended Pure OTel Collector configuration uses the <code>span_metrics</code> connector to generate the RED metrics that power APM views. The <code>trace_metrics.instrumentation_metrics_calc</code> and <code>raw_instrumentation_metrics_drop</code> fields support an alternative configuration for setups that derive APM trace metrics from HTTP instrumentation metrics instead. Do not enable <code>instrumentation_metrics_calc</code> alongside the <code>span_metrics</code> connector, as this computes trace metrics from both sources.</div>

### Datadog extension

Expand Down
Loading