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 usas Next.js, consulta este ejemplo de una aplicación de 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 una aplicación Next.js, cargue nuestro agente mediante NODE_OPTIONS:

   CMD ["NODE_OPTIONS='-r newrelic'", "next", "start"]

   Copia

   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 usar el indicador require -r, también puede usar require('newrelic') como la primera línea del módulo principal de su aplicación. Sin embargo, si utiliza Babel o un transpilador similar, require('newrelic') causará problemas de instrumentación.

   // load the agent
   const newrelic = require('newrelic');
   
   // load other packages
   const expressModule = require('express');

   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 UI de 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, consulta nuestra documentación de la API.

Ver el log de sus datos de infraestructura y APM

También puede reunir los datos de su log y de la aplicación para que la resolución de problemas sea más fácil y rápida. Con logs en el contexto, puede ver el mensaje de log relacionado con sus errores y la traza directamente en UI de su aplicación. También puede ver logs 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.