Installez l'agent Node.js avec notre extension de site Azure

Vous pouvez installer l’agent Node.js sur vos applications Web gérées par Azure avec l’extension de site Azure New Relic pour Node. Ce document vous guide à travers la compatibilité, l’installation et la configuration pour intégrer les données de votre application Web Azure dans New Relic.

Compatibilité et exigences

Les extensions de site Azure sont uniquement disponibles pour les applications App Service basées sur Windows qui sont déployées sous forme de code. Pour les applications exécutées sous Windows 32, la prise en charge complète des métriques au niveau du code (chemin de fichier, ligne, colonne) n'est pas disponible. Le profilage revient uniquement au nom de la fonction.

Installer l'agent Node.js avec l'extension de site Azure

Pour installer l’extension de site Azure New Relic, ajoutez l’extension de site NewRelic.Azure.WebSites.Extension.NodeAgent à partir de la page d’accueil Azure. Suivez ces étapes :

1. Depuis la page d’accueil Azure, cliquez sur la vignette App Services, puis sélectionnez l’application cible dans la liste affichée.
2. Faites défiler jusqu'à Extensions dans les options répertoriées sur la gauche sous la catégorie Development Tools .
3. Cliquez sur + Add en haut de la page pour basculer la liste déroulante des extensions, puis sélectionnez New Relic Node Agent. Cochez la case pour accepter les conditions légales
4. Cliquez sur Add en bas de la page pour commencer l'installation de l'extension.

Une fois installée, l'extension crée les artefacts suivants :

• Dossier: C:\home\SiteExtensions\NewRelic.Azure.Websites.Extension.NodeAgent
• Transformation de document XML (XDT) : applicationHost.xdt qui ajoutera la variable d'environnement NODE_OPTIONS nécessaire au démarrage de l'application
• L' et la New Relic dépendance du nœud agent seront installés dans C:\home\site\wwwroot\node_modules

Après une installation réussie de l' agent avec le logging activée, l' agent ajoutera son log à un fichier à l'adresse C:\home\site\wwwroot\newrelic_agent.log. Si l'installation de l'extension échoue, un fichier de log est créé à l'adresse C:\home\SiteExtensions\NewRelic.Azure.Websites.Extension.NodeAgent\install.log.

Configurer l'agent Node.js

L'agent Node.js est configuré avec le fichier newrelic.js ou via des variables d'environnement. Consultez notre documentation pour une configuration plus détaillée.

Une fois l'extension de site installée, vous devrez saisir manuellement un élément de configuration avant de redémarrer votre application. Dans les options répertoriées sur la gauche, recherchez Settings et faites défiler jusqu'à Environment variables. Ajoutez la variable NEW_RELIC_LICENSE_KEY avec la valeur de votre clé de licence.

Notre extension de site ajoute automatiquement la variable d'environnement NODE_OPTIONS avec une valeur de -r newrelic. Cela injecte l'agent au démarrage du nœud. Tout NODE_OPTIONS précédemment défini sera supprimé et réinitialisé avec -r newrelic.