Pular para o conteúdo principal
Todos os dados são enviados ao ClickStack por meio de uma instância do OpenTelemetry (OTel) collector, que atua como ponto de entrada principal para logs, métricas, traces e dados de sessão. Recomendamos usar a distribuição oficial do ClickStack do collector para essa instância.
Uma versão gerenciada do ClickStack também está disponível — consulte Managed ClickStack.
Os usuários enviam dados para esse collector a partir de SDKs de linguagem ou por meio de agentes de coleta de dados que coletam métricas e logs de infraestrutura (como OTel collectors na função de agent ou outras tecnologias, como Fluentd ou Vector). Para equipes que desejam um pipeline OpenTelemetry gerenciado, o Bindplane oferece uma solução nativa de OpenTelemetry com um destino nativo do ClickStack, simplificando a coleta, o processamento e o roteamento da telemetria.

​
Enviando dados de OpenTelemetry

​
Instalando o ClickStack OpenTelemetry collector

Para enviar dados ao Managed ClickStack, um OTel collector deve ser implantado em uma função de gateway. Instrumentação compatível com OTel enviará eventos para esse collector via OTLP por HTTP ou gRPC.
Recomendamos usar o ClickStack OpenTelemetry collectorIsso permite que você se beneficie de ingestão padronizada, schemas aplicados e compatibilidade pronta para uso com a ClickStack UI (HyperDX). Usar o schema padrão permite a detecção automática de sources e mapeamentos de colunas pré-configurados.
Para mais detalhes, consulte “Implantando o collector”.

​
Enviando dados para o collector

Para enviar dados ao Managed ClickStack, aponte sua instrumentação OpenTelemetry para os seguintes endpoints disponibilizados pelo OpenTelemetry collector:
  • HTTP (OTLP): http://localhost:4318
  • gRPC (OTLP): localhost:4317
Para SDKs de linguagem e bibliotecas de telemetria compatíveis com OpenTelemetry, você pode simplesmente definir a variável de ambiente OTEL_EXPORTER_OTLP_ENDPOINT na sua aplicação:
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
Se estiver implantando uma distribuição contrib do OTel collector na função de agent, você pode usar o exporter OTLP para enviar dados ao ClickStack collector. Um exemplo de config de agent que consome este arquivo de log estruturado é mostrado abaixo.
# clickhouse-agent-config.yaml
receivers:
  filelog:
    include:
      - /opt/data/logs/access-structured.log
    start_at: beginning
    operators:
      - type: json_parser
        timestamp:
          parse_from: attributes.time_local
          layout: '%Y-%m-%d %H:%M:%S'
exporters:
  # Configuração HTTP
  otlphttp/hdx:
    endpoint: 'http://localhost:4318'
    compression: gzip
 
  # Configuração gRPC (alternativa)
  otlp/hdx:
    endpoint: 'localhost:4317'
    compression: gzip
processors:
  batch:
    timeout: 5s
    send_batch_size: 10000
service:
  telemetry:
    metrics:
      address: 0.0.0.0:9888 # Modificado pois há 2 collectors rodando no mesmo host
  pipelines:
    logs:
      receivers: [filelog]
      processors: [batch]
      exporters: [otlphttp/hdx]
Última modificação em 10 de junho de 2026