O coletor OpenTelemetry é uma ferramenta independente de fornecedor para receber, processar e exportar dados de telemetria. É recomendável executar o coletor no pipeline de observabilidade. Embora os requisitos e a configuração do coletor variem, é comum rotear dados do APM OpenTelemetry por meio de um coletor. Isso elimina a sobrecarga do aplicativo e fornece um local para enriquecer a telemetria com dados adicionais de contexto do ambiente, filtrar e transformar e muito mais. Também é comum usar o coletor para monitoramento de infraestrutura, mas esta documentação se concentra em casos de uso de processamento de dados. Consulte coletor para monitoramento de infraestrutura para mais informações.
Aqui está um exemplo do coletor como gateway, mas você também pode configurar o coletor como um agente em execução no mesmo host do seu aplicativo:
![Diagram of OTLP with collector Diagram showing OpenTelemetry using the OpenTelemetry collector and New Relic's OTLP endpoint.](/images/opentelemetry_diagram_native-otlp-with-collector.webp)
O coletor possui um extenso conjunto de receptores, processadores, exportadores, extensões e conectores. Esses componentes são agrupados em distribuições pré-construídas. No entanto, é possível construir componentes personalizados para atender a requisitos específicos e construir uma distribuição de coletor personalizada para empacotar um conjunto específico de componentes.
Embora a configuração varie de acordo com os requisitos, os coletores que enviam dados para New Relic devem ter algumas coisas em comum:
Exportador OTLP
O coletor OpenTelemetry suporta a exportação de dados usando o otlphttpexporter. Certifique-se de que a configuração do exportador corresponda aos requisitos do New Relic OTLP.
Observe que o otlpexporter é compatível, mas o protocolo binário OTLP/HTTP é preferível ao OTLP/gRPC.
Processador em lote
Configure o coletor para usar o processador em lote para exportar registros em lotes. Certifique-se de que o tamanho e a frequência do lote estejam configurados para atender aos requisitos do OTLP da New Relic.
Exemplo mínimo
Para instalar o coletor, consulte a documentação do OpenTelemetry.
Execute o coletor com a configuração abaixo, certificando-se de substituir o seguinte:
- Substitua
<INSERT_NEW_RELIC_OTLP_ENDPOINT>
pelo endpoint OTLP New Relicapropriado - Substitua
<INSERT_NEW_RELIC_LICENSE_KEY>
pela sua chave de licença
receivers: otlp: protocols: grpc: http:
processors: batch:
exporters: otlphttp: endpoint: <INSERT_NEW_RELIC_OTLP_ENDPOINT> headers: api-key: <INSERT_NEW_RELIC_LICENSE_KEY>
service: pipelines: traces: receivers: [otlp] processors: [batch] exporters: [otlphttp] metrics: receivers: [otlp] processors: [batch] exporters: [otlphttp] logs: receivers: [otlp] processors: [batch] exporters: [otlphttp]
Para obter um exemplo prático, consulte o repositório de exemplos do New Relic OpenTelemetry.
Para exemplos adicionais de coletores, consulte Coletor para monitoramento de infraestrutura.