Cette page couvre l’installation de l’agent Java New Relic sur Azure App Service pour Windows à l’aide de l’extension de site New Relic Java Agent. L’extension injecte l’agent automatiquement sans modifier le script de démarrage de votre application.
Compatibilité et exigences
Soutenu
- Applications Java s’exécutant sur Azure Windows App Service
- Versions de l’agent Java New Relic compatibles avec Java 8 et supérieur (Java 7 pris en charge sur l’agent v6.5.4 et versions antérieures uniquement)
- Consultez la compatibilité et les exigences pour les plages de versions de framework et de bibliothèque prises en charge
Non pris en charge
- Conteneurs Linux sur Azure : utilisez la méthode d'installation Docker, et passez
-javaagentviaJAVA_TOOL_OPTIONS - Exécution aux côtés d’autres agents APM : l’agent Java ne peut pas garantir un comportement correct lorsqu’un autre agent APM est actif dans la même JVM
Vous avez besoin de
- Un compte New Relic et
- Une JVM avec prise en charge de SSL SHA-2 (256 bits)
- Une application Java s'exécutant sur Azure Windows App Service
- L'application cible doit être arrêtée avant d'installer l'extension pour éviter une instrumentation partielle
Installation
Installez l’extension de site
Depuis la page d’accueil Azure, sélectionnez App Services, puis sélectionnez votre application cible.
Dans le menu de gauche, faites défiler jusqu'à Development Tools, et sélectionnez Extensions.
Sélectionnez + Add en haut de la page pour ouvrir la liste déroulante de l’extension.
Sélectionnez New Relic Java Agent.
Acceptez les conditions légales et sélectionnez OK pour commencer l’installation.
Une fois installée, l’extension crée :
Fichiers de l’agent à
C:\home\NewRelic\JavaAgent\newrelic\(fichiers jar, configuration, sources)Transformation XDT (
applicationHost.xdt) qui injecte automatiquement la variable d’environnementJAVA_TOOL_OPTIONSau démarrage de l’applicationSi l’installation de l’extension échoue, vérifiez le log à l’adresse
C:\home\SiteExtensions\NewRelic.Azure.WebSites.Extension.JavaAgent\install.log.
Configurer l'agent
Dans le menu de gauche de votre application, accédez à Settings > Configuration.
Ajoutez les paramètres d’application suivants :
Paramètre Valeur NEW_RELIC_LICENSE_KEYVotre clé de licence New Relic NEW_RELIC_APP_NAMELe nom qui apparaît dans la plateforme New Relic Vous pouvez également ajouter des paramètres de configuration supplémentaires en tant que paramètres d'application pour personnaliser davantage l'agent.
Vérifiez votre installation
Démarrer votre application. Envoyez au moins deux requests, puis attendez 2 - 3 minutes, et votre application apparaît dans APM & services.
Si aucune donnée n’apparaît après cinq minutes, consultez Aucune donnée n’apparaît (Java).