Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Arquitetura

View as MarkdownEdit this pageReport an issueSet up docs MCP

A arquitetura do ClickStack varia conforme a forma como ele é implantado. Há distinções arquitetônicas importantes entre o ClickStack Open Source, em que todos os componentes são autogerenciados, e o Managed ClickStack, em que o ClickHouse e a UI do HyperDX são hospedados e operados no ClickHouse Cloud. Embora os componentes principais permaneçam os mesmos em ambos os modelos, a responsabilidade por hospedar, escalar e proteger cada componente difere.

Visão geral da arquitetura

A seguir, apresentamos uma visão geral das arquiteturas gerenciada e de código aberto do ClickStack.

O ClickStack Managed é executado inteiramente no ClickHouse Cloud, fornecendo um backend de observabilidade totalmente gerenciado e preservando o mesmo modelo de dados e a mesma experiência de usuário do ClickStack.

Nesse modelo, o ClickHouse e a interface do ClickStack (HyperDX) são hospedados, operados e protegidos pelo ClickHouse Cloud. Os usuários são responsáveis apenas por executar um coletor OpenTelemetry (OTel) para enviar dados de telemetria ao serviço gerenciado.

Arquitetura gerenciada

ClickHouse Cloud: o mecanismo

No centro do ClickStack Managed está o ClickHouse Cloud, uma versão serverless do ClickHouse — um banco de dados orientado a colunas projetado para analytics em tempo real em escala. Ele viabiliza a ingestão e a consulta de dados de observabilidade, permitindo:

  • Busca em menos de um segundo em terabytes de eventos
  • Ingestão de bilhões de registros de alta cardinalidade por dia
  • Altas taxas de compressão de pelo menos 10x em dados de observabilidade
  • Suporte nativo a dados JSON semiestruturados, permitindo a evolução dinâmica do esquema
  • Um poderoso mecanismo SQL com centenas de funções analíticas integradas

O ClickHouse Cloud trata os dados de observabilidade como eventos wide, permitindo uma correlação profunda entre logs, métricas e traces em uma única estrutura unificada.

Além do ClickHouse Open Source, ele oferece vários benefícios para observabilidade:

  • Escalonamento automático de compute independente do armazenamento
  • Retenção de baixo custo e efetivamente ilimitada com base em armazenamento de objetos
  • A capacidade de isolar de forma independente workloads de leitura e gravação com Warehouses.
  • Autenticação integrada
  • Backups automatizados
  • Recursos de segurança e compliance
  • Upgrades sem interrupções

OpenTelemetry collector: ingestão de dados

O ClickStack Managed inclui um coletor OpenTelemetry (OTel) pré-configurado para fazer a ingestão de telemetria de forma aberta e padronizada. Você pode enviar dados usando o protocolo OTLP via:

  • gRPC (porta 4317)
  • HTTP (porta 4318)

O coletor exporta a telemetria para o ClickHouse Cloud em batches eficientes. Ele oferece suporte a esquemas de tabela otimizados por fonte de dados, garantindo desempenho escalável em todos os tipos de sinal.

Este componente da arquitetura é gerenciado pelo usuário

ClickStack UI (HyperDX): a interface

A ClickStack UI (HyperDX) é a interface de usuário do ClickStack. Ela oferece:

  • Busca em linguagem natural e no estilo Lucene
  • Live tailing para depuração em tempo real
  • Visualizações unificadas de logs, métricas e traces
  • Session replay para observabilidade de frontend
  • Criação de dashboards e configuração de alertas
  • Interface de consulta SQL para análises avançadas

Projetado especificamente para o ClickHouse, o HyperDX combina recursos avançados de busca com fluxos de trabalho intuitivos, permitindo que você identifique anomalias, investigue problemas e obtenha insights rapidamente.

No ClickStack Managed, a UI é integrada ao sistema de autenticação do console do ClickHouse Cloud.

Navigation