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

Depurador de Instantâneos atualmente dá suporte ASP.NET e ASP.NET Core em execução Serviço de Aplicativo do Azure em planos de serviço do Windows.

Recomendamos que você execute o aplicativo na camada de serviço Básica ou superior ao usar Depurador de Instantâneos. Para a maioria dos aplicativos:

• Para a maioria dos aplicativos, as camadas de serviço Gratuita e Compartilhada não têm memória ou espaço em disco suficiente para salvar instantâneos.
• No momento, a camada de Consumo não está disponível para o Depurador de Instantâneos.

Embora o Depurador de Instantâneos seja pré-instalado como parte do tempo de execução dos serviços de aplicativo, mas 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âneos do Application Insights segue a política de suporte do .NET Core.

{
  "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 o tráfego para o aplicativo que pode disparar uma exceção. Em seguida, espere de 10 a 15 minutos para que os instantâneos comecem a ser enviados à instância do Application Insights.

Habilitar o Depurador de Instantâneos para outras regiões de nuvem

Atualmente, as únicas regiões que exigem modificações de ponto de extremidade são o Microsoft Azure Governamental e o Microsoft Azure operado pela 21Vianet por meio da Cadeia de conexão do visual Studio Online Application Insights.

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

Configurar Depurador de Instantâneos

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

O Depurador de Instantâneos dá suporte à autenticação do Microsoft Entra para ingestão de instantâneos. Para que todos os instantâneos do seu aplicativo sejam ingeridos, seu aplicativo precisa estar autenticado e fornecer as configurações de aplicativo necessárias para o agente do Depurador de Instantâneos.

A partir de hoje, o Depurador de Instantâneos só dá 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 o Microsoft Entra ID para ingestão de instantâneo no recurso dos Serviços de Aplicativo:

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

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

2. Configure e ative a ID do Microsoft Entra em seu recurso do Application Insights. Para saber mais, confira a documentação a seguir

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

Para identidade atribuída pelo sistema:

Para identidade atribuída pelo usuário:

Cenários sem suporte

Abaixo, você encontra cenários em que não há suporte para o Snapshot Collector:

Próximas etapas

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