Méthodes d'installation
Si vous exécutez une application Web et la déployez sous forme de code sur Windows, vous pouvez facilement installer l’ agent Node à l’aide de notre extension de site Azure . []Consultez ces instructions](/docs/agent APM/nodejs-agent/installation-configuration/install-nodejs-azure-site-extension).
Si vous lancez une application conteneur, vous pouvez suivre nos instructions pour Docker.
Vous devez installer l’agent manuellement pour les applications Web hébergées sous Linux, ce que nous décrivons ci-dessous.
Installation manuelle
Découvrez les considérations spéciales relatives à l’utilisation de Microsoft Azure App Services en tant que service d’hébergement avec l’agent Node.js de New Relic.
Ce dont vous avez besoin
En plus de la compatibilité et des exigences pour l'agent Node.js, ce tutoriel suppose que vous disposez d'une installation fonctionnelle de Node.js et du SDK Azure pour js pour votre plateforme :
- Installez le SDK Azure pour js.
- Assurez-vous que Git est installé.
Important
L’agent Node.js ne peut pas fournir de télémétrie pour Azure Functions. Au lieu de cela, vous devrez utiliser l’ intégration du monitoring Azure Functions
Installation de l'agent Node.js
Pour ajouter l'agent New Relic Node.js à votre application Azure, assurez-vous que le module newrelic est chargé en premier, utilisez l'indicateur Node.js -r/--require pour exécuter ce qui suit :
$node -r newrelic server.jsImportant
Pour une application Next.js, chargez notre agent via NODE_OPTIONS, comme suit :
$NODE_OPTIONS='-r newrelic' next startAjout de paramètres d’application dans Azure
Après l’installation, vous devez configurer votre application dans Azure App Services :
Connectez-vous à portal.azure.com.
Sélectionnez App Services > (select a Node.js app) > Configure.
Ajoutez ce qui suit au app settings:
new_relic_app_name: Le nom de votre Azure App Servicesnew_relic_license_key: Votre New Relic
Enregistrez vos paramètres.
Redémarrez votre application Node.js.
Générez du trafic vers votre application et attendez quelques minutes. Après avoir attendu, visualisez vos données en allant sur one.newrelic.com > All capabilities > APM & services > (select your app).
Facultatif : ajout de paramètres d'application avec la CLI
Facultatif : voici un exemple de la manière d’ajouter les paramètres de l’application à l’aide de la CLI (SDK 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_NAMEUtilisation des variables d'environnement
Si votre agent s’exécute dans des environnements PaaS tels que Heroku ou Azure App Services, toutes les variables de configuration dans newrelic.js ont des équivalents qui peuvent être définis comme variables d’environnement. Vous pouvez mélanger et assortir librement les variables dans le fichier de configuration. Les variables d’environnement remplacent les paramètres de votre fichier de configuration.
Par exemple, pour plus de commodité pour l’utilisateur Azure, l’ agent utilisera APP_POOL_ID comme nom application (NEW_RELIC_APP_NAME) s’il est défini, afin que vous puissiez utiliser le nom que vous avez choisi sans le définir deux fois. Pour plus d'informations, consultez Configuration de Node.js avec des variables d'environnement.