Instalar el agente Node.js

Para completar una instalación básica del agente Node.js, puede utilizar nuestra instalación guiada para una instalación automatizada (elija UE si se encuentra en la UE) o seguir las instrucciones de este documento. De cualquier manera, necesita una cuenta New Relic si aún no tiene una. (¡ Es gratis, para siempre!)

Nuestro agente Node.js está disponible públicamente en el repositorio de administrador de paquetes (npm) de Node , así como en GitHub.

Instalar el agente Node.js

Para instalar el agente Node.js:

1. Crea una cuenta New Relic . ¿No tienes uno? ¡Registrate gratis! No se requiere tarjeta de crédito.

2. Asegúrese de cumplir con el requisito del sistema. En particular, asegúrese de utilizar una versión compatible de Node.js.

3. Utilice el comando npm install newrelic para cada aplicación que desee monitor. Si su aplicación utiliza uno de estos módulos de servidor Apollo, instale nuestro complemento Apollo con npm install @newrelic/apollo-server-plugin. Puede encontrar más detalles sobre el uso de @newrelic/apollo-server-plugin aquí.

   Importante

   Si utiliza Next.js, utilice nuestro agente@newrelic/next independiente en lugar del agente newrelic . Aquí hay un ejemplo de aplicación Next.js

4. Desde node_modules/newrelic, copie newrelic.js en el directorio raíz de su aplicación.

5. Configure el agente a través del archivo newrelic.js o mediante la variable de entorno:

   • Personalice la configuración license_key con

     clave de licencia

     .

   • Personalice la configuración app_name con uno o más nombres de aplicaciones significativos.

6. Agregue -r newrelic al script de inicio de su aplicación. Por ejemplo, si el punto de entrada de su aplicación es ./dist/server.js , entonces usaría el indicador require de esta manera:

   bash

   Copia

   $
   node -r newrelic ./dist/server.js

   Un comando Docker de ejemplo:

   CMD ["node", "-r", "newrelic", "server.js"]

   Copia

   Importante

   Para Next.js utilice -r @newrelic/next en lugar de -r newrelic.

   Si está utilizando Nest.JS y el comando nest start para iniciar la aplicación, modifique su binario de inicio para cargar el agente New Relic: nest start --exec 'node -r newrelic'. Aquí hay un ejemplo de aplicación Nest.js.

   Más información sobre la opción de línea de comando de Node.js -r aquí.

   Importante

   Si no puede utilizar el indicador de requisito -r , también puede utilizar require('newrelic') como primera línea del módulo principal de su aplicación. Note Si está utilizando Babel o un transpilador similar require('newrelic') causará problemas de instrumentación.

   Si ninguna de estas opciones funciona para usted (por ejemplo, cargar de forma asincrónica la clave de API desde una ubicación remota durante el arranque de la aplicación), también puede agregar instrumentación estándar a un módulo compatible ya cargado usando newrelic.instrumentLoadedModule:

   // module loaded before newrelic 
   const expressModule = require('express');
   
   // load the agent
   const newrelic = require('newrelic');
   
   // instrument express after the agent has been loaded
   newrelic.instrumentLoadedModule(
     'express',    // the module's name, as a string
     expressModule // the module instance
   );

   Copia

7. Opcional: para obtener estadísticas adicionales a nivel de tiempo de ejecución de Node.js, asegúrese de que el paquete@newrelic/native-metrics esté instalado.

8. Genere algo de tráfico y luego espere unos minutos hasta que aparezcan los datos en la UIde APM.

Puede personalizar aún más el comportamiento de su agente a través de newrelic.js o una variable de entorno. Para mantener la configuración del agente separada de su aplicación, edite la variable ambientalNEW_RELIC_HOME .

Para obtener más información, consulte nuestro documento API.

Ver el registro de sus datos de infraestructura y APM

También puede reunir los datos de su registro y de la aplicación para que la resolución de problemas sea más fácil y rápida. Con el contexto de inicio de sesión, puede ver el mensaje de registro relacionado con sus errores y la traza directamente en UI de su aplicación. También puede ver el inicio de sesión en el contexto de los datos de su infraestructura, como el clúster de Kubernetes. No es necesario cambiar a otra página de UI.

Mantenga actualizado su agente de Node.js

Para asegurarse de tener la versión más actualizada de New Relic, consulte las notas de la versión de Node.js. Cuando corresponde, las notas de la versión incluyen un enlace de descarga con instrucciones sobre cómo actualizar el agente Node.js.

Resolución de problemas

Después de actualizar el agente, genere algo de tráfico y espere unos minutos. Si no aparecen datos en la UI de New Relic, consulte los procedimientos de resolución de problemas.