Povolit Snapshot Debugger pro aplikace .NET v Azure App Service

Článek
05/13/2021
2 min ke čtení

Snapshot Debugger aktuálně podporuje aplikace ASP.NET a ASP.NET Core, které běží na Azure App Service v plánech služby Windows.

Při použití ladicího programu Snapshot doporučujeme, abyste aplikaci spustili v úrovni služeb Basic nebo vyšší.

Pro většinu aplikací nemá úroveň Free a Shared Service dostatek paměti nebo místa na disku pro ukládání snímků.

Povolit Snapshot Debugger

Pokud chcete povolit Snapshot Debugger pro aplikaci, postupujte podle následujících pokynů.

Pokud používáte jiný typ služby Azure, najdete tady pokyny k povolení Snapshot Debugger na dalších podporovaných platformách:

Poznámka

Pokud používáte verzi Preview rozhraní .NET Core nebo pokud 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í Snapshot debugger pro další prostředí , která zahrnují balíček NuGet Microsoft. ApplicationInsights. SnapshotCollector a pak dokončete zbývající kroky níže.

Bezkódová instalace Application Insights Snapshot Debugger se řídí zásadami podpory .NET Core. Další informace o podporovaných modulech runtime najdete v tématu zásady podpory .NET Core.

Snapshot Debugger je předem nainstalován jako součást modulu runtime App Services, ale je nutné ji zapnout, abyste získali snímky pro aplikaci App Service.

Po nasazení aplikace postupujte podle následujících kroků a povolte ladicí program snímků:

Pro App Service přejděte na ovládací panel Azure.
Přejít na stránku nastavení > Application Insights .
Podle pokynů na stránce vytvořte nový prostředek nebo vyberte existující prostředek App Insights, abyste mohli svoji aplikaci monitorovat. Také se ujistěte, že jsou zapnuté oba přepínače pro Snapshot Debugger.
Snapshot Debugger je nyní povoleno pomocí nastavení aplikace App Services.

Povolit Snapshot Debugger pro ostatní cloudy

V současné době jsou v současnosti k disAzure Government a Azure Čína jedinou oblastí, které vyžadují úpravy koncového bodu, pomocí Application Insights připojovacího řetězce.

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

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

Zakázat Snapshot Debugger

Použijte stejný postup jako u možnost povolit Snapshot Debugger, ale u Snapshot Debugger vypnout přepínač obou přepínačů.

Doporučujeme, abyste Snapshot Debugger povolili ve všech aplikacích, abyste mohli snadno diagnostikovat výjimky aplikací.

Šablona Azure Resource Manageru

V případě Azure App Service můžete nastavit nastavení aplikace v rámci šablony Azure Resource Manager tak, aby povolovala Snapshot Debugger a Profiler, a to v následujícím fragmentu šablony:

{
  "apiVersion": "2015-08-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]",
        "APPINSIGHTS_PROFILERFEATURE_VERSION": "1.0.0",
        "APPINSIGHTS_SNAPSHOTFEATURE_VERSION": "1.0.0",
        "DiagnosticServices_EXTENSION_VERSION": "~3",
        "ApplicationInsightsAgent_EXTENSION_VERSION": "~2"
      }
    }
  ]
},

Další kroky

Vygenerujte provoz do vaší aplikace, který může aktivovat výjimku. Potom počkejte 10 až 15 minut, než se snímky odešlou do instance Application Insights.
Podívejte se na snímky v Azure Portal.
Nápovědu k řešení potíží s Snapshot Debugger najdete v tématu řešení potíží s Snapshot Debugger.