Skip to content

[DBM Doc] Document single_endpoint_mode for ClickHouse Cloud per-node metrics#38214

Draft
pierreln-dd wants to merge 1 commit into
masterfrom
pierreln-dd/dbm-doc-clickhouse-24509
Draft

[DBM Doc] Document single_endpoint_mode for ClickHouse Cloud per-node metrics#38214
pierreln-dd wants to merge 1 commit into
masterfrom
pierreln-dd/dbm-doc-clickhouse-24509

Conversation

@pierreln-dd

Copy link
Copy Markdown
Contributor

Confidence: AUTO

Source PR: DataDog/integrations-core#24509

What changed:
The ClickHouse integration README now documents a new configuration option single_endpoint_mode for ClickHouse Cloud deployments that sit behind a single load-balanced endpoint. When enabled (requires Agent 7.83.0+), this tells the Agent to query system-table metrics across all nodes using clusterAllReplicas() and tag each series with clickhouse_node, ensuring accurate per-node cumulative counter metrics.

Why:
Without this setting, the Agent may hit different nodes on each collection cycle, producing inaccurate values for cumulative per-node counters like clickhouse.query.failed.count since the counter isn't read from the same source consistently.

Edits:

  • Add documentation of the single_endpoint_mode configuration option and its purpose to the ClickHouse setup page

@pierreln-dd pierreln-dd self-assigned this Jul 16, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

Modified Files

@datadog-official

Copy link
Copy Markdown
Contributor

Pipelines

Fix all issues with BitsAI

⚠️ Warnings

🚦 1 Pipeline job failed

DataDog/documentation | build_preview   View in Datadog   GitLab

Useful? React with 👍 / 👎

This comment will be updated automatically if new data arrives.
🔗 Commit SHA: 3308ef8 | Docs | Datadog PR Page | Give us feedback!

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.

1 participant