Métodos de instalación
Si ejecuta una aplicación web y la despliega como código en Windows, puede instalar fácilmente el agente de Node mediante la Azure Site Extension. Consulte estas instrucciones.
Si despliega una aplicación de contenedor, puede seguir las instrucciones para Docker.
Debe instalar el agente manualmente para las aplicaciones web alojadas en Linux, lo cual describimos a continuación.
Manual de instalación
Conozca las consideraciones especiales para usar Microsoft Azure App Services como servicio de alojamiento con el agente de Node.js de New Relic.
Que necesitas
In addition to the Compatibility and requirements for the Node.js agent, this tutorial assumes the following:
- You have a working installation of Node.js.
- You have the Azure SDK for JavaScript for your platform.
- A deployed application in Azure.
Importante
El agente de Node.js no puede entregar telemetría para Azure Functions. En su lugar, deberá utilizar la integración de monitoreo de Azure Functions
Instalación del agente Node.js
To add the New Relic Node.js agent to your Azure application, add the newrelic module to the application's dependencies:
$npm install newrelicThe newrelic module must be loaded first in order for the agent to work correctly. This is accomplished by using the Node.js -r flag to run the app:
$node -r newrelic server.jsImportante
Para una aplicación ESM, debe especificar tanto el cargador ESM como el agente de Node.js de New Relic:
$node --import newrelic/esm-loader.mjs -r newrelic server.jsImportante
Para una aplicación de Next.js, cargue el agente a través de NODE_OPTIONS, como:
$NODE_OPTIONS='-r newrelic' next startAgregar configuraciones de aplicaciones en Azure
Después de la instalación, debe configurar la aplicación en Azure App Services:
Inicia sesión en portal.azure.com.
Seleccione App Services > (select your deployed Node.js app) > Configure.
Agregue lo siguiente al app settings:
new_relic_app_name: nombre de Azure App Servicesnew_relic_license_key: Tu New Relic
Guarde su configuración.
Reinicie su aplicación Node.js.
Genera algo de tráfico a tu aplicación y espera unos minutos. Después de esperar, consulta tus datos yendo a one.newrelic.com > All capabilities > APM & services > (select your app).
Opcional: agregar configuraciones de aplicaciones con la CLI
Opcional: A continuación se muestra un ejemplo de cómo agregar la configuración de la aplicación mediante la CLI (SDK de Node.js):
$azure account download "YOUR_SUBSCRIPTION_NAME"$azure account import "PATH_TO_PUBLISH_SETTINGS_FILE"$azure site config add "new_relic_app_name=REPLACE_WITH_YOUR_APP_NAME"$azure site config add "new_relic_license_key=REPLACE_WITH_YOUR_LICENSE_KEY"$azure site restart AZURE_APP_SERVICES_NAMEUsando variables de entorno
Si el agente se ejecuta en entornos PaaS como Heroku o Azure App Services, todas las variables de configuración en newrelic.js tienen equivalentes que se pueden establecer como variables de entorno. Puede mezclar y combinar libremente las variables en el archivo de configuración. Las variables de entorno anulan los ajustes del archivo de configuración.
Por ejemplo, para comodidad del usuario de Azure, el agente usará APP_POOL_ID como nombre de la aplicación (NEW_RELIC_APP_NAME) si está configurado, de modo que pueda usar el nombre que eligió sin configurarlo dos veces. Para obtener más información, consulte Configuración de Node.js con variables de entorno.