Włączanie debugera migawek dla aplikacji .NET i .NET Core w usłudze Azure Functions

Narzędzie Snapshot Debugger obecnie działa w przypadku aplikacji ASP.NET i ASP.NET Core, które działają w usłudze Azure Functions w planach usług systemu Windows.

Uruchom aplikację w warstwie usługi Podstawowa lub wyższej podczas korzystania z narzędzia Snapshot Debugger. W przypadku większości aplikacji:

  • Poziomy usługi "Bezpłatna" i "Współdzielona" nie mają wystarczającej ilości pamięci ani miejsca na dysku, aby zapisać kopie migawkowe.
  • Warstwa Zużycie nie jest obecnie dostępna dla debugera migawek.

Debuger migawek jest wstępnie zainstalowany w ramach środowiska uruchomieniowego usługi Azure Functions. Nie musisz dodawać dodatkowych pakietów NuGet ani ustawień aplikacji.

Wymagania wstępne

Przed włączeniem programu Snapshot Debugger włącz monitorowanie usługi Application Insights w aplikacji funkcji. Narzędzie Snapshot Debugger korzysta z usługi Application Insights do przechowywania i wyświetlania przechwyconych migawek.

Włączanie debugera migawek

Aby włączyć narzędzie Snapshot Debugger w aplikacji funkcji, dodaj właściwość snapshotConfiguration do pliku host.json i ponownie wdroż aplikację funkcji. Na przykład:

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

Wygeneruj ruch kierowany do aplikacji, który powoduje wystąpienie wyjątku. Następnie poczekaj od 10 do 15 minut, aż migawki dotrą do instancji usługi Application Insights.

Aby sprawdzić, czy Snapshot Debugger jest włączony, sprawdź pliki aplikacji .NET. Na przykład w następującej prostej aplikacji funkcji .NET elementy .csproj, {Your}Function.cs, i host.json aplikacji platformy .NET pokazują, że Debuger Migawek jest włączony.

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
      }
    }
  }
}

Włączanie debugera migawek dla innych chmur

Obecnie jedynymi regionami, które wymagają modyfikacji punktów końcowych, są platforma Azure Government i platforma Microsoft Azure obsługiwana przez firmę 21Vianet.

Poniższy przykład pokazuje element host.json zaktualizowany o punkt końcowy agenta Azure Government:

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

Poniższa tabela zawiera listę obsługiwanych przesłonięć punktu końcowego agenta Snapshot Debugger:

Właściwości Azure Government Platforma Azure obsługiwana przez firmę 21Vianet
agentEndpoint https://snapshot.monitor.azure.us https://snapshot.monitor.azure.cn

Wyłączanie debugera migawek

Aby wyłączyć narzędzie Snapshot Debugger w aplikacji funkcji, zaktualizuj plik host.json, ustawiając wartość właściwości snapshotConfiguration.isEnabled na false.

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

Treści powiązane

  • Ostatnia aktualizacja o