Activer Profiler .NET pour les applications web sur une machine virtuelle Azure

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.

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

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.

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 pour .NET, vous pouvez utiliser Azure Resource Explorer pour le faire.

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 pour .NET 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.