Skip to main content
Esta opção foi projetada para quem já tem uma instância do ClickHouse em execução, populada com dados de observabilidade ou eventos. O HyperDX pode ser usado de forma independente do restante da stack e é compatível com qualquer schema de dados — não apenas com OpenTelemetry (OTel). Isso o torna adequado para pipelines de observabilidade personalizadas já construídas sobre o ClickHouse. Para habilitar todas as funcionalidades, você deve fornecer uma instância do MongoDB para armazenar o estado da aplicação, incluindo dashboards, pesquisas salvas, configurações do usuário e alertas. Nesse modo, a ingestão de dados fica inteiramente a cargo do usuário. Você pode fazer a ingestão de dados no ClickHouse usando seu próprio OpenTelemetry Collector hospedado, ingestão direta por bibliotecas cliente, motores de tabela nativos do ClickHouse (como Kafka ou S3), pipelines de ETL ou serviços gerenciados de ingestão, como ClickPipes. Essa abordagem oferece máxima flexibilidade e é adequada para equipes que já operam o ClickHouse e querem adicionar o HyperDX como camada de visualização, pesquisa e alertas.

​
Indicado para

  • Usuários atuais do ClickHouse
  • Pipelines de eventos personalizados

​
Etapas de implantação


1

Implantar com Docker

Execute o comando a seguir, ajustando YOUR_MONGODB_URI conforme necessário.
3

Preencha os detalhes da conexão

Conecte-se ao seu próprio cluster externo do ClickHouse, por exemplo, o ClickHouse Cloud.Se for solicitado que você crie uma source, mantenha todos os valores padrão e preencha o campo Table com o valor otel_logs. Todas as outras configurações devem ser detectadas automaticamente, permitindo que você clique em Save New Source.
Criando uma sourceCriar uma source exige que existam tabelas no ClickHouse. Se você ainda não tiver dados, recomendamos implantar o ClickStack OpenTelemetry collector para criar as tabelas.

​
Usando Docker Compose

Você pode modificar a configuração do Docker Compose para obter o mesmo resultado deste guia, removendo o OTel collector e a instância do ClickHouse do manifesto.

​
ClickStack OpenTelemetry collector

Mesmo que você gerencie seu próprio OpenTelemetry Collector, de forma independente dos outros componentes da stack, ainda recomendamos usar a distribuição do collector do ClickStack. Isso garante o uso do schema padrão e a aplicação das melhores práticas de ingestão. Para mais detalhes sobre como implantar e configurar um collector standalone, consulte “Fazendo ingestão com OpenTelemetry”.

​
Escolha de esquema: Map vs JSON

O ClickStack armazena atributos como colunas Map(LowCardinality(String), String) por padrão. Esse é o esquema recomendado para cargas de trabalho de observabilidade. Em combinação com a serialização de map em buckets e índices de texto nas chaves e nos valores do map, ele permite lookups seletivos sem a sobrecarga de ingestão por chave das subcolunas JSON dinâmicas. Um esquema do tipo JSON está disponível em beta para avaliação em cargas de trabalho com um conjunto pequeno e estável de chaves de atributo. Ele não é recomendado como padrão. Consulte Map vs tipo JSON para ver a comparação completa e as variáveis de ambiente necessárias para habilitar o suporte a JSON.
Última modificação em 23 de julho de 2026