El recolector OpenTelemetry es una herramienta independiente del proveedor para recibir, procesar y exportar telemetry data. Se recomienda ejecutar el recolector en su canal de observabilidad. Si bien los requisitos y la configuración del recolector variarán, es común enrutar los datosAPM OpenTelemetry a través de un recolector. Esto aleja la sobrecarga de la aplicación y proporciona un lugar para enriquecer la telemetría con datos adicionales del contexto del entorno, filtrado y transformación, y más. También es común usar el recolector para monitoreo de infraestructura, pero esta documentación se enfoca en casos de uso de procesamiento de datos. Ver recolector de monitoreo de infraestructura para más información.
A continuación se muestra un ejemplo del recolector como puerta de enlace, pero también puede configurar el recolector como un agente que se ejecuta en el mismo host que su aplicación:
![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)
El recolector cuenta con un extenso conjunto de receptores, procesadores, exportadores, extensiones y conectores. Estos componentes están incluidos en distribuciones prediseñadas. Sin embargo, es posible crear componentes personalizados que se ajusten a requisitos específicos y crear una distribución de recolector personalizada para empaquetar un conjunto específico de componentes.
Si bien la configuración varía según los requisitos, el recopilador que envía datos a New Relic debe tener ciertas cosas en común:
Exportador OTLP
El recolector OpenTelemetry admite la exportación de datos mediante otlphttpexporter. Cerciorar de que la configuración del exportador coincida con los requisitos de New Relic OTLP.
Tenga en cuenta que otlpexporter es compatible, pero se prefiere el protocolo binario OTLP/HTTP a OTLP/gRPC.
Procesador por lotes
Configure el recolector para emplear el procesador por lotes para exportar registros en lotes. Cerciorar de que el tamaño y la frecuencia del lote estén configurados para cumplir con los requisitos de New Relic OTLP.
Ejemplo mínimo
Para instalar el recopilador, consulte la documentación OpenTelemetry .
Ejecute el recopilador con la configuración siguiente, cerciorar de reemplazar lo siguiente:
- Reemplace
<INSERT_NEW_RELIC_OTLP_ENDPOINT>
con el extremo OTLPNew Relic apropiado - Reemplace
<INSERT_NEW_RELIC_LICENSE_KEY>
con su clave de licencia
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 ver un ejemplo práctico, consulte el New Relic OpenTelemetry repositorio de ejemplos .
Para ejemplos adicionales de recolectores, consulte recolector para monitoreo de infraestructura.