Habilitar o Depurador de Instantâneo para aplicativos .NET e .NET Core no Azure Functions

Artigo
11/05/2024

Atualmente, o Depurador de Instantâneo funciona para aplicativos ASP.NET e ASP.NET Core que estão sendo executados no Azure Functions 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.

O Depurador de Instantâneo é pré-instalado como parte do tempo de execução do Azure Functions, portanto, você não precisa adicionar pacotes NuGet ou configurações de aplicativo extras.

Pré-requisito

Habilite o monitoramento do Application Insights em seu aplicativo Functions.

Ativar depurador de instantâneo

Para habilitar o Depurador de Instantâneo em seu aplicativo Functions, adicione a snapshotConfiguration propriedade ao seu arquivo de host.json e reimplante sua função. Por exemplo:

{
  "version": "2.0",
  "logging": {
    "applicationInsights": {
      "snapshotConfiguration": {
        "isEnabled": true
      }
    }
  }
}

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.

Você pode verificar se o Depurador de Instantâneo foi habilitado verificando os arquivos do aplicativo de função .NET. Por exemplo, no seguinte aplicativo de função .NET simples, o .csproj, {Your}Function.cse host.json do seu aplicativo .NET mostram o Depurador de Instantâneo como habilitado:

Project.csproj

<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
    <TargetFramework>netcoreapp2.1</TargetFramework>
    <AzureFunctionsVersion>v2</AzureFunctionsVersion>
</PropertyGroup>
<ItemGroup>
    <PackageReference Include="Microsoft.NET.Sdk.Functions" Version="1.0.31" />
</ItemGroup>
<ItemGroup>
    <None Update="host.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
    <None Update="local.settings.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <CopyToPublishDirectory>Never</CopyToPublishDirectory>
    </None>
</ItemGroup>
</Project>

{Your}Function.cs

using System;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Logging;

namespace SnapshotCollectorAzureFunction
{
    public static class ExceptionFunction
    {
        [FunctionName("ExceptionFunction")]
        public static Task<IActionResult> Run(
            [HttpTrigger(AuthorizationLevel.Function, "get", Route = null)] HttpRequest req,
            ILogger log)
        {
            log.LogInformation("C# HTTP trigger function processed a request.");

            throw new NotImplementedException("Dummy");
        }
    }
}

Host.json

{
  "version": "2.0",
  "logging": {
    "applicationInsights": {
      "samplingExcludedTypes": "Request",
      "samplingSettings": {
        "isEnabled": true
      },
      "snapshotConfiguration": {
        "isEnabled": true
      }
    }
  }
}

Ativar o Depurador de Instantâneo para outras nuvens

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.

O exemplo a seguir mostra o host.json ponto de extremidade atualizado com o agente do US Government Cloud:

{
  "version": "2.0",
  "logging": {
    "applicationInsights": {
      "samplingExcludedTypes": "Request",
      "samplingSettings": {
        "isEnabled": true
      },
      "snapshotConfiguration": {
        "isEnabled": true,
        "agentEndpoint": "https://snapshot.monitor.azure.us"
      }
    }
  }
}

Aqui estão as substituições suportadas do ponto de extremidade do agente do Depurador de Instantâneo:

Property	Nuvem do governo dos EUA	China Cloud
AgentEndpoint	`https://snapshot.monitor.azure.us`	`https://snapshot.monitor.azure.cn`

Desativar o Depurador de Instantâneo

Para desativar o Depurador de Instantâneo no aplicativo Functions, atualize o host.json arquivo definindo a snapshotConfiguration.isEnabled propriedade como false.

{
  "version": "2.0",
  "logging": {
    "applicationInsights": {
      "snapshotConfiguration": {
        "isEnabled": false
      }
    }
  }
}

Próximos passos

Exiba instantâneos no portal do Azure.
Personalize a configuração do Depurador de Instantâneo com base no seu caso de uso no aplicativo Functions. Para obter mais informações, consulte Configuração de instantâneo no host.json.
Solucione problemas do Depurador de Instantâneo.

Partilhar via