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

Observação

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

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

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

Selecione a guia método preferencial para:

Neste guia, você aprenderá a:

• Configure a extensão de Diagnóstico do Azure para executar o Profiler para .NET.
• Instalar o SDK do Application Insights em uma VM.
• Implante seu aplicativo.
• Exibir os 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 examinar os modelos do ARM (Azure Resource Manager) para a extensão de Diagnóstico do Azure:
  • VM
  • Conjunto de escala de máquina virtual

Adicione o SDK do Application Insights ao seu aplicativo

1. Abra o projeto do ASP.NET Core no Visual Studio.

2. Selecione Projeto>Adicionar Application Insights Telemetry.

3. Selecione Azure Application Insights>Avançar.

4. Selecione a assinatura em que o recurso do Application Insights reside e selecione Avançar.

5. Escolha o local em que você deseja salvar a cadeia de conexão e selecione Avançar.

6. Selecione Concluir.

Observação

Para obter as instruções completas, incluindo como habilitar o Application Insights no aplicativo ASP.NET Core sem o Visual Studio, confira Application Insights para aplicativos do ASP.NET Core.

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

1. Acesse Projeto>Gerenciar Pacotes do NuGet.

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 Profiler para .NET

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

• No 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.

Visual Studio e Modelo do ARM

Instalar a extensão do Diagnóstico do Azure

1. Escolha qual modelo do ARM usar:

   • VM
   • Conjunto de escala de máquina virtual

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

3. No Visual Studio, acesse o arquivo arm.json no aplicativo ASP.NET Core adicionado quando você instalou o SDK do Application Insights.

4. Adicione o tipo de recurso extension do modelo para o arquivo arm.json, para configurar uma VM ou um conjunto de dimensionamento de máquinas virtuais com o Diagnóstico do Azure.

5. Na marca WadCfg, adicione a chave de instrumentação do Application Insights a 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 as VMs existentes que interferem apenas na extensão do Diagnóstico do Azure.

Observação

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 usando a configuração de Diagnóstico do Azure

1. Exporte a configuração de Diagnóstico do Azure implantada no momento 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 comando a seguir para passar a configuração atualizada para o comando Set-AzVMDiagnosticsExtension.

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

   Observação

   Set-AzVMDiagnosticsExtension pode exigir o argumento -StorageAccountName. Se a configuração de diagnóstico original tiver a propriedade storageAccountName na seção protectedSettings (que não pode ser baixada), passe o mesmo valor original que havia nesta chamada do cmdlet.

Recurso de Rastreamento HTTP do IIS

Se o aplicativo desejado estiver em execução por meio do IIS, habilite o recurso do Windows IIS Http Tracing:

1. Estabeleça o 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 comando a seguir:

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

3. Implante seu aplicativo.

Azure Resource Explorer

Definir o coletor do Profiler usando o Azure Resource Explorer

Como o portal do Azure não fornece uma maneira de definir o coletor do Application Insights Profiler para .NET, você poderá usar o Azure Resource Explorer para fazer isso.

Observação

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 foi instalada exibindo as extensões instaladas na máquina virtual.

   

2. Localize a extensão de Diagnóstico da VM:

   1. Acesse o Azure Resource Explorer.

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

   3. Faça uma busca detalhada em 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 nó SinksConfig em WadCfg. Se você ainda não tiver um seção SinksConfig, talvez precise adicionar uma. Para adicionar o coletor:

   • Especifique o iKey apropriado do Application Insights nas configurações.

   • Alterne 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 put for realizado com sucesso, uma marca de seleção verde aparecerá no meio da tela.

   

O Profiler para .NET pode ser executado em servidores locais?

Atualmente, não há suporte para Application Insights Profiler para .NET nos servidores locais.

Próximas etapas

Gerar carga e visualizar os rastros do Profiler para .NET