Habilitar o .NET Profiler para aplicativos Web em uma máquina virtual do Azure

Nota

Recomendamos que utilize o módulo Azure Az do PowerShell para interagir com o Azure. Para começar, consulte Instalar o Azure PowerShell. Para saber como migrar para o módulo do Az PowerShell, veja Migrar o Azure PowerShell do AzureRM para o Az.

Neste artigo, você aprenderá a executar o Application Insights Profiler para .NET em sua máquina virtual (VM) do Azure ou no conjunto de dimensionamento de máquina virtual do Azure por meio de três métodos diferentes:

• Visual Studio e Azure Resource Manager
• PowerShell
• Explorador de Recursos do Azure

Selecione a guia do seu método preferido para:

Neste guia, ficará a saber como:

• Configure a extensão de Diagnóstico do Azure para executar o .NET Profiler.
• Instale o SDK do Application Insights em uma VM.
• Implante seu aplicativo.
• Exiba rastreamentos do Profiler por meio da instância do Application Insights no portal do Azure.

Pré-requisitos

• Um aplicativo ASP.NET Core funcional.
• Um recurso do Application Insights.
• Para rever os modelos do Azure Resource Manager (modelos ARM) para a extensão de Diagnóstico do Azure:
  • VM
  • Conjunto de dimensionamento de máquina virtual

Adicionar o SDK do Application Insights ao seu aplicativo

1. Abra seu projeto principal do ASP.NET no Visual Studio.

2. Selecione Project>Add Application Insights Telemetry.

3. Selecione Azure Application Insights>Next.

4. Selecione a assinatura onde seu recurso do Application Insights reside e selecione Avançar.

5. Selecione onde salvar a cadeia de conexão e selecione Avançar.

6. Selecione Concluir.

Nota

Para obter instruções completas, incluindo como habilitar o Application Insights em seu aplicativo ASP.NET Core sem o Visual Studio, consulte o Application Insights for ASP.NET Core applications.

Confirme a versão estável mais recente do SDK do Application Insights

1. Vá para Project>Manage NuGet Packages.

2. Selecione Microsoft.ApplicationInsights.AspNetCore.

3. No painel lateral, selecione a versão mais recente do SDK na lista suspensa.

4. Selecione Atualizar.

   

Habilitar o .NET Profiler

Você pode habilitar o Profiler de três maneiras:

• Dentro do seu aplicativo ASP.NET Core usando um modelo do Azure Resource Manager e o Visual Studio. Recomendado.
• Usando um comando do PowerShell por meio da CLI do Azure.
• Usando o Azure Resource Explorer.

Modelo Visual Studio e ARM

Instalar a extensão de Diagnóstico do Azure

1. Escolha qual modelo ARM usar:

   • VM
   • Conjunto de dimensionamento de máquina virtual

2. No modelo, localize o recurso do tipo extension.

3. No Visual Studio, vá para o arm.json arquivo em seu aplicativo ASP.NET Core que foi adicionado quando você instalou o SDK do Application Insights.

4. Adicione o tipo extension de recurso do modelo ao arquivo para configurar uma VM ou um conjunto de escala de máquina virtual com o arm.json Diagnóstico do Azure.

5. WadCfg Na tag , adicione sua chave de instrumentação do Application Insights ao MyApplicationInsightsProfilerSink.

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

6. Implante seu aplicativo.

PowerShell

Os comandos do PowerShell a seguir são uma abordagem para VMs existentes que tocam apenas na extensão de Diagnóstico do Azure.

Nota

Se você implantar a VM novamente, o coletor será perdido. Você precisa atualizar a configuração usada ao implantar a VM para preservar essa configuração.

Instalar o Application Insights por meio da configuração do Diagnóstico do Azure

1. Exporte a configuração de Diagnóstico do Azure atualmente implantada para um arquivo:

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

2. Adicione o coletor do Application Insights Profiler à configuração retornada pelo seguinte comando:

   (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. Execute o seguinte comando para passar a configuração atualizada para o Set-AzVMDiagnosticsExtension comando.

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

   Nota

   Set-AzVMDiagnosticsExtension pode exigir o -StorageAccountName argumento. Se sua configuração de diagnóstico original tinha a storageAccountName propriedade na protectedSettings seção (que não pode ser baixada), certifique-se de passar o mesmo valor original que você tinha nesta chamada de cmdlet.

Recurso de rastreamento http do IIS

Se o aplicativo pretendido estiver sendo executado através do IIS, habilite o recurso do IIS Http Tracing Windows:

1. Estabeleça acesso remoto ao ambiente.

2. Use a janela Adicionar recursos do Windows ou execute o seguinte comando no PowerShell (como administrador):

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

   Se estabelecer o acesso remoto for um problema, você poderá usar a CLI do Azure para executar o seguinte comando:

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

3. Implante seu aplicativo.

Explorador de Recursos do Azure

Definir o coletor do Profiler usando o Azure Resource Explorer

Como o portal do Azure não fornece uma maneira de definir o coletor de Perfil do Application Insights para .NET, você pode usar o Gerenciador de Recursos do Azure para definir o coletor.

Nota

Se você implantar a VM novamente, o coletor será perdido. Você precisa atualizar a configuração usada ao implantar a VM para preservar essa configuração.

1. Verifique se a extensão de Diagnóstico do Microsoft Azure está instalada exibindo as extensões instaladas para sua máquina virtual.

   

2. Encontre a extensão VM Diagnostics para sua VM:

   1. Vá para o Azure Resource Explorer.

   2. Expanda assinaturas e localize a assinatura que contém o grupo de recursos com sua VM.

   3. Analise detalhadamente suas extensões de VM selecionando seu grupo de recursos. Em seguida, selecione Microsoft.Compute>virtualMachines>[sua máquina virtual]>extensões.

      

3. Adicione o coletor do Application Insights Profiler para .NET ao SinksConfig nó em WadCfg. Se ainda não tiver uma SinksConfig secção, poderá ter de adicionar uma. Para adicionar o lavatório:

   • Especifique o iKey do Application Insights adequado em suas configurações.

   • Mude o modo Explorer para Leitura/Gravação no canto superior direito.

   • Selecione Editar.

     

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

4. Depois de terminar de editar a configuração, selecione PUT.

5. Se o put for bem-sucedido, uma marca de seleção verde aparecerá no meio da tela.

   

O .NET Profiler pode ser executado em servidores locais?

Atualmente, o Application Insights Profiler para .NET não é suportado para servidores locais.

Próximos passos

Gerar carga e exibir rastreamentos do .NET Profiler