Sdílet prostřednictvím

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

  • Článek

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

Poznámka:

Při použití nástroje Snapshot Debugger doporučujeme spustit aplikaci na úrovni služby Basic nebo vyšší. U většiny aplikací nemají úrovně služby Free a Shared 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.

Povolení ladicího programu snímků

Snapshot Debugger je předinstalovaný jako součást modulu runtime App Services, ale pokud chcete získat snímky pro aplikaci App Service, musíte ho zapnout. Pokud chcete pro aplikaci povolit Snapshot Debugger, postupujte podle následujících pokynů:

Poznámka:

Pokud používáte verzi Preview .NET Core nebo vaše aplikace odkazuje na sadu Application Přehledy 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.

Poznámka:

Bez kódu instalace programu Application Přehledy 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.

Po nasazení aplikace .NET:

  1. Přejděte do ovládacího panelu Azure pro službu App Service.

  2. Přejděte na stránku Nastavení> Aplikace Přehledy.

    Screenshot showing the Enable App Insights on App Services portal.

  3. Buď postupujte podle pokynů na stránce a vytvořte nový prostředek, nebo vyberte existující prostředek Přehledy aplikace, který chcete monitorovat.

  4. Přepínač Snapshot Debugger se přepne na Zapnuto.

    Screenshot showing how to add App Insights site extension.

  5. Snapshot Debugger je teď povolený pomocí nastavení aplikace App Services.

    Screenshot showing App Setting for Snapshot Debugger.

Pokud používáte jiný typ služby Azure, tady jsou pokyny pro povolení snapshot Debuggeru na jiných podporovaných platformách:

Povolení snapshot Debuggeru pro ostatní cloudy

Jedinými oblastmi, které vyžadují úpravy koncových bodů, jsou Azure Government a Microsoft Azure provozované společností 21Vianet prostřednictvím řetězce Přehledy Připojení ionu aplikace.

vlastnost Připojení ion String Cloud pro státní správu USA Cloud Čína
SnapshotEndpoint https://snapshot.monitor.azure.us https://snapshot.monitor.azure.cn

Další informace o jiných přepsání připojení najdete v dokumentaci k aplikaci Přehledy.

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

Application Přehledy Snapshot Debugger podporuje ověřování Microsoft Entra pro příjem snímků. To znamená, že pro všechny snímky vaší aplikace, které se mají ingestovat, musí být vaše aplikace ověřena a poskytovat požadované nastavení aplikace agentu Snapshot Debugger.

K dnešnímu dni podporuje Snapshot Debugger pouze ověřování Microsoft Entra, pokud odkazujete na a nakonfigurujete Microsoft Entra ID pomocí sady Application Přehledy SDK ve vaší aplikaci.

Zapnutí ID Microsoft Entra pro příjem snímků:

  1. Vytvořte a přidejte spravovanou identitu, kterou chcete použít k ověření ve vaší aplikaci Přehledy prostředku do služby App Service.

    1. Informace o spravované identitě přiřazené systémem najdete v následující dokumentaci.

    2. Spravovanou identitu přiřazenou uživatelem najdete v následující dokumentaci.

  2. Nakonfigurujte a zapněte ID Microsoft Entra v prostředku aplikace Přehledy. Další informace najdete v následující dokumentaci.

  3. Přidejte následující nastavení aplikace, které slouží k tomu, aby agent Snapshot Debugger věděl, 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}

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

Pokud chcete snapshot Debugger zakázat, opakujte kroky pro povolení. Přepínač Snapshot Debugger se ale přepne na Vypnuto.

Šablona Azure Resource Manageru

Pro službu Aplikace Azure můžete nastavit nastavení aplikace v šabloně Azure Resource Manageru, abyste povolili Snapshot Debugger a Profiler. Příklad:

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

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 povolili jste pokročilou možnost "Interoperabilita". Místní sada SDK Přehledy aplikace (včetně telemetrie kolektoru snímků) se ztratí a nebudou 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 funkci Spolupráce Přehledy aplikace.		 Pokud používáte pokročilou možnost "Interoperabilita", použijte injektáž snapshot collectoru bez kódu (povolená prostřednictvím webu Azure Portal).

Další kroky

  • 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 Přehledy aplikace.
  • Podívejte se na snímky na webu Azure Portal.
  • Nápovědu k řešení potíží s nástrojem Snapshot Debugger najdete v tématu Řešení potíží s ladicím programem snímků.