Conozca las consideraciones especiales para usar Microsoft Azure Web Apps como servicio de hospedaje con el agente Node.js de New Relic.
Que necesitas
Además de la compatibilidad y los requisitos para el agente de Node.js, este tutorial asume que tiene una instalación funcional de Node.js y el SDK de Windows Azure para Node.js para su plataforma:
- Instale el SDK de Azure para Node.js.
- Asegúrese de que Git esté instalado.
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
Para agregar el agente New Relic Node.js a su aplicación de Azure, asegúrese de que el módulo newrelic
esté cargado primero, use el indicador Node.js -r
/--require
para ejecutar lo siguiente:
$node -r newrelic server.js
Importante
Para una aplicación Next.js, utilice nuestro agente@newrelic/next
independiente en lugar del agente newrelic
, por ejemplo:
$node -r @newrelic/next server.js
Agregar configuraciones de aplicaciones en Azure
Después de la instalación, debe configurar su aplicación en Azure Web Apps:
Inicia sesión en portal.azure.com.
Seleccione App Services > (select a Node.js app) > Configure.
Agregue lo siguiente al app settings:
new_relic_app_name
: el nombre de su sitio web de Windows Azurenew_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_WEB_APP_NAME
Usando variables de entorno
Si su agente se ejecuta en entornos PaaS como Heroku o Azure Web Apps, todas las variables de configuración en newrelic.js
tienen contrapartes que se pueden configurar como variables de entorno. Puede mezclar y combinar libremente variables en el archivo de configuración. Las variables de entorno anulan la configuración 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.