• /
  • EnglishEspañolFrançais日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Instalar el agente Node.js

|View as Markdown (English)

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:

bash
$
npm install newrelic

Importante

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:

bash
$
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:

  1. Establezca license_key en su .
  2. Establezca app_name como 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:

bash
$
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:

bash
$
node -r newrelic ./your-app.js

Si la aplicación utiliza ESM, agregue la opción --import newrelic/esm-loader.mjs:

bash
$
node --import newrelic/esm-loader.mjs -r newrelic ./your-app.js

Para 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:

bash
$
npx newrelic validate-config --config-file ./newrelic.js
  1. Envíe al menos dos requests a la aplicación.

  2. 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.

Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.