次の方法で共有

在 Azure Functions 中为 .NET 和 .NET Core 应用启用 Snapshot Debugger

Snapshot Debugger 目前适用于在 Windows 服务计划中在 Azure Functions 上运行的 ASP.NET 和 ASP.NET 核心应用。

建议在使用 Snapshot Debugger 时，在基本或更高服务层级上运行应用程序。 对于大多数应用程序：

  • “免费”和“共享”服务层级没有足够的内存或磁盘空间用于保存快照。
  • 消耗层当前不可用于 Snapshot Debugger。

快照调试器已经作为 Azure Functions 运行时的一部分被预安装。 无需添加额外的 NuGet 包或应用程序设置。

先决条件

在 Functions 应用中启用 Application Insights 监控。

启用快照调试器

若要在 Functions 应用中启用 Snapshot Debugger，请将 snapshotConfiguration 属性添加到 host.json 文件并重新部署函数。 例如：

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

为应用程序生成可触发异常情况的流量。 然后等待 10 到 15 分钟，让快照发送到 Application Insights 实例。

若要验证快照调试器是否已启用，请检查 .NET 函数应用文件。 例如，在以下简单的 .NET 函数应用中，.NET 应用程序的 .csproj、{Your}Function.cs 和 host.json 显示 Snapshot Debugger 已启用：

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

为其他云启用 Snapshot Debugger

目前，由世纪互联运营的 Azure 区域需要对终结点进行修改。

以下示例演示了由世纪互联运营的 Azure 云代理端点更新的 host.json:

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

以下是支持的 Snapshot Debugger 代理终结点的替代项：

属性 由世纪互联运营的 Azure
agentEndpoint https://snapshot.monitor.azure.cn

禁用快照调试器

要在 Functions 应用中禁用 Snapshot Debugger，请通过将 属性设置为 snapshotConfiguration.isEnabled 来更新 host.json 文件false。

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

相关内容

  • Last updated on