Débogage de l'agent .NET dans Azure Web Apps

Problème

Après avoir installé l'agent .NET de New Relic pour Azure, vous rencontrez un ou plusieurs des problèmes suivants :

• Vous ne voyez aucune donnée.
• Vous remarquez que le nom de l'application apparaît dans New Relic, mais il manque des données.

Solution

Choses importantes à vérifier et à comprendre :

• Assurez-vous que les étapes d'installation et d'exécution ont été suivies, y compris le redémarrage de votre application Web.
• Vous must désactivez Application Insights pour que l'agent .NET fonctionne correctement.
• L'application must reçoit du trafic pour le démarrage de l'agent .NET.
• À partir de la version 8.22.181.0 de l'agent .NET, Le paramètre Always On d’Azure peut être activé sans interférer avec l’agent. Si votre application cible .NET Framework 4.0 ou une version antérieure, Always On interférera avec l'agent et les solutions de contournement ici sont toujours applicables.

Étape 1 : vérifier le log agent de l'application

Conseils importants lors de la vérification du log :

• Lorsque New Relic Azure vous utilisez l’extension de site , en supposant que votre Azure application Web utilise une D: racine système de fichiers,log l’emplacement par défaut D:\home\LogFiles\NewRelic est. Si votre site Web Azure utilise une racine C: , vous devrez utiliser la lettre de lecteur correcte.
• Si vous avez installé l'agent avec le package NuGet NewRelic.Agent ou NewRelic.Azure.WebSites , vous trouverez le dossier logs dans le répertoire où l'agent a été extrait dans votre projet. Il s’agit souvent du dossier newrelic dans le dossier wwwroot .

Pour vérifier le log agent :

1. Assurez-vous de consulter les données actuelles. Supprimez ou déplacez tous les fichiers existants dans le répertoire du log afin d'être sûr que le log que vous générez reflète l'état actuel de votre système.
2. Redémarrez votre application.
3. Exercez votre application pendant au moins quelques minutes d'une manière qui générerait le trafic que vous vous attendez à voir sur votre compte New Relic.
4. Notez l'ID de processus (PID) sous lequel votre application s'exécute, afin de pouvoir vérifier si un log est créé pour ce processus. Vous pouvez trouver le PID en utilisant le Process Explorer intégré de Kudu.
5. Revenez au répertoire du log de agent et recherchez un fichier de log avec un nom contenant l'ID de processus de votre application, par exemple, NewRelic.Profiler.[PID].log.
6. Si vous voyez ce fichier de du profileur log dans le répertoire des logs, vérifiez également s'il existe un agent log correspondant. Le agent log contient le newrelic_agent préfixe. Si vous exécutez plusieurs applications .NET sur votre hôte, il peut y en avoir plusieurs. Si vous en voyez un ou plusieurs, vous devez déterminer celui qui correspond à l'application que vous essayez de monitorer.
7. Recherchez dans le agent log la (pid [your PID]) chaîne, par (pid 1573) exemple. Si vous trouvez cette chaîne dans le fichier de log, vous savez agent log alors application qu'il s'agit du associé à votre .
8. Recherchez les erreurs réseau ou autres qui pourraient empêcher l'agent d'envoyer des données à New Relic.

Étape 2 : Vérifiez si le profileur d'agent .NET est chargé dans le processus de l'application

Pour vérifier si le profileur est chargé :

1. Utilisez l'explorateur de processus intégré de Kudu pour les installations Windows. Pour les installations Linux, reportez-vous aux commandes de cet article.
2. Dans Process Explorer, recherchez le processus que vous essayez de monitorer et notez le numéro dans la colonne PID. Si vous essayez de monitorer une application Web, le nom du processus sera probablement w3wp.exe sans l'étiquette SCM, qui fait référence au processus Kudu lui-même. L'agent ne doit pas instrumenter le processus SCM (Kudu).
3. Lorsque vous avez localisé le processus de votre application, cliquez sur le bouton Properties.
4. Cliquez sur l'onglet Modules et recherchez NewRelic.Profiler.dll — cette DLL est requise pour que l'agent monitore votre application. Si vous ne le trouvez pas, assurez-vous que les variables d’environnement correctes sont présentes (plus d’informations à ce sujet à l’étape 3) et que Microsoft Application Insights est désactivé.

Si vous ne voyez pas NewRelic.Profiler.dll, passez à l’étape suivante. Si vous voyez cette DLL et que l’application reçoit du trafic, vous devriez voir le log comme décrit à l’étape 1.

Étape 3 : vérifier les variables d’environnement requises

Pour vérifier les variables d’environnement requises :

1. Dans Process Explorer, localisez le processus de votre application et cliquez sur le bouton Properties .
2. Sélectionnez l’onglet Environment .

Si les variables correctes sont définies et que l'application que vous essayez de monitorer y a accès, vous devriez voir un ensemble particulier de variables d'environnement, selon que l'agent que vous avez installé est .NET Framework ou .NET Core.

COR_ENABLE_PROFILING = 1
COR_PROFILER = {71DA0A04-7777-4EC6-9643-7D28B46A8A41}
COR_PROFILER_PATH = D:\home\NewRelicAgent\Framework\NewRelic.Profiler.dll
COR_PROFILER_PATH_32 = D:\home\NewRelicAgent\Framework\x86\NewRelic.Profiler.dll
COR_PROFILER_PATH_64 = D:\home\NewRelicAgent\Framework\NewRelic.Profiler.dll
NEWRELIC_HOME = D:\home\NewRelicAgent\Framework
NEW_RELIC_LICENSE_KEY = YOUR_LICENSE_KEY
NEW_RELIC_APP_NAME = YOUR_APP_NAME

COR_ENABLE_PROFILING = 1
COR_PROFILER = {71DA0A04-7777-4EC6-9643-7D28B46A8A41}
COR_PROFILER_PATH = D:\Home\site\wwwroot\newrelic\NewRelic.Profiler.dll
NEWRELIC_HOME = D:\Home\site\wwwroot\newrelic
NEW_RELIC_LICENSE_KEY = YOUR_LICENSE_KEY
NEW_RELIC_APP_NAME = YOUR_APP_NAME

CORECLR_ENABLE_PROFILING = 1
CORECLR_PROFILER = {36032161-FFC0-4B61-B559-F6C5D41BAE5A}
CORECLR_NEWRELIC_HOME = D:\home\NewRelicAgent\Core
CORECLR_PROFILER_PATH_32 = D:\home\NewRelicAgent\Core\x86\NewRelic.Profiler.dll
CORECLR_PROFILER_PATH_64 = D:\home\NewRelicAgent\Core\NewRelic.Profiler.dll
NEW_RELIC_LICENSE_KEY = YOUR_LICENSE_KEY
NEW_RELIC_APP_NAME = YOUR_APP_NAME

CORECLR_ENABLE_PROFILING = 1
CORECLR_PROFILER = {36032161-FFC0-4B61-B559-F6C5D41BAE5A}
CORECLR_PROFILER_PATH_32 = D:\Home\site\wwwroot\newrelic\x86\NewRelic.Profiler.dll
CORECLR_PROFILER_PATH_64 = D:\Home\site\wwwroot\newrelic\NewRelic.Profiler.dll
CORECLR_NEWRELIC_HOME = D:\Home\site\wwwroot\newrelic
NEW_RELIC_LICENSE_KEY = YOUR_LICENSE_KEY
NEW_RELIC_APP_NAME = YOUR_APP_NAME

<log directory="D:\Home\LogFiles\NewRelic" level="info"></log>

CORECLR_ENABLE_PROFILING = 1
CORECLR_PROFILER = {36032161-FFC0-4B61-B559-F6C5D41BAE5A}
CORECLR_PROFILER_PATH = /home/site/wwwroot/newrelic/libNewRelicProfiler.so
CORECLR_NEWRELIC_HOME = /home/site/wwwroot/newrelic
NEW_RELIC_LICENSE_KEY = YOUR_LICENSE_KEY
NEW_RELIC_APP_NAME = YOUR_APP_NAME

<log directory="/home/LogFiles/NewRelic" level="info"></log>

Pour en savoir plus sur ces variables d’environnement et leurs fonctionnalités, consultez comment comprendre les variables d’environnement de l’agent .NET.

Si le nom application apparaît dans New Relic, mais qu'aucune transaction n'apparaît, c'est probablement parce qu'aucun trafic ne touche l'application ou que l'agent ne rencontre pas de framework connu qu'il peut automatiquement instrument:

• Pour le framework instrumenté automatiquement pour .NET Core et .NET framework, reportez-vous à notre page de compatibilité.
• Si votre application n'utilise pas l'un de ces frameworks d'application compatibles, vous devrez peut-être implémenter instrumentation personnalisée pour indiquer à l'agent quelles parties de votre application sont importantes pour monitoring et ce qui constitue la portée d'une transaction.

Si les étapes ci-dessus ne vous ont pas aidé à résoudre vos problèmes, nous vous recommandons de contacter le support ou de demander de l'aide sur notre forum d'assistance.