Felsöka problem med att aktivera Application Insights Snapshot Debugger eller visa ögonblicksbilder

Artikel
11/20/2024

Om du har aktiverat Application Insights Snapshot Debugger för ditt program, men inte ser ögonblicksbilder för undantag, kan du använda de här instruktionerna för att felsöka.

Det kan finnas många olika orsaker till varför ögonblicksbilder inte genereras. Du kan börja med att köra hälsokontrollen för ögonblicksbilder för att identifiera några av de möjliga vanliga orsakerna.

Scenarier som inte stöds

Nedan visas scenarier där ögonblicksbildinsamlaren inte stöds:

Scenario	Biverkningar	Rekommendation
När du använder Snapshot Collector SDK i ditt program direkt (.csproj) och du har aktiverat förhandsalternativet "Interop".	Den lokala Application Insights SDK (inklusive telemetri för ögonblicksbildinsamlaren) kommer att gå förlorad. Därför kommer inga ögonblicksbilder att vara tillgängliga. Ditt program kan krascha vid start med `System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor` Mer information om Application Insights-funktionen "Interop" finns i Programövervakning för Azure App Service och ASP.NET Core.	Om du använder förhandsalternativet "Interop" använder du den kodlösa inmatningen av ögonblicksbildinsamlaren (aktiverad via Azure Portal UX).

Kontrollera att du använder rätt slutpunkt för ögonblicksbildsfelsökaren

För närvarande är Azure Government och Azure China de enda regioner som kräver slutpunktsändringar.

För App Service och program som använder Application Insights SDK måste du uppdatera anslutningssträng med hjälp av de åsidosättningar som stöds för Felsökning av ögonblicksbilder enligt definitionen nedan:

Egenskapen Anslutningssträng	US Government Cloud	Kina, moln
SnapshotEndpoint	`https://snapshot.monitor.azure.us`	`https://snapshot.monitor.azure.cn`

Mer information om andra åsidosättningar av anslutningar finns i Application Insights-dokumentationen.

För funktionsappen host.json måste du uppdatera med hjälp av de åsidosättningar som stöds nedan:

Property	US Government Cloud	Kina, moln
AgentEndpoint	`https://snapshot.monitor.azure.us`	`https://snapshot.monitor.azure.cn`

Här är ett exempel på den host.json uppdaterade med US Government Cloud-agentens slutpunkt:

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

Använd hälsokontrollen med ögonblicksbilder

Flera vanliga problem leder till att ögonblicksbilden Av öppen felsökning inte visas. Till exempel används en inaktuell ögonblicksbildinsamlare. Den dagliga uppladdningsgränsen har uppnåtts. eller kanske ögonblicksbilden bara tar lång tid att ladda upp. Använd hälsokontrollen för ögonblicksbilder för att felsöka vanliga problem.

Det finns en länk i undantagsfönstret i spårningsvyn från slutpunkt till slutpunkt som tar dig till hälsokontrollen för ögonblicksbilder.

Skärmbild som visar hur du anger hälsokontroll för ögonblicksbilder.

Det interaktiva, chattliknande gränssnittet letar efter vanliga problem och hjälper dig att åtgärda dem.

Skärmbild som visar det interaktiva hälsokontrollfönstret med problem och förslag på hur du åtgärdar dem.

Om det inte löser problemet kan du läsa följande manuella felsökningssteg.

Verifiera instrumentationsnyckeln

Kontrollera att du använder rätt instrumentationsnyckel i det publicerade programmet. Instrumentationsnyckeln läse vanligtvis från filen ApplicationInsights.config . Kontrollera att värdet är samma som instrumentationsnyckeln för Application Insights-resursen som visas i portalen.

Stödet för inmatning av instrumentationsnycklar upphör den 31 mars 2025. Inmatningen av instrumenteringsnyckeln fortsätter att fungera, men vi kommer inte längre att tillhandahålla uppdateringar eller stöd för funktionen. Övergå till anslutningssträng för att dra nytta av nya funktioner.

Kontrollera TLS/SSL-klientinställningar (ASP.NET)

Om du har ett ASP.NET program som finns i Azure App Service eller i IIS på en virtuell dator kan programmet misslyckas med att ansluta till tjänsten Snapshot Debugger på grund av ett SSL-säkerhetsprotokoll som saknas.

Slutpunkten för ögonblicksbildsfelsökaren kräver TLS version 1.2. Uppsättningen SSL-säkerhetsprotokoll är en av de egenheter som aktiveras av httpRuntime targetFramework värdet i system.web avsnittet .web.config httpRuntime targetFramework Om är 4.5.2 eller lägre inkluderas inte TLS 1.2 som standard.

Kommentar

Värdet httpRuntime targetFramework är oberoende av det målramverk som används när du skapar ditt program.

Om du vill kontrollera inställningen öppnar du filen web.config och letar upp avsnittet system.web. Kontrollera att för httpRuntime är inställt på targetFramework 4.6 eller senare.

<system.web>
   ...
   <httpRuntime targetFramework="4.7.2" />
   ...
</system.web>

Kommentar

Om httpRuntime targetFramework du ändrar värdet ändras körningens egenheter som tillämpas på ditt program och kan orsaka andra, subtila beteendeändringar. Se till att testa programmet noggrant när du har gjort den här ändringen. En fullständig lista över kompatibilitetsändringar finns i Ändra mål för ändringar.

Kommentar

targetFramework Om är 4.7 eller senare bestämmer Windows vilka protokoll som är tillgängliga. I Azure App Service är TLS 1.2 tillgängligt. Men om du använder en egen virtuell dator kan du behöva aktivera TLS 1.2 i operativsystemet.

Förhandsversioner av .NET Core

Om du använder en förhandsversion av .NET Core eller ditt program refererar till Application Insights SDK, direkt eller indirekt via en beroende sammansättning, följer du anvisningarna för Aktivera felsökning av ögonblicksbilder för andra miljöer.

Kontrollera statussidan för diagnostiktjänstwebbplatstillägget

Om felsökningsprogrammet för ögonblicksbilder aktiverades via application insights-fönstret i portalen aktiverades det av webbplatstillägget För diagnostiktjänster.

Kommentar

Kodlös installation av Application Insights Snapshot Debugger följer .NET Core-supportprincipen. Mer information om körning som stöds finns i .NET Core-supportprincip.

Du kan kontrollera statussidan för det här tillägget genom att gå till följande URL: https://{site-name}.scm.azurewebsites.net/DiagnosticServices

Kommentar

Domänen för länken Statussida varierar beroende på molnet. Den här domänen kommer att vara samma som Kudu-hanteringswebbplatsen för App Service.

Den här statussidan visar installationstillståndet för profilerings- och ögonblicksbildinsamlareagenterna. Om det uppstod ett oväntat fel visas det och visar hur du åtgärdar det.

Du kan använda Kudu-hanteringswebbplatsen för App Service för att hämta bas-URL:en för den här statussidan:

Öppna App Service-programmet i Azure Portal.
Välj Avancerade verktyg eller sök efter Kudu.
Välj Gå.
När du är på Kudu-hanteringswebbplatsen lägger du till /DiagnosticServices och trycker på Retur i URL:en. Det slutar så här: https://<kudu-url>/DiagnosticServices.

Uppgradera till den senaste versionen av NuGet-paketet

Baserat på hur felsökningsprogrammet för ögonblicksbilder har aktiverats kan du läsa följande alternativ:

Om felsökningsprogrammet för ögonblicksbilder har aktiverats via application insights-fönstret i portalen bör ditt program redan köra det senaste NuGet-paketet.
Om Snapshot Debugger har aktiverats genom att inkludera NuGet-paketet Microsoft.ApplicationInsights.SnapshotCollector använder du NuGet Package Manager i Visual Studio för att se till att du använder den senaste versionen av Microsoft.ApplicationInsights.SnapshotCollector.

De senaste uppdateringarna och felkorrigeringarna finns i viktig information.

Kontrollera uppladdningsloggarna

När en ögonblicksbild har skapats skapas en minidumpfil (.dmp) på disken. En separat uppladdningsprocess skapar den minidump-filen och laddar upp den, tillsammans med eventuella associerade PDF-filer, till Application Insights Snapshot Debugger Storage. När minidumpen har laddats upp tas den bort från disken. Loggfilerna för uppladdningsprocessen sparas på disken. I en App Service-miljö hittar du loggarna i D:\Home\LogFiles. Använd Kudu-hanteringswebbplatsen för App Service för att hitta dessa loggfiler.

Öppna App Service-programmet i Azure Portal.
Välj Avancerade verktyg eller sök efter Kudu.
Välj Gå.
I listrutan Felsökningskonsol väljer du CMD.
Välj LogFiles.

Du bör se minst en fil med ett namn som börjar med Uploader_ eller SnapshotUploader_ och ett .log tillägg. Välj lämplig ikon för att ladda ned loggfiler eller öppna dem i en webbläsare. Filnamnet innehåller ett unikt suffix som identifierar App Service-instansen. Om din App Service-instans finns på fler än en dator finns det separata loggfiler för varje dator. När uppladdaren identifierar en ny minidumpfil registreras den i loggfilen. Här är ett exempel på en lyckad ögonblicksbild och uppladdning:

SnapshotUploader.exe Information: 0 : Received Fork request ID 139e411a23934dc0b9ea08a626db16c5 from process 6368 (Low pri)
    DateTime=2018-03-09T01:42:41.8571711Z
SnapshotUploader.exe Information: 0 : Creating minidump from Fork request ID 139e411a23934dc0b9ea08a626db16c5 from process 6368 (Low pri)
    DateTime=2018-03-09T01:42:41.8571711Z
SnapshotUploader.exe Information: 0 : Dump placeholder file created: 139e411a23934dc0b9ea08a626db16c5.dm_
    DateTime=2018-03-09T01:42:41.8728496Z
SnapshotUploader.exe Information: 0 : Dump available 139e411a23934dc0b9ea08a626db16c5.dmp
    DateTime=2018-03-09T01:42:45.7525022Z
SnapshotUploader.exe Information: 0 : Successfully wrote minidump to D:\local\Temp\Dumps\c12a605e73c44346a984e00000000000\139e411a23934dc0b9ea08a626db16c5.dmp
    DateTime=2018-03-09T01:42:45.7681360Z
SnapshotUploader.exe Information: 0 : Uploading D:\local\Temp\Dumps\c12a605e73c44346a984e00000000000\139e411a23934dc0b9ea08a626db16c5.dmp, 214.42 MB (uncompressed)
    DateTime=2018-03-09T01:42:45.7681360Z
SnapshotUploader.exe Information: 0 : Upload successful. Compressed size 86.56 MB
    DateTime=2018-03-09T01:42:59.6184651Z
SnapshotUploader.exe Information: 0 : Extracting PDB info from D:\local\Temp\Dumps\c12a605e73c44346a984e00000000000\139e411a23934dc0b9ea08a626db16c5.dmp.
    DateTime=2018-03-09T01:42:59.6184651Z
SnapshotUploader.exe Information: 0 : Matched 2 PDB(s) with local files.
    DateTime=2018-03-09T01:42:59.6809606Z
SnapshotUploader.exe Information: 0 : Stamp does not want any of our matched PDBs.
    DateTime=2018-03-09T01:42:59.8059929Z
SnapshotUploader.exe Information: 0 : Deleted D:\local\Temp\Dumps\c12a605e73c44346a984e00000000000\139e411a23934dc0b9ea08a626db16c5.dmp
    DateTime=2018-03-09T01:42:59.8530649Z

Kommentar

Exemplet ovan är från version 1.2.0 av Microsoft.ApplicationInsights.SnapshotCollector NuGet-paketet. I tidigare versioner anropas MinidumpUploader.exe uppladdningsprocessen och loggen är mindre detaljerad.

I föregående exempel är c12a605e73c44346a984e00000000000instrumentationsnyckeln . Det här värdet ska matcha instrumentationsnyckeln för ditt program. Minidämparen är associerad med en ögonblicksbild med ID:t 139e411a23934dc0b9ea08a626db16c5. Du kan använda det här ID:t senare för att hitta den associerade undantagsposten i Application Insights Analytics.

Uppladdaren söker efter nya PDF-filer ungefär en gång var 15:e minut. Här är ett exempel:

SnapshotUploader.exe Information: 0 : PDB rescan requested.
    DateTime=2018-03-09T01:47:19.4457768Z
SnapshotUploader.exe Information: 0 : Scanning D:\home\site\wwwroot for local PDBs.
    DateTime=2018-03-09T01:47:19.4457768Z
SnapshotUploader.exe Information: 0 : Local PDB scan complete. Found 2 PDB(s).
    DateTime=2018-03-09T01:47:19.4614027Z
SnapshotUploader.exe Information: 0 : Deleted PDB scan marker : D:\local\Temp\Dumps\c12a605e73c44346a984e00000000000\6368.pdbscan
    DateTime=2018-03-09T01:47:19.4614027Z

För program som inte finns i App Service finns uppladdningsloggarna i samma mapp som minidumparna: %TEMP%\Dumps\<ikey> (var <ikey> är instrumentationsnyckeln).

Felsöka Cloud Services

I Cloud Services kan den tillfälliga standardmappen vara för liten för att innehålla minidump-filerna, vilket leder till förlorade ögonblicksbilder.

Det utrymme som behövs beror på programmets totala arbetsuppsättning och antalet samtidiga ögonblicksbilder.

Arbetsuppsättningen för en 32-bitars ASP.NET webbroll är vanligtvis mellan 200 MB och 500 MB. Tillåt minst två samtidiga ögonblicksbilder.

Om ditt program till exempel använder 1 GB av den totala arbetsuppsättningen bör du se till att det finns minst 2 GB diskutrymme för att lagra ögonblicksbilder.

Följ de här stegen för att konfigurera molntjänstrollen med en dedikerad lokal resurs för ögonblicksbilder.

Lägg till en ny lokal resurs i molntjänsten genom att redigera cloud service-definitionsfilen (.csdef). I följande exempel definieras en resurs som heter SnapshotStore med storleken 5 GB.
```
<LocalResources>
  <LocalStorage name="SnapshotStore" cleanOnRoleRecycle="false" sizeInMB="5120" />
</LocalResources>
```

Ändra startkoden för din roll för att lägga till en miljövariabel som pekar på den lokala resursen SnapshotStore . För Arbetsroller ska koden läggas till i din rolls OnStart -metod:

public override bool OnStart()
{
    Environment.SetEnvironmentVariable("SNAPSHOTSTORE", RoleEnvironment.GetLocalResource("SnapshotStore").RootPath);
    return base.OnStart();
}

För webbroller (ASP.NET) ska koden läggas till i webbprogrammets Application_Start metod:

using Microsoft.WindowsAzure.ServiceRuntime;
using System;

namespace MyWebRoleApp
{
    public class MyMvcApplication : System.Web.HttpApplication
    {
       protected void Application_Start()
       {
          Environment.SetEnvironmentVariable("SNAPSHOTSTORE", RoleEnvironment.GetLocalResource("SnapshotStore").RootPath);
          // TODO: The rest of your application startup code
       }
    }
}

Uppdatera ApplicationInsights.config-filen för din roll för att åsidosätta den tillfälliga mappplatsen som används av SnapshotCollector.

<TelemetryProcessors>
 <Add Type="Microsoft.ApplicationInsights.SnapshotCollector.SnapshotCollectorTelemetryProcessor, Microsoft.ApplicationInsights.SnapshotCollector">
   <!-- Use the SnapshotStore local resource for snapshots -->
   <TempFolder>%SNAPSHOTSTORE%</TempFolder>
   <!-- Other SnapshotCollector configuration options -->
 </Add>
</TelemetryProcessors>

Åsidosätt mappen Shadow Copy

När ögonblicksbildinsamlaren startar försöker den hitta en mapp på disken som är lämplig för att köra uppladdningsprocessen för ögonblicksbilder. Den valda mappen kallas för mappen Shadow Copy.

Ögonblicksbildinsamlaren kontrollerar några välkända platser och ser till att den har behörighet att kopiera binärfilerna för uppladdning av ögonblicksbilder. Följande miljövariabler används:

Fabric_Folder_App_Temp
LOCALAPPDATA
APPDATA
TEMP

Om det inte går att hitta en lämplig mapp rapporterar Snapshot Collector ett fel med texten "Det gick inte att hitta en lämplig mapp för skuggkopiering".

Om kopieringen misslyckas rapporterar Snapshot Collector ett ShadowCopyFailed fel.

Om uppladdaren inte kan startas rapporterar Snapshot Collector ett UploaderCannotStartFromShadowCopy fel. Meddelandets brödtext innehåller System.UnauthorizedAccessExceptionofta . Det här felet uppstår vanligtvis eftersom programmet körs under ett konto med begränsad behörighet. Kontot har behörighet att skriva till mappen skuggkopia, men det har inte behörighet att köra kod.

Eftersom dessa fel vanligtvis inträffar under starten följs de vanligtvis av ett ExceptionDuringConnect fel som säger "Uppladdaren kunde inte starta".

Om du vill kringgå dessa fel kan du ange mappen för skuggkopiering manuellt via konfigurationsalternativet ShadowCopyFolder . Du kan till exempel använda ApplicationInsights.config:

<TelemetryProcessors>
 <Add Type="Microsoft.ApplicationInsights.SnapshotCollector.SnapshotCollectorTelemetryProcessor, Microsoft.ApplicationInsights.SnapshotCollector">
   <!-- Override the default shadow copy folder. -->
   <ShadowCopyFolder>D:\SnapshotUploader</ShadowCopyFolder>
   <!-- Other SnapshotCollector configuration options -->
 </Add>
</TelemetryProcessors>

Eller om du använder appsettings.json med ett .NET Core-program:

{
  "ApplicationInsights": {
    "InstrumentationKey": "<your instrumentation key>"
  },
  "SnapshotCollectorConfiguration": {
    "ShadowCopyFolder": "D:\\SnapshotUploader"
  }
}

Använda Application Insights-sökning för att hitta undantag med ögonblicksbilder

När en ögonblicksbild skapas taggas utlöse undantaget med ett ögonblicksbilds-ID. Det ögonblicksbilds-ID:t ingår som en anpassad egenskap när undantaget rapporteras till Application Insights. Med Hjälp av Sök i Application Insights kan du hitta alla poster med den ai.snapshot.id anpassade egenskapen.

Bläddra till din Application Insights-resurs i Azure Portal.
Välj Sök.
Skriv ai.snapshot.id i textrutan Sök och tryck på Retur.

Om den här sökningen inte returnerar några resultat rapporterades inga ögonblicksbilder till Application Insights i det valda tidsintervallet.

Om du vill söka efter ett specifikt ögonblicksbilds-ID från uppladdningsloggarna skriver du det ID:t i sökrutan. Om du inte hittar poster för en ögonblicksbild som du vet har laddats upp följer du dessa steg:

Kontrollera att du tittar på rätt Application Insights-resurs genom att verifiera instrumentationsnyckeln.
Justera tidsintervallfiltret för sökningen för att täcka det tidsintervallet med hjälp av tidsstämpeln från uppladdningsloggen.

Om du fortfarande inte ser något undantag med det ögonblicksbilds-ID:t rapporterades inte undantagsposten till Application Insights. Den här situationen kan inträffa om programmet kraschade efter att det tog ögonblicksbilden men innan den rapporterade undantagsposten. I det här fallet kontrollerar du App Service-loggarna under Diagnose and solve problems för att se om det fanns oväntade omstarter eller ohanterade undantag.

Redigera nätverksproxy eller brandväggsregler

Om ditt program ansluter till Internet via en proxy eller en brandvägg kan du behöva uppdatera reglerna för att kommunicera med tjänsten Snapshot Debugger.

IP-adresser som används av Application Insights Snapshot Debugger ingår i Azure Monitor-tjänsttaggen. Mer information finns i dokumentationen om tjänsttaggar.

Kontakta oss för att få hjälp

Om du har frågor eller behöver hjälp skapar du en supportförfrågan eller frågar Azure community support. Du kan också skicka produktfeedback till Azure-feedbackcommunityn.

Dela via

Felsöka problem med att aktivera Application Insights Snapshot Debugger eller visa ögonblicksbilder

Scenarier som inte stöds

Kontrollera att du använder rätt slutpunkt för ögonblicksbildsfelsökaren

Använd hälsokontrollen med ögonblicksbilder

Verifiera instrumentationsnyckeln

Kontrollera TLS/SSL-klientinställningar (ASP.NET)

Förhandsversioner av .NET Core

Kontrollera statussidan för diagnostiktjänstwebbplatstillägget

Uppgradera till den senaste versionen av NuGet-paketet

Kontrollera uppladdningsloggarna

Felsöka Cloud Services

Åsidosätt mappen Shadow Copy

Använda Application Insights-sökning för att hitta undantag med ögonblicksbilder

Redigera nätverksproxy eller brandväggsregler

Kontakta oss för att få hjälp

Feedback

Ytterligare resurser