Povolení programu Snapshot Debugger pro aplikace .NET ve službě Aplikace Azure

Článek
11/05/2024

Poznámka:

Pokud používáte verzi Preview .NET Core nebo vaše aplikace odkazuje na sadu Application Insights SDK (přímo nebo nepřímo prostřednictvím závislého sestavení), postupujte podle pokynů pro povolení nástroje Snapshot Debugger pro jiná prostředí , aby se balíček NuGet zahrnul Microsoft.ApplicationInsights.SnapshotCollector do aplikace.

Snapshot Debugger v současné době podporuje aplikace ASP.NET a ASP.NET Core spuštěné ve službě Aplikace Azure Service v plánech služeb systému Windows.

Při použití nástroje Snapshot Debugger doporučujeme spustit aplikaci na úrovních služby Basic nebo vyšší. Pro většinu aplikací:

Úrovně služby Free a Shared nemají dostatek paměti nebo místa na disku, aby se ušetřily snímky.
Úroveň Consumption není aktuálně k dispozici pro Snapshot Debugger.

I když je program Snapshot Debugger předinstalovaný jako součást modulu runtime služby App Services, musíte ho zapnout, abyste získali snímky pro aplikaci App Service. Instalace nástroje Snapshot Debugger bez kódu se řídí zásadami podpory .NET Core.

Azure Portal
Azure Resource Manager

Po nasazení webové aplikace .NET App Services:

Na webu Azure Portal přejděte ke službě App Service.
V nabídce na levé straně vyberte Nastavení>Application Insights.
Klikněte na Zapnout Application Insights.
- Pokud máte existující prostředek Application Insights, který byste raději použili, vyberte tuto možnost v části Změnit prostředek.
V části Instrumentace aplikace vyberte kartu .NET .
Přepněte oba přepínače snapshot Debuggeru na Zapnuto.
Snapshot Debugger je teď povolený.

Zakázání ladicího programu snímků

Zakázání nástroje Snapshot Debugger pro prostředek služby App Services:

Na webu Azure Portal přejděte ke službě App Service.
V nabídce na levé straně vyberte Nastavení>Application Insights.
Přepínač Snapshot Debuggeru je vypnutý.

Nastavení aplikace můžete také nastavit v šabloně Azure Resource Manageru a povolit snapshot Debugger a .NET Profiler. Příklad:

{
  "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"
      }
    }
  ]
},

Vygenerujte provoz do vaší aplikace, který může aktivovat výjimku. Pak počkejte 10 až 15 minut, než se snímky odešlou do instance Application Insights.

Povolení ladicího programu snapshot pro jiné cloudové oblasti

Jedinými oblastmi, které vyžadují úpravy koncových bodů, jsou Azure Government a Microsoft Azure provozované společností 21Vianet prostřednictvím připojovacího řetězce Application Insights.

Vlastnost připojovacího řetězce	Cloud pro státní správu USA	Cloud Čína
SnapshotEndpoint	`https://snapshot.monitor.azure.us`	`https://snapshot.monitor.azure.cn`

Další informace o dalších přepsání připojení najdete v dokumentaci k Application Insights.

Konfigurace ladicího programu snímků

Povolení ověřování Microsoft Entra pro příjem snímků

Snapshot Debugger podporuje ověřování Microsoft Entra pro příjem snímků. Aby bylo možné ingestovat všechny snímky aplikace, musí být vaše aplikace ověřená a musí poskytovat požadovaná nastavení aplikace agentu Snapshot Debugger.

Od dnešního dne podporuje Snapshot Debugger pouze ověřování Microsoft Entra, když odkazujete na a nakonfigurujete ID Microsoft Entra pomocí sady Application Insights SDK ve vaší aplikaci.

Zapnutí ID Microsoft Entra pro příjem snímků v prostředku služby App Services:

Přidejte spravovanou identitu, která se ověřuje v prostředku Application Insights do vaší služby App Service. Můžete vytvořit jednu z těchto akcí:
- Přidejte spravovanou identitu přiřazenou systémem.
- Přidejte spravovanou identitu přiřazenou uživatelem.
Nakonfigurujte a zapněte ID Microsoft Entra v prostředku Application Insights. Další informace najdete v následující dokumentaci.
Přidejte následující nastavení aplikace. Toto nastavení říká agentovi Snapshot Debuggeru, kterou spravovanou identitu použít:

Pro identitu přiřazenou systémem:

Nastavení aplikace	Hodnota
APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Authorization=AD

Pro identitu přiřazenou uživatelem:

Nastavení aplikace	Hodnota
APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Authorization=AD; ClientID={ID klienta identity přiřazené uživatelem}

Nepodporované scénáře

Níže najdete scénáře, ve kterých není podporovaný kolektor snímků:

Scénář	Vedlejší účinky	Doporučení
V aplikaci používáte přímo sadu SDK služby Snapshot Collector (.csproj) a povolíte pokročilou možnost Spolupráce.	Místní sada Application Insights SDK (včetně telemetrie kolektoru snímků) se ztratí a nejsou k dispozici žádné snímky. Při spuštění aplikace může dojít k chybovému ukončení aplikace `System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor.` Přečtěte si další informace o interoperabilitě funkcí Application Insights.	Pokud používáte pokročilou možnost Interop, použijte injektáž snapshot collectoru bez kódu (povolená prostřednictvím webu Azure Portal).

Další kroky

Zobrazení snímků na webu Azure Portal
Řešení potíží se snímkem ladicího programu

Sdílet prostřednictvím