> ## 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.

# Integrações da comunidade e de parceiros

> Integrações de monitoramento de terceiros e a API de faturamento e uso do ClickHouse Cloud

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>
            {'Em prévia privada no ClickHouse Cloud'}
        </div>;
};

<div id="direct-datadog">
  ## Integração com o Datadog
</div>

Para monitorar sua implantação do ClickHouse no Datadog, o ClickHouse oferece várias integrações, adequadas a diferentes modos de implantação. Cada uma tem suas próprias vantagens e desvantagens, e algumas são mantidas pelo ClickHouse, enquanto outras são mantidas pelo Datadog. As integrações estão listadas na ordem recomendada.

| Integração                                                                                                      | Documentação                                                                                   | Implantação | Sinais                         |
| --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ----------- | ------------------------------ |
| [Integração da API do Datadog para ClickHouse Cloud](#clickhouse-cloud-datadog-api-integration) *(recomendada)* | [docs.datadoghq.com](https://docs.datadoghq.com/integrations/clickhouse-cloud/)                | Cloud       | Métricas                       |
| [Integração do Prometheus para ClickHouse Cloud](#clickhouse-cloud-prometheus-integration)                      | [clickhouse.com/docs](/docs/integrations/prometheus)                                                | Cloud       | Métricas                       |
| [Integração do Datadog Agent com o ClickHouse](#clickhouse-datadog-agent-integration)                           | [docs.datadoghq.com](https://docs.datadoghq.com/integrations/clickhouse/?tab=host)             | OSS / Cloud | Logs, Métricas                 |
| [ClickHouse Datadog DBM](#clickhouse-datadog-dbm)                                                               | [datadoghq.com](https://www.datadoghq.com/product-preview/database-monitoring-for-clickhouse/) | OSS / Cloud | Logs, Métricas, Query Insights |

<div id="clickhouse-cloud-datadog-api-integration">
  ### Integração da API do Datadog com o ClickHouse Cloud
</div>

<PrivatePreviewBadge />

A forma recomendada de disponibilizar métricas de nível de serviço do ClickHouse Cloud no Datadog.

Você conecta sua conta do Datadog ao ClickHouse Cloud por meio de um handshake OAuth (**Connect Accounts** no tile de integração do Datadog). O ClickHouse Cloud então envia métricas de nível de serviço ao Datadog, em vez de o Datadog consultar o serviço diretamente de forma periódica.

* **Somente Cloud** — não é adequado para ClickHouse OSS
* As métricas **não** são tratadas como métricas personalizadas pelo Datadog
* **Não** impede que o serviço fique ocioso
* Inclui um conjunto pré-configurado de dashboards e monitores

Para as etapas de configuração inicial, consulte o [guia de integração do ClickHouse Cloud da Datadog](https://docs.datadoghq.com/integrations/clickhouse-cloud/).

<div id="clickhouse-cloud-prometheus-integration">
  ### Integração do Prometheus com o ClickHouse Cloud
</div>

A forma mais comum e universal de coletar telemetria no nível do serviço e da org no ClickHouse Cloud.

Você configura o Datadog Agent com a [integração OpenMetrics](https://docs.datadoghq.com/integrations/openmetrics/) para consultar periodicamente a ClickHouse Cloud API e coletar métricas. Consulte a [página de integração do Prometheus](/docs/integrations/prometheus#integrating-with-datadog) para ver os detalhes de configuração.

* **Somente Cloud** — não é compatível com o ClickHouse OSS
* O Datadog trata as métricas como **métricas personalizadas**
* **Não** impede que o serviço fique ocioso

<div id="clickhouse-datadog-agent-integration">
  ### Integração do Datadog Agent com o ClickHouse
</div>

A forma mais comum de enviar dados de serviços OSS do ClickHouse para o Datadog. Também funciona com o ClickHouse Cloud, com algumas ressalvas.

O Datadog Agent consulta periodicamente a instância do ClickHouse e coleta métricas e logs. Essa integração inclui um conjunto de dashboards pré-configurados.

**ClickHouse OSS:** logs e métricas com suporte completo.

**ClickHouse Cloud (suporte parcial):**

* Somente métricas — logs não são compatíveis
* Requer `datadog-cluster-agent` em vez de `datadog-agent`
* **Impede que o serviço entre em estado ocioso**

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

O Database Monitoring (DBM) para ClickHouse é desenvolvido e mantido pela Datadog. Ele funciona configurando o Datadog Agent para coletar dados das tabelas de sistema da instância do ClickHouse, fornecendo insights de desempenho em nível de consulta semelhantes aos que o ClickHouse Cloud Console oferece nativamente. A ClickHouse não tem envolvimento com essa integração — encaminhe qualquer problema para a Datadog, não para a ClickHouse.

* As métricas são gratuitas; há cobrança adicional por logs e pela ingestão de dados das tabelas de sistema
* **OSS ClickHouse:** totalmente compatível
* **ClickHouse Cloud (suporte parcial):** requer `datadog-cluster-agent` em vez de `datadog-agent`; **impedirá que o serviço entre em estado ocioso**

<div id="community-monitoring">
  ## Soluções de monitoramento da comunidade
</div>

A comunidade do ClickHouse desenvolveu soluções abrangentes de monitoramento que se integram a stacks populares de observabilidade. O [ClickHouse Monitoring](https://github.com/duyet/clickhouse-monitoring) oferece uma configuração completa de monitoramento com dashboards pré-configurados. Este projeto open source oferece uma abordagem de início rápido para equipes que desejam implementar o monitoramento do ClickHouse com práticas recomendadas consolidadas e configurações de dashboard já validadas.

<Note>
  Assim como outras abordagens de monitoramento direto do banco de dados, esta solução consulta diretamente as tabelas de sistema do ClickHouse, o que impede que as instâncias fiquem ociosas e afeta a otimização de custos.
</Note>

<div id="billing-usage-api">
  ## API de faturamento e uso
</div>

A API de faturamento e uso pode ser usada para acessar programaticamente os registros de faturamento e uso da sua organização no Cloud. Isso é útil para criar dashboards personalizados de monitoramento de custos ou integrar dados de faturamento aos fluxos de trabalho de relatórios financeiros já existentes.

Para consultar a referência completa da API, veja a [documentação da API de faturamento](/docs/pt-BR/products/cloud/api-reference/billing/get-organization-usage-costs).