Skip to content

docs(enterprise): add OTEL telemetry export page#695

Merged
nikhil-factory merged 4 commits intomainfrom
docs/otel-telemetry-export
Mar 3, 2026
Merged

docs(enterprise): add OTEL telemetry export page#695
nikhil-factory merged 4 commits intomainfrom
docs/otel-telemetry-export

Conversation

@nikhil-factory
Copy link
Contributor

Adds a new enterprise doc page for configuring OpenTelemetry metric export to customer-owned OTLP collectors.

Changes

  • New page: docs/enterprise/telemetry-export.mdx — covers configuration (env vars), how dual-export works, exported metrics table, common attributes, example configs (Datadog, New Relic, Honeycomb, etc.), and troubleshooting.
  • Nav: Added to Enterprise > Analytics & Operations in docs.json.
  • Cross-links: Added references from usage-cost-and-analytics.mdx and compliance-audit-and-monitoring.mdx.

Companion to https://github.com/Factory-AI/factory-mono/pull/10570

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
@factory-droid
Copy link
Contributor

factory-droid bot commented Mar 3, 2026

Droid finished @nikhil-factory's task —— View job


Droid review complete.

  • Found 1 P1 doc accuracy issue (Datadog “direct API” OTLP endpoint host). See inline comment on docs/enterprise/telemetry-export.mdx.
  • Submitted a comment-only PR review with details.


<Accordion title="Datadog (direct API)">
```bash
export OTEL_TELEMETRY_ENDPOINT="https://api.datadoghq.com"
Copy link
Contributor

Choose a reason for hiding this comment

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

[P1] Fix Datadog direct endpoint to an OTLP intake host

https://api.datadoghq.com is Datadog’s general API host and won’t accept OTLP HTTP writes to /v1/metrics; this will make the “direct API” example fail for users configuring export.

Copy link
Contributor

@factory-droid factory-droid bot left a comment

Choose a reason for hiding this comment

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

Docs look solid overall, but the Datadog “direct API” example uses a host that won’t accept OTLP HTTP /v1/metrics requests, so users following it will fail to export. See inline note for the specific line to correct.

nikhil-factory and others added 2 commits March 3, 2026 07:16
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
api.datadoghq.com does not accept OTLP HTTP on /v1/metrics.
The correct intake host per Datadog docs is otlp.datadoghq.com.
Also fixes header casing to dd-api-key per Datadog conventions.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
@nikhil-factory nikhil-factory merged commit 7e6a2c2 into main Mar 3, 2026
2 checks passed
@nikhil-factory nikhil-factory deleted the docs/otel-telemetry-export branch March 3, 2026 05:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants