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

Artikel
01/23/2025

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 går inte att skapa ögonblicksbilder på grund av många olika orsaker. 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

Scenarier där ögonblicksbildinsamlaren inte stöds:

Scenario	Sidoeffekter	Rekommendation
När du använder SDK:et för ögonblicksbildinsamlaren i ditt program direkt (.csproj) och du har aktiverat alternativet Interop för förskott.	Den lokala Application Insights SDK (inklusive telemetri för ögonblicksbildinsamlaren) går förlorad, och därför är inga ögonblicksbilder tillgängliga. Programmet kan krascha vid start med `System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor`. Mer information om Application Insights-funktionen Interop finns i dokumentationen .	Om du använder förköpsalternativet Interop använder du den kodlösa inmatningen av ögonblicksbildinsamlaren som är aktiverad via Azure Portal.

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

För närvarande är de enda regioner som kräver slutpunktsändringar Azure Government och Microsoft Azure som drivs av 21Vianet.

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

Egenskap för 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 måste du uppdatera host.json med hjälp av de åsidosättningar som stöds:

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

Exempel på host.json uppdaterat 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ända hälsokontrollen för ögonblicksbilder

Flera vanliga problem gör att knappen Öppna ögonblicksbild av felsökning inte visas. Till exempel:

Använda en inaktuell ögonblicksbildinsamlare
Når den dagliga uppladdningsgränsen
Ögonblicksbilden tar bara lång tid att ladda upp.

Gå till hälsokontrollen för ögonblicksbilder för att felsöka vanliga problem via en länk i fönstret Undantag i spårningsvyn från slutpunkt till slutpunkt.

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.

Kommentar

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 inte 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 högre.

<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 avgör Windows de tillgängliga protokollen. 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.

Overheadscenarier för felsökning av ögonblicksbilder

Felsökningsprogrammet för ögonblicksbilder är utformat för användning i produktionsmiljöer. Standardinställningarna innehåller hastighetsbegränsningar för att minimera påverkan på dina program.

Du kan dock uppleva små processor-, minnes- och I/O-omkostnader som är associerade med felsökningsprogrammet för ögonblicksbilder, till exempel i följande scenarier.

När ett undantag utlöses i programmet:

När du skapar en signatur för problemtypen och bestämmer om du vill skapa en ögonblicksbild läggs en liten processor- och minnesbelastning till.
Om avoptimisering är aktiverat finns det ett omkostnader för att om-JITting metoden som utlöste undantaget. Detta uppstår nästa gång metoden körs. Beroende på metodens storlek kan den vara mellan 1 ms och 100 ms cpu-tid.

Om undantagshanteraren bestämmer sig för att skapa en ögonblicksbild:

Det tar ungefär en halv sekund att skapa processögonblicksbilden (P50 = 0,3 s, P90 = 1,2 s, P95 = 1,9 s) under vilken tid tråden som kastade undantaget pausas. Andra trådar blockeras inte.
Det tar flera minuter att konvertera processögonblicksbilden till en miniduplicering och ladda upp den till Application Insights.
- Konvertera: P50 = 63 s, P90 = 187 s, P95 = 275 s.
- Ladda upp: P50 = 31 s, P90 = 75 s, P95 = 98 s.
Detta görs i Snapshot Uploader, som körs i en separat process. Snapshot Uploader-processen körs under normal CPU-prioritet och använder I/O med låg prioritet.

Minidämparen skrivs först till disken och mängden diskutrymme är ungefär densamma som den ursprungliga processens arbetsuppsättning. Att skriva minidämparen kan orsaka sidfel när minnet läss.

Minidatorn komprimeras under uppladdningen, vilket förbrukar både CPU och minne i uppladdningsprocessen för ögonblicksbilder. Processor-, minnes- och diskomkostnaderna är proportionella mot storleken på processögonblicksbilden. Snapshot Uploader bearbetar ögonblicksbilder seriellt.

När TrackException anropas:

Felsökningsprogrammet för ögonblicksbilder kontrollerar om undantaget är nytt eller om en ögonblicksbild har skapats för det. Detta lägger till en liten CPU-belastning.

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 är samma som Kudu-hanteringswebbplatsen för App Service. På statussidan visas installationstillståndet för .NET Profiler - och Snapshot Collector-agenterna. Om det uppstod ett oväntat fel visas 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 följande i URL:en /DiagnosticServices och trycker på Retur. 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

Föregående exempel ä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.

Konfigurera din molntjänstroll 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 rollens ApplicationInsights.config-fil för att åsidosätta den temporära mappplats 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ätta 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 ofta av ett ExceptionDuringConnect fel som säger att Uppladdaren inte kunde 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.
Med tidsstämpeln från uppladdningsloggen justerar du tidsintervallfiltret för sökningen för att täcka det tidsintervallet.

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.

Finns det några faktureringskostnader när du använder ögonblicksbilder?

Det finns inga avgifter för din prenumeration som är specifika för Snapshot Debugger. Ögonblicksbildfilerna som samlas in lagras separat från telemetrin som samlas in av Application Insights SDK:er och det tillkommer inga avgifter för inmatning eller lagring av ögonblicksbilder.

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ända hälsokontrollen för ögonblicksbilder

Verifiera instrumentationsnyckeln

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

Overheadscenarier för felsökning av ögonblicksbilder

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ätta mappen Shadow Copy

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

Redigera nätverksproxy eller brandväggsregler

Finns det några faktureringskostnader när du använder ögonblicksbilder?

Feedback

Ytterligare resurser