Activer Profiler pour les applications web sur une machine virtuelle Azure

Notes

Nous vous recommandons d’utiliser le module Azure Az PowerShell pour interagir avec Azure. Pour commencer, consultez Installer Azure PowerShell. Pour savoir comment migrer vers le module Az PowerShell, consultez Migrer Azure PowerShell depuis AzureRM vers Az.

Dans cet article, vous apprendrez à exécuter Application Insights Profiler sur votre machine virtuelle (VM) Azure ou votre groupe de machines virtuelles identiques Azure via trois méthodes différentes :

• Visual Studio et Azure Resource Manager
• PowerShell
• Azure Resource Explorer

À l’aide de l’une de ces méthodes, vous allez :

• Configurer l'extension Diagnostics Azure pour exécuter Profiler.
• Installer le kit de développement logiciel (SDK) Application Insights sur la machine virtuelle.
• Déployez votre application.
• Afficher les traces de Profiler via l’instance Application Insights dans le portail Azure.

Prérequis

• Application ASP.NET Core fonctionnelle.
• Ressource Application Insights.
• Pour passez en revue les modèles Azure Resource Manager (modèles ARM) pour l’extension Diagnostics Azure :
  • Machine virtuelle
  • Groupe de machines virtuelles identiques

Ajoutez le kit Application Insights SDK à votre application

1. Ouvrez votre projet ASP.NET Core dans Visual Studio.

2. Sélectionnez ProjetAjouter Application Insights Telemetry.

3. Sélectionnez Azure Application Insights>Suivant.

4. Sélectionnez l’abonnement dans lequel se trouve votre ressource Application Insights, puis sélectionnez Suivant.

5. Sélectionnez l’emplacement où enregistrer la chaîne de connexion, puis sélectionnez Suivant.

6. Sélectionnez Terminer.

Notes

Pour obtenir des instructions complètes, notamment sur comment activer l’Application Insights sur votre application ASP.NET Core sans Visual Studio, consultez Application Insights pour les ASP.NET Core.

Vérifier la dernière version stable du kit de développement logiciel (SDK) Application Insights

1. Accédez à Projet>Gérer les packages NuGet.

2. Sélectionnez Microsoft.ApplicationInsights.AspNetCore.

3. Dans le volet latéral, sélectionnez la dernière version du kit de développement logiciel (SDK) dans la liste déroulante.

4. Sélectionnez Mettre à jour.

   

Activer Profiler

Vous pouvez activer Profiler de l’une des trois façons :

• Dans votre application ASP.NET Core à l’aide d’un modèle Azure Resource Manager et de Visual Studio. Recommandé.
• À l’aide d’une commande PowerShell via Azure CLI.
• À l’aide de Azure Resource Explorer.

Visual Studio et modèle ARM

Installer l’extension Diagnostics Azure

1. Choisissez le modèle ARM à utiliser :

   • Machine virtuelle
   • Groupe de machines virtuelles identiques

2. Dans le modèle, recherchez la ressource de type extension.

3. Dans Visual Studio, allez au fichier arm.json de votre application ASP.NET Core ajouté lorsque vous avez installé le kit de développement logiciel (SDK) Application Insights.

4. Ajoutez le type de ressource extension du modèle au fichier arm.json pour configurer une machine virtuelle ou un groupe de machines virtuelles identiques avec Diagnostics Azure.

5. Dans la balise WadCfg, ajoutez votre clé d’instrumentation Application Insights à MyApplicationInsightsProfilerSink.

   "WadCfg": {
     "SinksConfig": {
       "Sink": [
         {
           "name": "MyApplicationInsightsProfilerSink",
           "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
         }
       ]
     }
   }        
   

6. Déployez votre application.

PowerShell

Les commandes PowerShell suivantes offrent une approche pour les machines virtuelles existantes, qui touchent uniquement l’extension Diagnostics Azure.

Notes

Si vous redéployez la machine virtuelle, le récepteur sera perdu. Vous devez mettre à jour la configuration que vous utilisez lorsque vous déployez la machine virtuelle pour conserver ce paramètre.

Installer Application Insights via la configuration Diagnostics Azure

1. Exportez la configuration Diagnostics Azure actuellement déployée dans un fichier :

   $ConfigFilePath = [IO.Path]::GetTempFileName()
   

2. Ajoutez le récepteur Application Insights Profiler à la configuration retournée par la commande suivante :

   (Get-AzVMDiagnosticsExtension -ResourceGroupName "YOUR_RESOURCE_GROUP" -VMName "YOUR_VM").PublicSettings | Out-File -Verbose $ConfigFilePath
   

   Application Insights Profiler WadCfg :

   "WadCfg": {
     "SinksConfig": {
       "Sink": [
         {
           "name": "MyApplicationInsightsProfilerSink",
           "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
         }
       ]
     }
   }        
   

3. Exécutez la commande suivante pour transmettre la configuration mise à jour à la commande Set-AzVMDiagnosticsExtension.

   Set-AzVMDiagnosticsExtension -ResourceGroupName "YOUR_RESOURCE_GROUP" -VMName "YOUR_VM" -DiagnosticsConfigurationPath $ConfigFilePath
   

   Notes

   Set-AzVMDiagnosticsExtension peut nécessiter l’argument -StorageAccountName. Si votre configuration de diagnostics d’origine avait la propriété storageAccountName dans la section protectedSettings (qui n’est pas téléchargeable), veillez à transmettre la même valeur d’origine que celle que vous aviez dans cet appel de cmdlet.

Fonctionnalité de suivi HTTP IIS

Si l’application souhaitée s’exécute avec IIS, activez la fonctionnalité Windows IIS Http Tracing :

1. Établissez un accès à distance à l’environnement.

2. Utilisez la fenêtre Ajouter des fonctionnalités Windows ou exécutez la commande suivante dans PowerShell (en tant qu’administrateur) :

   Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All
   

   Si l’établissement de l’accès à distance est un problème, vous pouvez utiliser Azure CLI pour exécuter la commande suivante :

   az vm run-command invoke -g MyResourceGroupName -n MyVirtualMachineName --command-id RunPowerShellScript --scripts "Enable-WindowsOptionalFeature -FeatureName IIS-HttpTracing -Online -All"
   

3. Déployez votre application.

Azure Resource Explorer

Définir le récepteur du profileur en utilisant Azure Resource Explorer

Le portail Azure ne permettant pas de définir le récepteur Application Insights Profiler, vous pouvez utiliser Azure Resource Explorer pour le faire.

Notes

Si vous redéployez la machine virtuelle, le récepteur sera perdu. Vous devez mettre à jour la configuration que vous utilisez lorsque vous déployez la machine virtuelle pour conserver ce paramètre.

1. Vérifiez que l’extension Microsoft Diagnostics Azure pour Windows est installée en consultant les extensions installées dans votre machine virtuelle.

   

2. Recherchez l’extension VM Diagnostics pour votre machine virtuelle :

   1. Allez dans Azure Resource Explorer.

   2. Développez les abonnements et recherchez l’abonnement contenant le groupe de ressources avec votre machine virtuelle.

   3. Descendez dans la hiérarchie des extensions de votre machine virtuelle en sélectionnant votre groupe de ressources. Sélectionnez ensuite Microsoft.Compute>virtualMachines>[votre machine virtuelle]>extensions.

      

3. Ajoutez le récepteur Application Insights Profiler au nœud SinksConfig sous WadCfg. Si vous ne disposez pas de section SinksConfig, vous devrez peut-être en ajouter une. Pour ajouter le récepteur :

   • Spécifiez l’iKey Application Insights qui convient dans vos paramètres.

   • Basculez le mode de l’explorateur sur Lecture/Écriture dans le coin supérieur droit.

   • Sélectionnez Modifier.

     

     "WadCfg": {
       "SinksConfig": {
         "Sink": [
           {
             "name": "MyApplicationInsightsProfilerSink",
             "ApplicationInsightsProfiler": "YOUR_APPLICATION_INSIGHTS_INSTRUMENTATION_KEY"
           }
         ]
       }
     }        
     

4. Une fois que vous avez terminé de modifier la configuration, sélectionnez PUT.

5. Si cette opération put réussit, une coche verte s’affiche au milieu de l’écran.

   

Profiler peut-il être exécuté sur des serveurs locaux ?

Actuellement, Application Insights Profiler n’est pas pris en charge pour les serveurs locaux.

Étapes suivantes

Générer de la charge et afficher les traces de Profiler