Pular para o conteúdo principal
Para implantar o ClickStack Open Source, em que você mesmo executa e gerencia o ClickHouse e a UI do ClickStack, fornecemos imagens Docker prontas que reúnem a UI, um OTel collector e o ClickHouse em um único contêiner, facilitando o início do desenvolvimento local, dos testes e das implantações autogerenciadas.
Uma versão gerenciada do ClickStack também está disponível — consulte Managed ClickStack.
Essas imagens são baseadas no pacote Debian oficial do ClickHouse e estão disponíveis em várias distribuições para atender a diferentes casos de uso. A opção mais simples é uma distribuição de imagem única que inclui todos os componentes principais da stack em um só pacote:
  • UI do HyperDX
  • OTel collector (OpenTelemetry)
  • ClickHouse
Essa imagem tudo em um permite iniciar a stack completa com um único comando, o que a torna ideal para testes, experimentação ou implantações locais rápidas.
1

​
Implante a stack com Docker

O comando a seguir executará um OTel collector (nas portas 4317 e 4318), a UI do HyperDX (na porta 8080) e o ClickHouse (8123).
Atualização do nome da imagemAs imagens do ClickStack agora são publicadas como clickhouse/clickstack-* (anteriormente docker.hyperdx.io/hyperdx/*).
Persistência de dados e configuraçõesPara persistir dados e configurações entre reinicializações do contêiner, você pode modificar o comando Docker acima para montar os caminhos /data/db, /var/lib/clickhouse e /var/log/clickhouse-server.Por exemplo:
2

​
Acesse a UI do ClickStack

Acesse http://localhost:8080 para abrir a UI do ClickStack (HyperDX).Crie um usuário, fornecendo um nome de usuário e uma senha que atendam aos requisitos de complexidade.O HyperDX se conectará automaticamente ao cluster local e criará fontes de dados para logs, traces, métricas e sessões, permitindo que você explore o produto imediatamente.
3

​
Explore o produto

Com a stack implantada, experimente um dos nossos conjuntos de dados de exemplo.Para continuar usando o cluster local:
Como alternativa, você pode se conectar a um cluster de demonstração, onde poderá explorar um conjunto de dados maior:

​
Modelos alternativos de implantação

​
Modo local

O modo local é uma forma de implantar o HyperDX sem precisar de autenticação. A autenticação não é suportada. Este modo se destina a testes rápidos, desenvolvimento, demonstrações e cenários de depuração em que a autenticação e a persistência das configurações não são necessárias. Para mais detalhes sobre esse modelo de implantação, consulte “Apenas modo local”.

​
Versão hospedada

Você pode usar uma versão hospedada do ClickStack em modo local, disponível em play-clickstack.clickhouse.com.

​
Versão auto-hospedada

1

​
Executar com Docker

A imagem do modo local auto-hospedado já vem com um OTel collector, a UI do ClickStack e um servidor ClickHouse pré-configurados. Isso facilita o consumo de dados de telemetria das suas aplicações e a visualização deles com configuração externa mínima. Para começar a usar a versão auto-hospedada, basta executar o contêiner Docker com as portas apropriadas mapeadas:
Ao contrário da imagem “All in one”, não será solicitado que você crie um usuário, pois o modo local não inclui autenticação.
2

​
Preencha as credenciais de conexão

Para se conectar ao seu próprio cluster externo do ClickHouse, você pode inserir manualmente suas credenciais de conexão.Como alternativa, para explorar o produto rapidamente, você também pode clicar em Conectar ao servidor de demonstração para acessar datasets pré-carregados e experimentar o ClickStack sem nenhuma configuração.Se estiver se conectando ao servidor de demonstração, você pode explorar o dataset com as instruções do dataset de demonstração.
Última modificação em 19 de junho de 2026