Skip to main content

Integração com o Datadog

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 da API do Datadog com o ClickHouse Cloud

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.

Integração do Prometheus com o ClickHouse Cloud

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 para consultar periodicamente a ClickHouse Cloud API e coletar métricas. Consulte a página de integração do Prometheus 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

Integração do Datadog Agent com o ClickHouse

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

ClickHouse Datadog DBM

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

Soluções de monitoramento da comunidade

A comunidade do ClickHouse desenvolveu soluções abrangentes de monitoramento que se integram a stacks populares de observabilidade. O 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.
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.

API de faturamento e uso

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.
Última modificação em 24 de julho de 2026