Azure App Services Recherche d'.NET

Pour activer l'instrumentation pour les versions.NET Framework,.NET Core et.NET d'App Services sur Windows, vous devez disposer d'un agent Instana en cours d'exécution dans l'environnement où vous souhaitez surveiller les services App Services.

Pour plus d'informations sur la configuration de l'agent Instana pour la surveillance d' Azure, consultez la section « Surveillance et instrumentation d' Microsoft Azure ».

Pour configurer des charges de travail d' Windows, procédez comme suit :

1. Dans le portail 'Microsoft Azure, recherchez le 'App Service.Net que vous souhaitez instrumenter.

2. Ouvrez le .Net 'App Service dans le portail 'Azure

3. Dans le menu de navigation, cliquez sur Extensions. Dans la page Extensions, vous pouvez ajouter une nouvelle extension, vérifier les extensions installées et mettre à jour ou supprimer une extension.

   

4. Installez l 'extension « Tracing App Service » d' Instana. Après l'installation, vous devez configurer l'extension avant de l'utiliser.

5. Go vers la page Extensions.

6. Cliquez sur l'icône « URL » de l'extension « Instana Tracing App Service » dans la liste des extensions installées. La fenêtre « Instana : Tracing for AppServices » s'affiche; vous pouvez y configurer l'extension Instana.

   

7. Effectuez les configurations suivantes :

   1. Pour activer la fonctionnalité de traçage d' Instana, réglez le paramètre « Activer le traçage » sur « Activé ».

   2. Pour sélectionner 32 bits pour votre application App Services, réglez l'option Activer 64 bits sur Désactivé. Pour sélectionner 64 bits pour votre application App Services, réglez Enable 64 bit sur On. Pour plus d'informations, voir Bruit de la demande.

   3. Dans le champ « Clé de l'agent », saisissez la clé de licence de votre agent hôte d' Instana.

   4. Dans le champ URL du point de terminaison, saisissez l' URL du point de terminaison pour la surveillance sans serveur.

      Remarque : pour une installation auto-hébergée, saisissez le point de terminaison au https://<IP address of the Instana backend>/serverless format et définissez le INSTANA_DISABLE_CA_CHECK paramètre sur true ou 1.

   5. Dans le champ Niveau de journ alisation, entrez le niveau de journalisation que vous souhaitez utiliser. Les valeurs que vous pouvez saisir sont " NONE, " DEBUG, " INFO, " WARN et " ERROR.

      Les informations du journal sont générées dans le dossier racine de l'application App Service

8. Après avoir saisi toutes les informations, cliquez sur Mettre à jour la configuration. Les informations sont enregistrées dans le contexte de l'App Service

9. Dans le tableau de bord de l'App Service, redémarrez l'App Service. Lorsque vous lancez votre application, un module de réécriture « Instana » est associé à celle-ci, et Instana commence à collecter les traces.

Pour afficher les traces dans l'interface utilisateur d' Instana, procédez comme suit :

1. Dans l'interface utilisateur d' Instana, ouvrez le tableau de bord de votre entité « App Service ».

2. Cliquez sur Amont / Aval. Les traces collectées pour cette entité sont affichées.

   

Pour activer l'instrumentation des applications.NET Core et.NET exécutées sur des services d'applications basés sur l' Linux, vous devez disposer d'un agent Instana en cours d'exécution dans l'environnement où vous souhaitez surveiller l' App Service. Pour plus d'informations sur la configuration de l'agent Instana afin de surveiller Azure, consultez la section « Surveillance et instrumentation de Microsoft Azure ».

Pour capturer des traces, procédez comme suit :

1. Ajoutez le package d' NuGet s de suivi à votre projet : Instana.Tracing.Core.Rewriter.Linux

2. Après avoir ajouté le package NuGet de traçage, redéployez votre application sur Azure App Service

3. Une fois l'application redéployée, le traçage d' Instana s est intégré à votre application. Pour activer le traçage, configurez le moteur CLR comme suit :

   1. Go dans la section « Configuration » de votre tableau de bord Azure App Service.

   2. Ajoutez les variables d'environnement suivantes :

      CORECLR_ENABLE_PROFILING = 1
      CORECLR_PROFILER = {cf0d821e-299b-5307-a3d8-b283c03916dd}
      CORECLR_PROFILER_PATH = /home/site/wwwroot/instana_tracing/CoreProfiler.so
      DOTNET_STARTUP_HOOKS = /home/site/wwwroot/Instana.Tracing.Core.dll
      INSTANA_AGENT_KEY = the license key of your Instana host agent
      INSTANA_ENDPOINT_URL = one of the following [endpoint URL for serverless monitoring](../../../setup_and_manage/endpoints_and_keys.html#endpoints-for-serverless-monitoring)
      

4. Redémarrez votre application. Pour vous assurer que vos modifications sont actives, suivez les étapes suivantes :

   1. arrêter l'application.
   2. Attendez 1 à 2 minutes pour effacer les éventuels états mis en cache.
   3. Redémarrez l'application.

   Vous pouvez désormais consulter les traces dans l'interface utilisateur d' Instana.

Lorsque vous configurez l'instrumentation d' Instana à l'aide de l'extension installée sur Azure, une case à cocher intitulée « Activer le 64 bits » s'affiche. En fonction de la version bit de votre application, vous devez attacher le réécrivain approprié.

Par défaut, lorsque vous déployez l'application via Visual Studio vers Azure App Service, l'application est installée en mode 32 bits. Les paramètres de la version bit peuvent être modifiés dans la configuration de l'App Service en allant dans Configuration > Paramètres généraux:

Si vous utilisez un mode 64 bits, sélectionnez 64 bits dans la configuration de l'extension App Service de traçage Instana. Sinon, vous ne pouvez pas attacher et collecter des traces.

Si le traçage ne fonctionne pas, suivez les étapes suivantes :

1. Vérifiez que la version 32 bits est correctement configurée à la fois dans la configuration App Service et dans la configuration de l'extension App Service de traçage Instana.

2. Assurez-vous que la clé de l'agent et l'adresse de l'endpoint URL sont correctement configurées sur la page « Tracing for App Services » (Suivi pour les services d'applications) de l' Instana. Pour plus d'informations, consultez la section « URL s des points de terminaison » dans la documentation sur la surveillance sans serveur.

3. Vérifiez la présence d'erreurs dans le journal des événements en cliquant sur Diagnostiquer et résoudre les problèmes > Journal des événements de l'application.

   

4. Ouvrez l'Explorateur de processus Kudu en cliquant sur Outils avancés dans le menu de navigation. Vérifiez si le processus 'w3wp est lié au module Instana.Profiler_x64.dll.

   

   

5. Récupérez les journaux de débogage d' Instana s à l'aide de l'outil Kudu. Dans l'outil Kudu, allez dans Debug Console, puis dans le dossier 'C:\home\site\wwwroot>. Vous trouverez deux types de fichiers journaux dans le dossier :

• Journaux de débogage CLR : 1.log_YYYY-MM-DD-HH_MM_SS
• Journaux d'instrumentation : YYYY-MM-DD_HH_MM_SSPID