El agente de Node.js está disponible públicamente en el respositorio de npm y en GitHub.
Sugerencia
¿Usa Docker? Consulte Instalar agente Node.js en Docker.
Requisitos previos
Verifique estos requisitos antes de comenzar.
Requisito | Detalles |
|---|---|
Cuenta de New Relic | Necesita una cuenta de New Relic y su . Téngalo listo antes de comenzar. |
Versión de Node.js | Consulte Compatibilidad y requisitos del agente Node.js para conocer las versiones compatibles de Node.js. |
Instalar el agente
Instale el paquete del agente en el directorio de la aplicación:
$npm install newrelicImportante
Si utiliza Next.js, consulte la guía de instrumentación del agente híbrido de Next.js.
Luego, copie el archivo de configuración predeterminado del paquete en la raíz de la aplicación:
$cp node_modules/newrelic/newrelic.js .Configurar el agente
Abra newrelic.js en la raíz de la aplicación. Los únicos dos ajustes que debe cambiar antes de pasar a producción:
- Establezca
license_keyen su . - Establezca
app_namecomo un nombre significativo para la aplicación.
exports.config = { app_name: ['Your Application Name'], license_key: 'YOUR_LICENSE_KEY', // ...}También puede configurar estos valores mediante variables de entorno en lugar de editar el archivo:
$NEW_RELIC_APP_NAME="Your Application Name"$NEW_RELIC_LICENSE_KEY="YOUR_LICENSE_KEY"Inicie el agente
Cargue el agente antes de cualquier otra instrucción require agregando -r newrelic al comando de inicio:
$node -r newrelic ./your-app.jsSi la aplicación utiliza ESM, agregue la opción --import newrelic/esm-loader.mjs:
$node --import newrelic/esm-loader.mjs -r newrelic ./your-app.jsPara una aplicación de Next.js, cargue nuestro agente a través de NODE_OPTIONS='-r newrelic' next start.
Si usa Nest.js y el comando nest start para iniciar la aplicación, modifique el binario de inicio para cargar el agente de New Relic: nest start --exec 'node -r newrelic'. Aquí hay una aplicación Nest.js de ejemplo.
Verifique que los datos estén fluyendo
Si la versión del agente es 14.9.0 o superior, puede ejecutar este comando para validar la configuración:
$npx newrelic validate-config --config-file ./newrelic.jsEnvíe al menos dos requests a la aplicación.
Espere 2-3 minutos, luego abra one.newrelic.com > APM y busque la aplicación por nombre.
Sugerencia
¿No aparece la aplicación? Consulte Resolución de problemas de la instalación de Node.js.
Artículos relacionados
- Compatibilidad y requisitos del agente de Node.js — Versiones de Node.js y framework compatibles.
- Configuración del agente de Node.js — Todas las opciones de configuración disponibles.
- Instalar en Docker — Pasos de instalación específicos del contenedor.
- Actualizar el agente de Node.js —Cómo actualizar a una versión más reciente.