Habilitar o Depurador de Instantâneo para aplicativos .NET no Serviço de Aplicativo do Azure

Nota

Se você estiver usando uma versão de visualização do .NET Core ou se seu aplicativo fizer referência ao SDK do Application Insights (direta ou indiretamente por meio de um assembly dependente), siga as instruções para Habilitar o Depurador de Instantâneo para outros ambientes para incluir o Microsoft.ApplicationInsights.SnapshotCollector pacote NuGet com o aplicativo.

Atualmente, o Depurador de Instantâneo dá suporte a aplicativos ASP.NET e ASP.NET Core em execução no Serviço de Aplicativo do Azure em planos de serviço do Windows.

Recomendamos que você execute seu aplicativo nas camadas de serviço Básico ou superior ao usar o Depurador de Instantâneo. Para a maioria das aplicações:

• As camadas de serviço Gratuito e Compartilhado não têm memória ou espaço em disco suficientes para salvar instantâneos.
• A camada Consumo não está disponível atualmente para o Depurador de Instantâneo.

Embora o Depurador de Instantâneo esteja pré-instalado como parte do tempo de execução dos Serviços de Aplicativo, você precisa ativá-lo para obter instantâneos para seu aplicativo do Serviço de Aplicativo. A instalação sem código do Depurador de Instantâneo segue a política de suporte do .NET Core.

Portal do Azure

Depois de implantar seu aplicativo Web dos Serviços de Aplicativo .NET:

1. Navegue até o Serviço de Aplicativo no portal do Azure.

2. No menu do lado esquerdo, selecione Settings>Application Insights.

   

3. Clique em Ativar Application Insights.

   • Se você tiver um recurso existente do Application Insights que preferir usar, selecione essa opção em Alterar seu recurso.

4. Em Instrumentar seu aplicativo, selecione a guia .NET .

5. Alterne ambas as alternâncias do Depurador de Instantâneo para Ativado.

   

6. O Depurador de Instantâneo agora está habilitado.

Desativar o Depurador de Instantâneo

Para desativar o Depurador de Instantâneo para seu recurso dos Serviços de Aplicativo:

1. Navegue até o Serviço de Aplicativo no portal do Azure.
2. No menu do lado esquerdo, selecione Settings>Application Insights.
3. Alterne o Depurador de instantâneo para Desativado.

Azure Resource Manager

Você também pode definir as configurações do aplicativo no modelo do Azure Resource Manager para habilitar o Depurador de Instantâneo e o .NET Profiler. Por exemplo:

{
  "apiVersion": "2023-12-01",
  "name": "[parameters('webSiteName')]",
  "type": "Microsoft.Web/sites",
  "location": "[resourceGroup().location]",
  "dependsOn": [
    "[variables('hostingPlanName')]"
  ],
  "tags": { 
    "[concat('hidden-related:', resourceId('Microsoft.Web/serverfarms', variables('hostingPlanName')))]": "empty",
    "displayName": "Website"
  },
  "properties": {
    "name": "[parameters('webSiteName')]",
    "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', variables('hostingPlanName'))]"
  },
  "resources": [
    {
      "apiVersion": "2015-08-01",
      "name": "appsettings",
      "type": "config",
      "dependsOn": [
        "[parameters('webSiteName')]",
        "[concat('AppInsights', parameters('webSiteName'))]"
      ],
      "properties": {
        "APPINSIGHTS_INSTRUMENTATIONKEY": "[reference(resourceId('Microsoft.Insights/components', concat('AppInsights', parameters('webSiteName'))), '2014-04-01').InstrumentationKey]",
        // "Turn on" a Snapshot Debugger version
        "APPINSIGHTS_SNAPSHOTFEATURE_VERSION": "1.0.0",
        "DiagnosticServices_EXTENSION_VERSION": "~3",
        "ApplicationInsightsAgent_EXTENSION_VERSION": "~2"
      }
    }
  ]
},

Gere tráfego para seu aplicativo que pode acionar uma exceção. Em seguida, aguarde de 10 a 15 minutos para que os instantâneos sejam enviados para a instância do Application Insights.

Ativar o Depurador de Instantâneo para outras regiões de nuvem

Atualmente, as únicas regiões que exigem modificações de ponto de extremidade são o Azure Government e o Microsoft Azure operados pela 21Vianet por meio da Cadeia de Conexão do Application Insights.

Propriedade Connection String	Nuvem do governo dos EUA	China Cloud
SnapshotEndpoint	https://snapshot.monitor.azure.us	https://snapshot.monitor.azure.cn

Para obter mais informações sobre outras substituições de conexão, consulte a documentação do Application Insights.

Configurar o Depurador de Instantâneo

Habilitar a autenticação do Microsoft Entra para ingestão de instantâneos

O Depurador de Instantâneos suporta a autenticação Microsoft Entra para ingestão de instantâneos. Para que todos os instantâneos do seu aplicativo sejam ingeridos, seu aplicativo deve ser autenticado e fornecer as configurações necessárias do aplicativo para o agente do Depurador de Instantâneo.

A partir de hoje, o Depurador de Instantâneo só oferece suporte à autenticação do Microsoft Entra quando você faz referência e configura a ID do Microsoft Entra usando o SDK do Application Insights em seu aplicativo.

Para ativar a ID do Microsoft Entra para a ingestão de instantâneos no recurso dos Serviços de Aplicativo:

1. Adicione a identidade gerenciada que se autentica em seu recurso do Application Insights ao seu Serviço de Aplicativo. Você pode criar:

   • Adicione uma identidade gerenciada atribuída pelo sistema.
   • Adicione uma identidade gerenciada atribuída pelo usuário.

2. Configure e ative o Microsoft Entra ID no recurso do Application Insights. Para obter mais informações, consulte a seguinte documentação

3. Adicione a seguinte configuração do aplicativo. Essa configuração informa ao agente do Depurador de Instantâneo qual identidade gerenciada usar:

Para a identidade atribuída ao sistema:

Definição da Aplicação	Value
APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Autorização=AD

Para identidade atribuída pelo usuário:

Definição da Aplicação	Value
APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Autorização=AD; ClientID={ID do Cliente da Identidade Atribuída pelo Utilizador}

Cenários não suportados

Abaixo, você pode encontrar cenários em que o Snapshot Collector não é suportado:

Cenário	Efeitos Secundários	Recomendação
Você está usando o SDK do Snapshot Collector em seu aplicativo diretamente (.csproj) e habilitou a opção avançada Interop.	O SDK local do Application Insights (incluindo a telemetria do Snapshot Collector) é perdido e nenhum Snapshot está disponível. Seu aplicativo pode falhar na inicialização com System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor. Saiba mais sobre o recurso de interoperabilidade do Application Insights.	Se você estiver usando a opção avançada Interop, use a injeção do Snapshot Collector sem código (habilitada por meio do portal do Azure).

Próximos passos

• Exiba instantâneos no portal do Azure.
• Solucione problemas do Depurador de Instantâneo.