> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 社区与合作伙伴集成

> ClickHouse Cloud 的第三方监控集成以及 Billing & Usage API

export const PrivatePreviewBadge = () => {
  return <div className="privatePreviewBadge">
            <div className="privatePreviewIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path d="M5.33301 6.66667V4.66667V4.66667C5.33301 3.194 6.52701 2 7.99967 2V2C9.47234 2 10.6663 3.194 10.6663 4.66667V4.66667V6.66667" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path d="M8.00033 9.33337V11.3334" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path fillRule="evenodd" clipRule="evenodd" d="M11.333 14H4.66634C3.92967 14 3.33301 13.4033 3.33301 12.6666V7.99996C3.33301 7.26329 3.92967 6.66663 4.66634 6.66663H11.333C12.0697 6.66663 12.6663 7.26329 12.6663 7.99996V12.6666C12.6663 13.4033 12.0697 14 11.333 14Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            {'ClickHouse Cloud 私有预览'}
        </div>;
};

<div id="direct-datadog">
  ## Datadog 集成
</div>

要在 Datadog 中监控您的 ClickHouse 部署，ClickHouse 提供了多种适用于不同部署模式的集成方案。每种方案各有权衡，其中一些由 ClickHouse 维护，另一些由 Datadog 维护。以下按推荐顺序列出这些集成。

| 集成                                                                                  | 文档                                                                                             | 部署          | 信号                   |
| ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ----------- | -------------------- |
| [ClickHouse Cloud Datadog API 集成](#clickhouse-cloud-datadog-api-integration) *(推荐)* | [docs.datadoghq.com](https://docs.datadoghq.com/integrations/clickhouse-cloud/)                | Cloud       | 指标                   |
| [ClickHouse Cloud Prometheus 集成](#clickhouse-cloud-prometheus-integration)          | [clickhouse.com/docs](/docs/zh/integrations/prometheus)                                             | Cloud       | 指标                   |
| [ClickHouse Datadog Agent 集成](#clickhouse-datadog-agent-integration)                | [docs.datadoghq.com](https://docs.datadoghq.com/integrations/clickhouse/?tab=host)             | OSS / Cloud | 日志、指标                |
| [ClickHouse Datadog DBM](#clickhouse-datadog-dbm)                                   | [datadoghq.com](https://www.datadoghq.com/product-preview/database-monitoring-for-clickhouse/) | OSS / Cloud | 日志、指标、Query Insights |

<div id="clickhouse-cloud-datadog-api-integration">
  ### ClickHouse Cloud Datadog API 集成
</div>

<PrivatePreviewBadge />

这是在 Datadog 中提供 ClickHouse Cloud 服务级指标的推荐方式。

你可以通过 OAuth 握手将 Datadog 账户连接到 ClickHouse Cloud (在 Datadog 集成卡片中点击 **Connect Accounts**) 。随后，ClickHouse Cloud 会将服务级指标推送到 Datadog，而不是由 Datadog 直接轮询该服务。

* **仅限 Cloud** — 不适用于 OSS ClickHouse
* Datadog **不会** 将这些指标视为自定义指标
* **不会** 阻止该服务进入空闲状态
* 附带一组预先配置的仪表盘和监视器

有关引导设置步骤，请参阅 [Datadog 的 ClickHouse Cloud 集成指南](https://docs.datadoghq.com/integrations/clickhouse-cloud/)。

<div id="clickhouse-cloud-prometheus-integration">
  ### ClickHouse Cloud Prometheus 集成
</div>

这是从 ClickHouse Cloud 收集服务级和组织级遥测数据最常见、最通用的方式。

你可以通过 [OpenMetrics 集成](https://docs.datadoghq.com/integrations/openmetrics/) 配置 Datadog Agent，使其定期轮询 ClickHouse Cloud API 并收集指标。有关配置详情，请参见 [Prometheus 集成页面](/docs/zh/integrations/prometheus#integrating-with-datadog)。

* **仅限 Cloud** — 不适用于 OSS ClickHouse
* Datadog 会将这些指标视为 **自定义指标**
* **不会** 阻止服务进入空闲状态

<div id="clickhouse-datadog-agent-integration">
  ### ClickHouse Datadog Agent 集成
</div>

这是将数据从 OSS ClickHouse 服务接入 Datadog 的最常见方式。它也适用于 ClickHouse Cloud，但有一些注意事项。

Datadog Agent 会定期轮询 ClickHouse 实例，并收集指标和日志。此集成附带一组预配置的仪表盘。

\*\*OSS ClickHouse：\*\*日志和指标均完全支持。

**ClickHouse Cloud (部分支持) ：**

* 仅支持指标——不支持日志
* 需要使用 `datadog-cluster-agent`，而不是 `datadog-agent`
* **会导致服务无法进入空闲状态**

<div id="clickhouse-datadog-dbm">
  ### ClickHouse Datadog DBM
</div>

ClickHouse 的数据库监控 (DBM) 由 Datadog 开发和维护。其工作原理是配置 Datadog Agent，从 ClickHouse 实例收集系统表数据，从而提供类似 ClickHouse Cloud 控制台原生提供的查询级性能洞察。ClickHouse 不参与此集成——如有任何问题，请联系 Datadog，而不是 ClickHouse。

* 指标免费；日志和系统表数据摄取需额外付费
* **OSS ClickHouse：** 完全支持
* **ClickHouse Cloud (部分支持) ：** 需要使用 `datadog-cluster-agent` 而不是 `datadog-agent`；**会导致服务无法进入空闲状态**

<div id="community-monitoring">
  ## 社区监控解决方案
</div>

ClickHouse 社区开发了可与主流可观测性技术栈集成的完整监控解决方案。[ClickHouse Monitoring](https://github.com/duyet/clickhouse-monitoring) 提供了一套包含预置仪表盘的完整监控方案。这个开源项目为希望采用成熟最佳实践和经过验证的仪表盘配置来实现 ClickHouse 监控的团队提供了快速上手的方式。

<Note>
  与其他直接监控数据库的方法一样，该方案会直接查询 ClickHouse 系统表，这会使实例无法进入空闲状态，从而影响成本优化。
</Note>

<div id="billing-usage-api">
  ## 计费与使用情况 API
</div>

Billing & Usage API 可用于以编程方式访问您的 Cloud 组织的计费和使用记录。这对于构建自定义成本监控仪表盘，或将计费数据集成到现有财务报告工作流中非常有用。

如需完整的 API 参考文档，请参阅[计费 API 文档](/docs/zh/products/cloud/api-reference/billing/get-organization-usage-costs)。