Włącz debuger migawek dla aplikacji .NET w usłudze Azure App Service

Narzędzie Snapshot Debugger obsługuje obecnie aplikacje ASP.NET i ASP.NET Core działające w usłudze aplikacja systemu Azure w planach usług systemu Windows.

Uwaga

Jeśli używasz wersji zapoznawczej .NET Core lub aplikacja odwołuje się do zestawu SDK usługi Application Insights bezpośrednio lub pośrednio za pośrednictwem zestawu zależnego, postępuj zgodnie z instrukcjami dotyczącymi włączania debugera migawek dla innych środowisk, aby uwzględnić Microsoft.ApplicationInsights.SnapshotCollector pakiet NuGet z aplikacją.

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ług Bezpłatna i Współdzielona nie mają wystarczającej ilości pamięci ani miejsca na dysku, by zapisać migawki.
• Warstwa Zużycie nie jest obecnie dostępna dla debugera migawek.

Chociaż narzędzie Snapshot Debugger jest wstępnie zainstalowane w ramach środowiska uruchomieniowego usługi App Service, musisz je włączyć, aby uzyskiwać migawki dla aplikacji w usłudze App Service. Bez kodu instalacja programu Snapshot Debugger jest zgodna z zasadami obsługi platformy .NET Core.

Portal Azure

Debuger migawek można włączyć w portalu Azure po wdrożeniu aplikacji internetowej usługi .NET App Service.

1. Przejdź do aplikacji internetowej usługi App Service w portalu Azure.

2. W menu po lewej stronie wybierz pozycję Monitorowanie>Application Insights.

   

3. Wybierz pozycję Włącz usługę Application Insights.

   Jeśli masz istniejący zasób usługi Application Insights, którego chcesz użyć, wybierz tę opcję w obszarze Zmień zasób.

4. W obszarze Instrumentacja aplikacji wybierz pozycję .NET.

5. Ustaw oba debugery migawek na włączone.

   

6. Debuger migawek jest teraz włączony.

Wyłączanie debugera migawek

Aby wyłączyć debuggera migawek dla zasobu App Service:

1. Przejdź do usługi App Service w witrynie Azure Portal.

2. W menu po lewej stronie wybierz pozycję Monitorowanie>Application Insights.

3. Przełącz przełącznik debugera migawek na wyłączone.

Azure Resource Manager

Możesz również włączyć narzędzie Snapshot Debugger i .NET Profiler przy użyciu ustawień aplikacji w szablonie Azure Resource Manager. Na przykład:

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

Generuj ruch do aplikacji, który może wyzwolić wyjątek. Następnie poczekaj 10–15 minut, aż migawki zostaną wysłane do instancji Application Insights.

Włączanie debugera migawek dla innych regionów chmury

Obecnie jedynymi regionami, które wymagają modyfikacji punktu końcowego, są platforma Azure Government i platforma Microsoft Azure obsługiwana przez firmę 21Vianet za pośrednictwem parametrów połączenia usługi Application Insights.

Właściwość ciągu połączenia	Chmura rządowa USA	Chińska chmura
SnapshotEndpoint	https://snapshot.monitor.azure.us	https://snapshot.monitor.azure.cn

Aby uzyskać więcej informacji na temat innych przesłonięć połączeń, zobacz dokumentację usługi Application Insights.

Konfigurowanie debugera migawek

Po włączeniu debugera migawek można skonfigurować sposób uwierzytelniania i pozyskiwania migawek dla aplikacji usługi App Service.

Włączanie uwierzytelniania Microsoft Entra do przechwytywania migawek

Narzędzie Snapshot Debugger obsługuje uwierzytelnianie Microsoft Entra do przechwytywania migawek. Aby Snapshot Debugger mógł odbierać wszystkie migawki aplikacji, aplikacja musi się uwierzytelnić i dostarczyć agentowi Snapshot Debugger wymagane ustawienia aplikacji.

Uwaga

Obecnie narzędzie Snapshot Debugger obsługuje uwierzytelnianie Microsoft Entra tylko wtedy, gdy odwołujesz się do usługi Microsoft Entra ID i konfigurujesz ją przy użyciu zestawu SDK usługi Application Insights w aplikacji.

1. Dodaj zarządzaną tożsamość, która uwierzytelnia się wobec zasobu Application Insights, do Twojej usługi App Service. Utwórz jedno z poniższych:

   • Tożsamość zarządzana przypisana systemowo.
   • Zarządzana tożsamość przypisana przez użytkownika.

2. Na portalu Azure skonfiguruj i włącz Microsoft Entra ID w zasobie usługi Application Insights.

3. Dodaj następujące ustawienie aplikacji. To ustawienie informuje agenta Snapshot Debugger, której tożsamości zarządzanej używać:

   W przypadku tożsamości przypisanej przez system:

   Ustawienia aplikacji	Wartość
   APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Autoryzacja = AD

   W przypadku tożsamości przypisanej przez użytkownika:

   Ustawienia aplikacji	Wartość
   APPLICATIONINSIGHTS_AUTHENTICATION_STRING	Authorization=AD; ClientID={Identyfikator klienta tożsamości przypisanej przez użytkownika}

Nieobsługiwane scenariusze

W poniższym scenariuszu pokazano, gdzie moduł zbierający migawki nie jest obsługiwany.

Scenariusz	Efekty uboczne	Zalecenie
Używasz zestawu SDK Snapshot Collector bezpośrednio w aplikacji (.csproj) i włączasz opcję zaawansowaną Interop.	Utracisz lokalny pakiet SDK usługi Application Insights, w tym dane telemetryczne modułu Snapshot Collector, a migawki nie będą dostępne. Aplikacja może ulec awarii podczas uruchamiania za pomocą polecenia System.ArgumentException: telemetryProcessorType does not implement ITelemetryProcessor. Aby uzyskać więcej informacji na temat współdziałania funkcji Application Insights, przejrzyj sekcję Rozwiązywanie problemów z integracją Application Insights.	Jeśli używasz zaawansowanej opcji Interop, użyj zastrzyku modułu zbierającego migawki, który nie wymaga pisania kodu i jest włączony za pośrednictwem portalu Azure.

Treści powiązane

• Wyświetlanie migawek w witrynie Azure Portal.
• Rozwiązywanie problemów z debugerem migawek.