Embutido no ClickHouse

Usando o ClickStack embutido no servidor ClickHouse - a stack de observabilidade do ClickHouse

O ClickStack vem embutido diretamente no binário do servidor ClickHouse. Isso significa que você pode acessar a UI do ClickStack (HyperDX) na sua instância do ClickHouse sem implantar nenhum componente adicional. Essa implantação é semelhante à demonstração pública em play-clickstack.clickhouse.com, mas roda na sua própria instância do ClickHouse e com seus próprios dados.

​

Indicado para

• Experimentar o ClickStack com configuração mínima
• Explorar seus próprios dados no ClickHouse com uma UI de observabilidade
• Demonstrações e avaliações

​

Limitações

Esta versão embutida não foi projetada para uso em produção. Os recursos a seguir não estão disponíveis em comparação com as implantações OSS prontas para produção:

• Alertas
• Persistência de dashboards e buscas — dashboards e buscas salvas não são mantidos entre sessões
• Configurações de consulta personalizáveis
• Padrões de eventos

​

Etapas de implantação

Docker

1. ​

   Inicie o ClickHouse

   Baixe e execute a imagem do servidor ClickHouse com uma senha configurada:

   docker run --rm -it -p 8123:8123 -e CLICKHOUSE_PASSWORD=password clickhouse/clickhouse-server:head-alpine
   

   Executando sem senha

   Se preferir executar sem senha, você deverá ativar explicitamente o gerenciamento de acesso padrão:

   docker run --rm -it -p 8123:8123 -e CLICKHOUSE_DEFAULT_ACCESS_MANAGEMENT=1 clickhouse/clickhouse-server:head-alpine
   
2. ​

   Abra a UI do ClickStack

   Abra http://localhost:8123 no navegador e clique em ClickStack.

   Digite o nome de usuário default e a senha password para se conectar à instância local.

3. ​

   Crie uma fonte

   Se você já tiver tabelas do OpenTelemetry, o ClickStack vai detectá-las e criar fontes automaticamente.

   Em uma instalação nova, será solicitado que você crie uma fonte. Preencha o campo Table com o nome de tabela apropriado (por exemplo, otel_logs) e clique em Save New Source.

   Se você ainda não tiver dados, consulte Ingestão de dados para ver as opções disponíveis.

Binary

1. ​

   Inicie o ClickHouse

   Baixe e inicie o ClickHouse:

   curl https://clickhouse.com/ | sh
   

   Opcional: ativar tabelas de log do sistema

   Para explorar os logs e as métricas internas do próprio ClickHouse, crie um trecho de configuração no seu diretório de trabalho antes de iniciar o servidor:

   mkdir -p config.d && cat > config.d/query_logs.xml << 'EOF'
   <clickhouse>
       <query_log>
           <database>system</database>
           <table>query_log</table>
       </query_log>
       <query_thread_log>
           <database>system</database>
           <table>query_thread_log</table>
       </query_thread_log>
       <query_views_log>
           <database>system</database>
           <table>query_views_log</table>
       </query_views_log>
       <metric_log>
           <database>system</database>
           <table>metric_log</table>
       </metric_log>
       <asynchronous_metric_log>
           <database>system</database>
           <table>asynchronous_metric_log</table>
       </asynchronous_metric_log>
   </clickhouse>
   EOF
   

   Com isso ativado, você pode criar uma Log Source apontando para system.query_log após abrir o ClickStack:

   Setting	Value
   Name	Query Logs
   Database	system
   Table	query_log
   Timestamp Column	event_time
   Default Select	event_time, query_kind, query, databases, tables, initial_user, projections, memory_usage, written_rows, read_rows, query_duration_ms

   Inicie o servidor:

   ./clickhouse server
   
2. ​

   Abra a UI do ClickStack

   Abra http://localhost:8123 no navegador e clique em ClickStack. Uma conexão com a instância local é criada automaticamente.

3. ​

   Crie uma fonte

   Se você já tiver tabelas do OpenTelemetry, o ClickStack vai detectá-las e criar fontes automaticamente.

   Se você ainda não tiver dados, consulte Ingestão de dados para ver as opções disponíveis.

​

Próximos passos

Se você já está pronto para avançar além da avaliação, considere uma implantação pronta para produção:

• Tudo em um — um único contêiner com todos os componentes, incluindo persistência e autenticação
• Docker Compose — componentes individuais para maior controle
• Helm — recomendado para implantações do Kubernetes em produção
• Managed ClickStack — totalmente gerenciado no ClickHouse Cloud