> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviando OpenTelemetry ao ClickStack com o Bindplane

> Encaminhe a telemetria ao ClickStack usando o Bindplane para gerenciamento centralizado de coletores

export const PartnerBadge = () => {
  return <div className="PartnerBadge">
            <div className="PartnerBadgeIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <polyline points="12.5 9.5 10 12 6 11 2.5 8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="4.54 4.41 8 3.5 11.46 4.41" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M2.15,3.78 L0.55,6.95 A0.5,0.5 0,0,0 0.77,7.62 L2.5,8.5 L4.54,4.41 L2.82,3.55 A0.5,0.5 0,0,0 2.15,3.78 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M13.5,8.5 L15.23,7.62 A0.5,0.5 0,0,0 15.45,6.95 L13.85,3.78 A0.5,0.5 0,0,0 13.18,3.55 L11.46,4.41 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M11.5,4.5 L9,4.5 L6.15,7.27 A0.5,0.5 0,0,0 6.24,8.05 C7.33,8.74 8.81,8.72 10,7.5 L12.5,9.5 L13.5,8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="7.75 13.5 5.15 12.85 3.5 11.67" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                </svg>
            </div>
            Partner Integration
        </div>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

<Info>
  **TL;DR**

  Este guia mostra como rotear telemetria para o ClickStack usando o destino nativo do ClickStack no Bindplane. Você aprenderá a:

  * Configurar o ClickStack como um destino no Bindplane
  * Criar uma configuração para processar e rotear telemetria
  * Implantar configurações remotamente em OTel coletores e começar a coletar dados
  * Visualizar a telemetria no ClickStack

  Esta integração combina a ingestão de alto desempenho do ClickStack com o gerenciamento centralizado de coletores do Bindplane, facilitando a escalabilidade da observabilidade sem sobrecarga operacional.

  Tempo necessário: 10-15 minutos
</Info>

<div id="what-is-bindplane">
  ## O que é o Bindplane?
</div>

O Bindplane é um pipeline de telemetria nativo do OpenTelemetry que oferece gerenciamento centralizado para os OpenTelemetry Coletores. Ele simplifica a operação de grandes frotas de coletores ao oferecer edição visual de configuração, rollouts seguros e inteligência de pipeline.

<div id="why-bindplane-clickstack">
  ## Por que Bindplane + ClickStack?
</div>

Em ambientes de grande escala, gerenciar frotas de OpenTelemetry Coletores se torna o gargalo operacional. O ClickStack já provou que consegue lidar com volumes extremos de ingestão — clientes fazem ingestão de telemetria em gigabytes por segundo e armazenam centenas de petabytes. O desafio deixa de ser o desempenho das consultas e passa a ser operar com confiabilidade a infraestrutura de coletores que alimenta o ClickHouse.

O Bindplane resolve isso oferecendo:

* Gerenciamento centralizado de OpenTelemetry Coletores, de milhares a mais de um milhão
* Edição visual de configuração com rollouts seguros em um clique
* Detecção automática de recursos e enriquecimento aplicados de forma consistente antes que os dados cheguem ao ClickStack
* Roteamento fan-out, para que os mesmos fluxos de telemetria possam ser enviados simultaneamente ao ClickStack e a outros destinos
* Visibilidade completa do pipeline, incluindo a integridade dos coletores, a vazão e o desempenho de ponta a ponta

<Tip>
  **Principais pontos**

  * **O ClickStack lida com volumes extremos de ingestão, armazenamento e consultas analíticas rápidas**
  * **O Bindplane gerencia o pipeline de ingestão e a complexidade operacional de executar frotas de coletores**
</Tip>

<div id="prerequisites">
  ## Pré-requisitos
</div>

* Instância do ClickStack em execução (local, Server ou ClickHouse Cloud)
* Conta do Bindplane ([crie uma conta em `app.bindplane.com`](https://app.bindplane.com))
* Bindplane OTel Collector instalado (consulte [Install Your First Collector](https://docs.bindplane.com/readme/install-your-first-collector))
* Conectividade de rede entre os coletores do Bindplane e o endpoint OTLP do ClickStack
* API Ingestion Key do ClickStack (encontrada em ClickStack Team Settings > API Keys; [veja a documentação para referência](/pt-BR/clickstack/ingesting-data/opentelemetry#sending-otel-data))
* Portas de rede apropriadas abertas (`4318` para HTTP/s ou `4317` para gRPC)

<div id="integrate-bindplane-clickstack">
  ## Integre o ClickStack ao Bindplane
</div>

<Steps>
  <Step>
    #### Configure o ClickStack como destino

    1. Faça login na sua conta do Bindplane
    2. Acesse **Library**
    3. Clique em **Add Destination**
    4. Selecione **ClickStack** na lista de destinos disponíveis
    5. Configure a conexão:
       * **Protocol**: Escolha HTTP ou gRPC (padrão: HTTP na porta `4318`)
       * **Hostname**: Insira o hostname ou endereço IP do endpoint OTLP do ClickStack
       * **Port**: Insira a porta (`4318` para HTTP, `4317` para gRPC)
       * **API Ingestion Key**: Insira sua chave de API de ingestão do ClickStack
    6. Dê um nome ao destino (por exemplo, "ClickStack Produção")
    7. Clique em **Save** para criar o destino

    <Tip>
      **Principais pontos**

      O destino ClickStack oferece suporte aos protocolos HTTP e gRPC. Para cenários de alto volume, recomenda-se usar gRPC com compressão (gzip, zstd ou snappy) para melhor desempenho.
    </Tip>
  </Step>

  <Step>
    #### Crie uma configuração

    Depois de configurar o destino ClickStack, crie uma configuração para processar e rotear a telemetria:

    1. Acesse **Configurations** → **Create Configuration**
    2. Dê um nome à configuração (por exemplo, "Pipeline do ClickStack")
    3. Selecione o **Collector Type** e a **Platform** da sua implantação
    4. Adicione origens:
       * Clique em **Add Source** para selecionar entre mais de 80 origens disponíveis
       * Para testes, você pode adicionar uma origem geradora de telemetria para simular tráfego
       * Para produção, adicione origens para sua telemetria real (logs, métricas, traces)
    5. Adicione o destino ClickStack:
       * Clique em **Add Destination**
       * Selecione o destino ClickStack que você criou na etapa anterior
       * Escolha quais tipos de telemetria enviar (Logs, Metrics, Traces ou todos)

    <Tip>
      **Principais pontos**

      Você pode adicionar processadores para filtragem, sampling, mascaramento, enriquecimento, batching e muito mais para moldar a telemetria antes que ela chegue ao ClickStack. Isso garante que dados consistentes e estruturados cheguem ao ClickHouse.
    </Tip>
  </Step>

  <Step>
    #### Adicione processadores (opcional)

    O Bindplane oferece pipeline intelligence e recomendações de processadores. Você pode adicionar processadores para:

    * **Filter**: Reduzir o volume de dados excluindo telemetria desnecessária
    * **Sample**: Aplicar estratégias de sampling a traces de alto volume
    * **Enrich**: Adicionar atributos de resource, labels ou metadados
    * **Transform**: Modificar a estrutura ou o conteúdo da telemetria
    * **Batch**: Otimizar os tamanhos de batch para uma transmissão eficiente

    Esses processadores são aplicados de forma consistente em toda a sua frota de coletores antes que os dados cheguem ao ClickStack.
  </Step>

  <Step>
    #### Implante coletores e inicie o rollout

    1. Adicione um coletor (BDOT Collector) à sua configuração:
       * Acesse **Agents** no Bindplane
       * Instale o coletor do Bindplane nos sistemas de destino [seguindo as instruções de instalação do Bindplane](https://docs.bindplane.com/readme/install-your-first-collector)
       * O coletor aparecerá na sua lista de coletores assim que se conectar

    2. Atribua a configuração aos seus coletores:
       * Selecione os coletores que você quer usar
       * Atribua a eles a configuração do ClickStack

    3. Inicie um rollout:
       * Clique em **Start Rollout** para implantar a configuração
       * O Bindplane validará a configuração antes do rollout
       * Monitore o status do rollout na UI do Bindplane

    <Tip>
      **Principais pontos**

      O Bindplane oferece rollouts seguros com um clique e validação. Você pode monitorar a integridade do coletor, a taxa de transferência e eventuais erros em tempo real pela interface do Bindplane.
    </Tip>

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/Y9kcWM6RbYppspJn/images/clickstack/bindplane/bindplane-configuration.png?fit=max&auto=format&n=Y9kcWM6RbYppspJn&q=85&s=46e60e4c3a228796bf0147f8e95c7909" alt="Sinais de telemetria no ClickStack via Bindplane" size="lg" width="2682" height="1900" data-path="images/clickstack/bindplane/bindplane-configuration.png" />
  </Step>

  <Step>
    #### Verifique a telemetria no ClickStack

    Depois que a configuração for aplicada, a telemetria começará a fluir para o ClickStack a partir da sua frota gerenciada de coletores:

    1. Faça login na sua instância do ClickStack (UI do HyperDX)
    2. Acesse o explorador de **Logs**, **Metrics** ou **Traces**
    3. Você deverá ver dados de telemetria dos seus coletores gerenciados pelo Bindplane
    4. Os dados que chegam ao ClickStack já são enriquecidos e estruturados pelos processadores do Bindplane

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/Y9kcWM6RbYppspJn/images/clickstack/bindplane/bindplane-hyperdx.png?fit=max&auto=format&n=Y9kcWM6RbYppspJn&q=85&s=e63183b23afa336419694c0c26fb705b" alt="Sinais de telemetria no ClickStack via Bindplane" size="lg" width="3388" height="2342" data-path="images/clickstack/bindplane/bindplane-hyperdx.png" />
  </Step>
</Steps>

<div id="advanced-configuration">
  ## Configuração avançada
</div>

<div id="fan-out-routing">
  ### Roteamento fan-out
</div>

O Bindplane oferece suporte a roteamento fan-out, permitindo que você envie os mesmos fluxos de telemetria para vários destinos simultaneamente. Você pode:

* Enviar logs, métricas e traces para o ClickStack para armazenamento e análise de longo prazo
* Encaminhar os mesmos dados para outras plataformas de observabilidade para alertas em tempo real
* Encaminhar telemetria específica para plataformas SIEM para análise de segurança

Isso é configurado adicionando vários destinos à sua configuração do Bindplane.

<div id="compression">
  ### Compressão e desempenho
</div>

Para cenários de alto volume, configure a compressão no seu destino do ClickStack:

* **HTTP**: Oferece suporte a gzip, deflate, snappy, zstd ou none (padrão: gzip)
* **gRPC**: Oferece suporte a gzip, snappy, zstd ou none (padrão: gzip)

A compressão reduz o consumo de largura de banda ao enviar telemetria para o ClickStack, algo especialmente importante em ambientes de grande escala.

<div id="next-steps">
  ## Próximos passos
</div>

Agora que a telemetria está fluindo do Bindplane para o ClickStack, você pode:

* **Criar dashboards**: Crie visualizações no ClickStack (HyperDX) para logs, métricas e traces
* **Configurar alertas**: Configure alertas no ClickStack para condições críticas
* **Escalar sua implantação**: Adicione mais coletores e fontes à medida que suas necessidades de observabilidade aumentarem
* **Otimizar seu pipeline**: Use o pipeline intelligence do Bindplane para identificar oportunidades de otimização

<div id="read-more">
  ## Leia também
</div>

* [Integração do ClickStack na documentação do Bindplane](https://docs.bindplane.com/integrations/destinations/clickstack)