Document Datadog integration options for ClickHouse

[mihir119CH]

Added details on various Datadog integrations with ClickHouse, including API, Prometheus, Agent, and DBM integrations. Each integration's deployment mode, signals, and specific considerations are outlined.

Summary

Checklist

• Delete items not relevant to your PR
• URL changes should add a redirect to the old URL via https://github.com/ClickHouse/clickhouse-docs/blob/main/vercel.json
• If adding a new integration page, also add an entry to the integrations list here: https://github.com/ClickHouse/clickhouse-docs/blob/main/docs/integrations/index.mdx

---

Note

Low Risk
Documentation-only changes with no runtime or security impact; the API integration onboarding link is still a stub (#).

Overview
Replaces the short “direct Datadog agent not recommended” section with a Datadog integration overview that compares four options in a comparison table (Cloud API, Cloud Prometheus/OpenMetrics, Datadog Agent, and Datadog DBM), ordered by recommendation.

Each option gets its own subsection with deployment fit (Cloud vs OSS), signals, billing/idling tradeoffs (custom metrics, idle prevention, datadog-cluster-agent), and links to Datadog or ClickHouse docs. The ClickHouse Cloud Datadog API path is marked recommended with a Private Preview badge; onboarding is pointed to a placeholder anchor for a future guide.

Supporting edits add Datadog Agent to heading style exceptions and DBM / datadoghq to the spell-check dictionary.

^{Reviewed by Cursor Bugbot for commit 8d04dec. Bugbot is set up for automated code reviews on this repo. Configure here.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
clickhouse-docs	Ready	Preview, Comment	Jul 7, 2026 4:21pm
clickhouse-docs-jp	Building	Preview, Comment	Jul 7, 2026 4:21pm

3 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
clickhouse-docs-ko	Ignored	Preview	Jul 7, 2026 4:21pm
clickhouse-docs-ru	Ignored	Preview	Jul 7, 2026 4:21pm
clickhouse-docs-zh	Ignored	Preview	Jul 7, 2026 4:21pm

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ dhtclk
❌ mihir119CH
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[mihir119CH]

@dhtclk Am I blocking anything from merging this PR?

[dhtclk]

@mihir119CH - when through and did a deeper review, just a few things before we can merge. Happy to help with any of this!

[mihir119CH]

@dhtclk TYSM! Went through and resolved

[dhtclk]

Hey Mihir! I pushed a few fixes. Please review and let me know before I merge.

Fact-check flag on line 33 (the API integration). The original described it as "provide a Datadog API key" + "Datadog periodically polls the ClickHouse Cloud API… using a push-based method." Two issues:

• Auth: Datadog's setup docs describe a Connect Accounts OAuth flow (no API key handed over).
• Direction: the value of this integration over the Agent/Prometheus options is that it doesn't poll the service — which is why it doesn't block idling. "Datadog periodically polls" also contradicts "push-based method" in the same sentence.

I rewrote it to: OAuth handshake (Connect Accounts) + ClickHouse Cloud pushes metrics to Datadog, rather than Datadog polling the service.

The OAuth-not-API-key part is solid — it's stated on Datadog's page. The push-vs-poll direction is my inference from the idling behavior + the OAuth write scope, so since this is private preview, can you confirm with the integration owner that metrics are pushed, not pulled?

Sources: https://docs.datadoghq.com/integrations/clickhouse-cloud/ , https://docs.datadoghq.com/developers/integrations/oauth_for_integrations/