OpenTelemetry proporciona API y SDK de uso general para recopilar, procesar y exportar datos de observabilidad. Uno de los casos de uso más populares para estas API y SDK es el monitoreo APM , donde se instala instrumentación para monitor una aplicación o servicio.
Esta página describe los pasos de configuración comunes para el monitoreo de APM basado en OpenTelemetry con New Relic.
Antes de que empieces
- Regístrese para obtener una cuenta New Relic.
- Obtenga la clave de licencia para la cuenta New Relic a la que desea reportar datos.
Instrumente su aplicación o servicio con OpenTelemetry
OpenTelemetry proporciona API y SDK específicos del idioma para aplicaciones instrumentadas. La mayoría de los lenguajes proporcionan un rico conjunto de instrumentación para bibliotecas y marcos populares.
Para ayudarlo a empezar, ofrecemos una aplicación de ejemplo sencilla en una variedad de idiomas. Para cada idioma, la aplicación se crea empleando framework sitio web popular para ese idioma. Los siguientes ejemplos demuestran cómo configurar:
El nombre del servicio que se mostrará en New Relic.
El exportador OpenTelemetry Protocol (OTLP) para enviar datos al extremo OTLPNew Relic .
Configuraciones recomendadas adicionales para optimizar OpenTelemetry y obtener la mejor experiencia de New Relic.
Para obtener más información sobre qué instrumentación está disponible y escenarios más avanzados, consulte la documentación del lenguaje OpenTelemetry correspondiente.
Importante
Puede emplear cualquier idioma que admita OpenTelemetry para enviar datos a New Relic. Sin embargo, los ejemplos anteriores reflejan sólo un subconjunto de los idiomas admitidos.
¿Extrañas tu idioma? ¡Aplicar un ejemplo abriendo una incidencia en GitHub!
Vea sus datos en la UI de New Relic
Una vez que su aplicación esté instrumentada y configurada para exportar datos a New Relic, debería poder encontrar sus datos en la New Relic UI:
Encuentra tu entidad en All entities > Services - OpenTelemetry. El nombre de la entidad se establece en el valor del atributo de recurso
service.namede la aplicación. Para obtener más información sobre cómo las entidades de servicio New Relic se derivan del atributo de recurso OpenTelemetry , consulte Servicios.Emplee NRQL para consultar directamente traza, métrica y log.
OpenTelemetry APM UI Consulte para obtener más información.
Si no puede encontrar su entidad y no ve sus datos con NRQL, consulte Resolución de problemas de OTLP.
Ejecutar los agentes New Relic y las herramientas OpenTelemetry en el mismo proceso
Las herramientas New Relic agente y OpenTelemetry (SDK, agente, etc.) se encuentran entre muchos productos APM en el mercado.
Para un lenguaje determinado, casi todos los productos APM funcionan utilizando el mismo lenguaje de bajo nivel y los mismos enlaces de tiempo de ejecución disponibles, la mayoría de los cuales alteran el comportamiento de su código en tiempo de ejecución. Dependiendo de la arquitectura de su lenguaje, esto a menudo se logra mediante técnicas como la manipulación de códigos de bytes o parches de mono.
Debido a las formas complejas en que los productos APM modifican el código en ejecución, no hay garantías de que un producto sea compatible con otro producto que se ejecute en el mismo proceso. En el mejor de los casos, vivirán uno al lado del otro sin que el otro lo sepa y generarán telemetría de forma independiente desde su aplicación. En el peor de los casos, se pisotearán unos a otros, lo que provocará un comportamiento impredecible.
New Relic no puede garantizar que nuestro agente APM sea compatible con un producto APM diferente que se ejecute en el mismo proceso. Le recomendamos que elija el producto (y sólo uno) que mejor se adapte a sus necesidades.