Collector

Receba, processe e exporte dados de telemetria de forma agnóstica a fornecedor.

O conteúdo desta página pode estar desatualizado e alguns links podem ser inválidos. Uma versão mais recente desta página existe em Inglês.

Mais informações ...

Para visualizar as alterações na página em inglês desde a última atualização: visite GitHub compare 2871fe3c..f92d19f1 e procure por content/en/docs/collector/_index.md.

Diagrama do OpenTelemetry Collector com integração para Jaeger, OTLP e Prometheus

Introdução

O OpenTelemetry Collector oferece uma implementação agnóstica a fornecedores para receber, processar e exportar dados de telemetria. Eliminando a necessidade de executar, operar e manter múltiplos agentes/coletores. Isso melhora a escalabilidade e oferece suporte a formatos de dados de observabilidade de código aberto (por exemplo, Jaeger, Prometheus, Fluent Bit, etc.), enviando dados para um ou mais backends de código aberto ou comerciais.

Objetivos

  • Usabilidade: Configuração padrão razoável, suporte a protocolos populares, executa e coleta dados pronto para uso.
  • Desempenho: Altamente estável e performático sob cargas e configurações variadas.
  • Observabilidade: Um exemplo de serviço observável.
  • Extensibilidade: Personalizável sem alterar o código principal.
  • Unificação: Base de código única, implantável como agente ou coletor, com suporte a rastros, métricas e logs.

Quando usar um Collector

Na maioria das bibliotecas de instrumentação específicas de linguagem, há exportadores para backends populares e para OTLP. Você pode se perguntar:

em quais circunstâncias usar um Collector para enviar dados, em vez de fazer cada serviço enviar diretamente para o backend?

Para experimentar e dar os primeiros passos com o OpenTelemetry, enviar seus dados diretamente para um backend é uma ótima forma de obter valor rapidamente. Além disso, em um ambiente de desenvolvimento ou de pequena escala, você pode obter bons resultados sem um Collector.

No entanto, em geral recomenda-se utilizar um Collector junto ao serviço, pois isso permite que o serviço envie os dados rapidamente enquanto o Collector cuida de tratamentos adicionais, como tentativas de reenvio, agrupamento em lotes, criptografia e até filtragem de dados sensíveis.

Configurar um Collector é mais fácil do que pode parecer: os exportadores OTLP padrão em cada linguagem assumem uma rota (endpoint) local de Collector. Portanto, ao iniciar um Collector, a recepção de telemetria começa automaticamente.

Segurança do Collector

Siga as boas práticas para garantir que seus coletores estejam hospedados e configurados com segurança.

Status

O status do Collector é: misto, pois os componentes centrais do Collector atualmente possuem níveis de estabilidade variados.

Os componentes do Collector diferem em seus níveis de maturidade. Cada componente tem sua estabilidade documentada em seu respectivo README.md. Uma lista de todos os componentes disponíveis do Collector pode ser encontrada no registro.

O suporte a artefatos de software do Collector é garantido por um período de tempo determinado, com base no público-alvo do artefato. Esse suporte inclui, no mínimo, correções para bugs críticos e problemas de segurança. Consulte as políticas de suporte para mais detalhes.

Distribuições e lançamentos

Para informações sobre distribuições e lançamentos do Collector, incluindo a versão mais recente, consulte Distribuições.


Início rápido

Configure e colete telemetria em minutos!

Instalar o Collector

Implantar o Collector

Padrões que você pode aplicar para implantar o OpenTelemetry Collector

Configuration

Learn how to configure the Collector to suit your needs

Componentes

Componentes do OpenTelemetry Collector - receivers, processors, exporters, connectors e extensions

Management

How to manage your OpenTelemetry Collector deployment at scale

Distributions

Internal telemetry

Troubleshooting

Recommendations for troubleshooting the Collector

Scaling the Collector

Transforming telemetry

Arquitetura

Estender o Collector

Aprenda como estender o OpenTelemetry Collector com componentes personalizados

Benchmarks

Registry

Exporters, processors, receivers and other useful components for the OpenTelemetry Collector

Resiliency

How to configure a resilient OTel Collector pipeline


Última modificação June 9, 2026: chore: drifted status update (#10303) (ec3134ea)