Learn about special considerations for using Microsoft Azure Web Apps as a hosting service with New Relic's Node.js agent.
In addition to the Compatibility and requirements for the Node.js agent, this tutorial assumes you have a working installation of Node.js and the Windows Azure SDK for Node.js for your platform:
- Install the Azure SDK for Node.js.
- Ensure Git is installed.
The Node.js agent cannot deliver telemetry for Azure Functions. Instead, you will need to use the Azure Functions monitoring integration
To add the New Relic Node.js agent to your Azure application make sure the
newrelic module is loaded first, use the Node.js
--require flag to run the following:
$node -r newrelic server.js
For a Next.js app use our standalone
@newrelic/next agent instead of the
newrelic agent, for example:
$node -r @newrelic/next server.js
After installation, you must configure your app in Azure Web Apps:
Sign in to portal.azure.com.
Select App Services > (select a Node.js app) > Configure.
Add the following to the app settings:
new_relic_app_name: Your Windows Azure website name
new_relic_license_key: Your New Relic
Save your settings.
Restart your Node.js app.
Generate some traffic to your app and wait a few minutes. After waiting, see your data by going to one.newrelic.com > All capabilities > APM & services > (select your app).
Optional: Here is an example of how to add the app settings by using the CLI (Node.js SDK):
$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
If your agent runs in PaaS environments such as Heroku or Azure Web Apps, all of the configuration variables in
newrelic.js have counterparts that can be set as environment variables. You can freely mix and match variables in the configuration file. Environment variables override your configuration file settings.
For example, as a convenience to Azure users, the agent will use
APP_POOL_ID as the application name (
NEW_RELIC_APP_NAME) if it's set, so you can use the name you chose without setting it twice. For more information, see Configuring Node.js with environment variables.