Delen via

Fouten, prestaties en transacties onderzoeken met Application Insights

Application Insights verzamelt telemetrie van uw toepassing om fouten te diagnosticeren en trage transacties te onderzoeken. Het bevat vier essentiële hulpprogramma's:

  • Fouten : houdt fouten, uitzonderingen en fouten bij, wat duidelijke inzichten biedt voor snelle probleemoplossing en verbeterde stabiliteit.

  • Prestaties : identificeert en helpt toepassingsknelpunten snel op te lossen door reactietijden en aantal bewerkingen weer te geven.

  • Zoeken naar transacties: hiermee kunnen gebruikers afzonderlijke telemetrie-items zoeken en onderzoeken, zoals paginaweergaven, uitzonderingen en aangepaste gebeurtenissen.

  • Diagnostische gegevens over transacties: helpt bij het snel identificeren van problemen in onderdelen via uitgebreid inzicht in end-to-end transactiegegevens.

Samen zorgen deze hulpprogramma's voor de voortdurende gezondheid en efficiëntie van webtoepassingen. U kunt ze gebruiken om problemen of verbeteringen aan te geven die het meest van invloed zijn op gebruikers.

Als u naar de weergave Fouten in Application Insights wilt gaan, selecteert u de grafiek Mislukte aanvragen in het deelvenster Overzicht of Fouten onder de categorie Onderzoeken in het resourcemenu.

Schermopname van het bereiken van de weergave Fouten in Application Insights.

U kunt ook naar de foutenweergave in de Toepassingsoverzicht gaan door een resource te selecteren en vervolgens fouten te onderzoeken in de triagesectie.

Opmerking

U hebt toegang tot transactiediagnose via een van de andere drie ervaringen. Zie Telemetrie onderzoeken voor meer informatie.

Overzicht

In de weergave Fouten ziet u een lijst met alle mislukte bewerkingen die voor uw toepassing zijn verzameld, met de optie om in te zoomen op elke bewerking. Hiermee kunt u hun frequentie en het aantal betrokken gebruikers bekijken, zodat u zich kunt concentreren op de problemen met de hoogste impact.

Schermopname van de weergave Fouten in Application Insights.

Opmerking

Naast de out-of-the-box telemetrie die wordt verzonden door de Azure Monitor OpenTelemetry Distro of JavaScript SDK, kunt u telemetrie toevoegen en wijzigen (bijvoorbeeld aangepaste gebeurtenissen).

Zie Azure Monitor OpenTelemetry toevoegen en wijzigen voor .NET-, Java-, Node.js- en Python-toepassingen voor meer informatie.

Telemetrie filteren

Standaardfilters

Met alle ervaringen kunt u telemetrie filteren op tijdsbereik. Bovendien wordt elke ervaring geleverd met een eigen standaardfilter:

U kunt selecteren welke service (cloudrolnaam) of machine/container (cloudrolinstantie) u wilt weergeven in het menu Rollenfilter . Hiermee kunt u problemen of prestatietrends isoleren binnen specifieke onderdelen van uw toepassing.

Zie Azure Monitor OpenTelemetry configureren om te leren hoe je de naam van de cloudrol en het cloudrolexemplaar kunt instellen.

Filters toevoegen

U kunt gebeurtenissen filteren op de waarden van hun eigenschappen. De beschikbare eigenschappen zijn afhankelijk van de gebeurtenis- of telemetrietypen die u hebt geselecteerd. Een filter toevoegen:

  1. Selecteer filterpictogram om een filter toe te voegen.

    Filterpil

  2. Selecteer een eigenschap in de vervolgkeuzelijst links.

  3. Selecteer in de middelste vervolgkeuzelijst een van de volgende operators: =, !=, containsof not contains.

  4. Selecteer in de rechter vervolgkeuzelijst alle eigenschapswaarden waarop u wilt filteren.

    Opmerking

    U ziet dat de aantallen rechts van de filterwaarden aangeven hoeveel exemplaren er zijn in de huidige gefilterde set.

  5. Als u nog een filter wilt toevoegen, selecteert u het filterpictogram opnieuw.

Telemetrie doorzoeken

U kunt zoeken naar specifieke bewerkingen met behulp van het veld Zoeken om items te filteren... boven de lijst met bewerkingen.

Schermopname van het veld Zoeken.

Analysegegevens gebruiken

Alle gegevens die door Application Insights worden verzameld, worden opgeslagen in Log Analytics, die een uitgebreide querytaal biedt voor het analyseren van de aanvragen die de uitzondering hebben gegenereerd die u onderzoekt.

Aanbeveling

Eenvoudige modus in Log Analytics biedt een intuïtieve interface voor het analyseren en visualiseren van logboekgegevens.

  1. In de prestatieweergave, foutenweergave of zoekweergave voor transacties selecteert u Weergeven in logboeken via de bovenste navigatiebalk en kiest u een query uit het dropdownmenu.

    Schermopname van de bovenste actiebalk met de knop Weergeven in logboeken gemarkeerd.

  2. Hiermee gaat u naar de weergave Logboeken , waar u de query verder kunt wijzigen of een andere kunt selecteren in de zijbalk.

    Schermopname van de weergave Logboeken.

Telemetrie onderzoeken

Als u de hoofdoorzaak van een fout of uitzondering wilt onderzoeken, kunt u inzoomen op de problematische bewerking voor een gedetailleerde end-to-end transactiedetailsweergave met afhankelijkheden en uitzonderingsdetails.

  1. Selecteer een bewerking om de top 3-antwoordcodes, top 3-uitzonderingstypen en top 3 mislukte afhankelijkheden voor die bewerking weer te geven.

  2. Selecteer onder Inzoomen de knop met het aantal gefilterde resultaten om een lijst met voorbeeldbewerkingen weer te geven.

  3. Selecteer een voorbeeldopeartie om de weergave van de details van de end-to-end transactie te openen.

    Schermopname van de weergave Fouten met de knop Inzoomen gemarkeerd.

    Opmerking

    De voorgestelde voorbeelden hebben gerelateerde telemetrie van alle onderdelen, zelfs als er steekproeven van kracht waren in een van deze onderdelen.

Prestaties en fouten aan de clientzijde analyseren

Als u uw webpagina's instrumenteren met Application Insights, kunt u inzicht krijgen in paginaweergaven, browserbewerkingen en afhankelijkheden. Voor het verzamelen van deze browsergegevens moet u een script toevoegen aan uw webpagina's.

  1. Nadat u het script hebt toegevoegd, hebt u toegang tot paginaweergaven en de bijbehorende prestatiemetrieken door de wisselknop Browser te selecteren in de weergave Prestaties of Fouten .

    Schermopname met de wisselknop 'Server/browser' onder de bovenste actiebalk.

    Deze weergave biedt een visueel overzicht van verschillende telemetrieën van uw toepassing vanuit het perspectief van de browser.

  2. Voor browserbewerkingen toont de detailweergave van de end-to-end transactie de eigenschappen van de paginaweergave van de client die de pagina aanvraagt, inclusief het type browser en de locatie. Deze informatie kan helpen bepalen of er prestatieproblemen zijn met betrekking tot bepaalde typen clients.

    Schermopname van de weergave End-to-end transactiedetails met de sectie Paginaweergave-eigenschappen gemarkeerd.

Opmerking

Net als de gegevens die worden verzameld voor serverprestaties, maakt Application Insights alle clientgegevens beschikbaar voor grondige analyse met behulp van logboeken.

Ervaring met diagnostische gegevens over transacties

De ervaring voor transactiediagnose , ook wel end-to-end transactiedetailsweergave genoemd, toont een Gantt-diagram van de transactie, waarin alle gebeurtenissen met hun duur en antwoordcode worden vermeld.

Deze diagnostische ervaring correleert automatisch telemetrie aan de serverzijde van al uw door Application Insights bewaakte onderdelen in één weergave en ondersteunt meerdere resources. Application Insights detecteert de onderliggende relatie en stelt u in staat om eenvoudig een diagnose te stellen van het toepassingsonderdeel, de afhankelijkheid of de uitzondering die een transactievertraging of -fout heeft veroorzaakt.

Als u een specifieke gebeurtenis selecteert, worden de eigenschappen ervan weergegeven, inclusief aanvullende informatie, zoals de onderliggende opdracht of aanroepstack.

Deze weergave heeft vier belangrijke onderdelen:

Schermopname van de transactieweergave met de lijst met resultaten gemarkeerd.

In dit samenvouwbare deelvenster worden de andere resultaten weergegeven die voldoen aan de filtercriteria. Selecteer een resultaat om de betreffende details van de voorgaande drie secties bij te werken. We proberen voorbeelden te vinden die waarschijnlijk de details van alle onderdelen beschikbaar hebben, zelfs als steekproeven van kracht zijn in een van deze onderdelen. Deze voorbeelden worden weergegeven als suggesties.

Foutopsporingsprogramma voor .NET Profiler en Snapshot Debugger

.NET Profiler of Snapshot Debugger helpt bij diagnostische gegevens op codeniveau van prestatie- en foutproblemen. Met deze ervaring kunt u .NET Profiler-traceringen of momentopnamen van elk onderdeel met één selectie bekijken.

Profiler-traceringen

De .NET Profiler helpt u verder te gaan met diagnostische gegevens op codeniveau door de werkelijke code weer te geven die is uitgevoerd voor de bewerking en de benodigde tijd voor elke stap. Sommige bewerkingen hebben mogelijk geen tracering omdat de Profiler periodiek wordt uitgevoerd. Meer bewerkingen zouden na verloop van tijd traceringen moeten bevatten.

  1. Als u .NET Profiler wilt starten, selecteert u een bewerking in de prestatieweergave en gaat u vervolgens naar Profiler-traceringen.

    Schermopname van de weergave 'Prestaties' met de knop Profiler-traceringen gemarkeerd.

    U kunt dit ook doen in de weergave van transactiedetails van begin tot eind.

    Schermopname van de weergave 'End-to-end transactiedetails' met de knop 'Profiler-traceringen' gemarkeerd.

  2. De tracering toont de afzonderlijke gebeurtenissen voor elke bewerking, zodat u de hoofdoorzaak tijdens de algehele bewerking kunt diagnosticeren. Selecteer een van de belangrijkste voorbeelden met de langste duur.

  3. Selecteer de koppeling in de prestatietip (in dit voorbeeld CPU-tijd) voor documentatie over het interpreteren van de gebeurtenis.

  4. Selecteer Trace downloaden om de tracering te downloaden voor verdere analyse. U kunt deze gegevens bekijken met behulp van PerfView.

    Schermopname van .NET Profiler.

    Opmerking

    Belangrijk pad is standaard geselecteerd. Het markeert het specifieke pad naar gebeurtenissen die bijdragen aan het probleem dat u onderzoekt, aangegeven door het vlampictogram naast de naam van de gebeurtenis.

Als u de .NET Profiler niet kunt laten werken, neemt u contact op met serviceprofilerhelp@microsoft.com.

Foutopsporingsmomentopname

Informatie over foutopsporing op codeniveau van een uitzondering bekijken:

  1. Selecteer de uitzondering in het Gantt-diagram en open de momentopname voor foutopsporing.

    Schermopname van de weergave End-to-end transactiedetails met de knop 'Momentopname voor foutopsporing openen' gemarkeerd.

  2. Snapshot Debugger toont de aanroepstack en stelt u in staat om variabelen te inspecteren op elk aanroepstackframe. Door een methode te selecteren, kunt u de waarden van alle lokale variabelen op het moment van de aanvraag bekijken.

  3. Daarna kunt u fouten in de broncode opsporen door de momentopname te downloaden en te openen in Visual Studio.

    Schermopname van Snapshot Debugger met de knop

Neem contact op met de contactpersoon snapshothelp@microsoft.comals u snapshot debugger niet kunt laten werken.

Een werkitem maken

Als u Application Insights verbindt met een traceringssysteem zoals Azure DevOps of GitHub, kunt u een werkitem maken met de details van elk telemetrie-item rechtstreeks vanuit Application Insights.

Opmerking

De eerste keer dat u deze stap uitvoert, wordt u gevraagd een koppeling te configureren naar uw Azure DevOps-organisatie en -project.

  1. Ga naar de detailweergave van de end-to-end transactie en selecteer een gebeurtenis.

  2. Selecteer in de sectie Detailshet werkitem maken en maak een nieuwe sjabloon of kies een bestaande sjabloon.

    Schermopname van de weergave End-to-end transactiedetails met de knop Werkitem maken gemarkeerd.

  3. Het deelvenster Nieuw werkitem wordt geopend met details over de uitzondering die al is ingevuld. U kunt meer informatie toevoegen voordat u deze opslaat.

Veelgestelde vragen

In deze sectie vindt u antwoorden op veelgestelde vragen.

Transactiezoekopdracht

Wat is een onderdeel?

Onderdelen zijn onafhankelijk te implementeren onderdelen van uw gedistribueerde of microservicetoepassing. Ontwikkelaars en operationele teams hebben zichtbaarheid op codeniveau of toegang tot telemetrie die door deze toepassingsonderdelen wordt gegenereerd.

  • Onderdelen verschillen van 'waargenomen' externe afhankelijkheden, zoals SQL en Event Hubs, waartoe uw team of organisatie mogelijk geen toegang heeft (code of telemetrie).
  • Onderdelen worden uitgevoerd op een willekeurig aantal server-, functie- of containerinstanties.
  • Onderdelen kunnen afzonderlijke Application Insights-instrumentatiesleutels zijn, zelfs als abonnementen verschillen. Onderdelen kunnen ook verschillende rollen zijn die rapporteren aan één Application Insights-instrumentatiesleutel. De nieuwe ervaring toont details over alle onderdelen, ongeacht hoe ze zijn ingesteld.

Hoeveel gegevens worden bewaard?

Zie de samenvatting Limieten.


Hoe zie ik POST-gegevens in mijn serveraanvragen?

We registreren de POST-gegevens niet automatisch, maar u kunt TrackTrace- of logboekaanroepen gebruiken. Plaats de POST-gegevens in de berichtparameter. U kunt niet op dezelfde manier filteren op het bericht als u op eigenschappen kunt filteren, maar de groottelimiet is langer.


Waarom retourneert mijn Azure Function-zoekopdracht geen resultaten?

In Azure Functions worden geen URL-queryreeksen vastgelegd.

Diagnostische gegevens over transacties

Waarom zie ik één onderdeel in de grafiek en de andere onderdelen worden alleen weergegeven als externe afhankelijkheden zonder details?

Mogelijke redenen:

  • Zijn de andere onderdelen geïnstrueerd met Application Insights?
  • Gebruiken ze de nieuwste stabiele Application Insights SDK?
  • Als deze onderdelen afzonderlijke Application Insights-resources zijn, controleert u of u toegang hebt. Als u wel toegang hebt en de onderdelen zijn geïnstrueerd met de nieuwste Application Insights SDK's, laat het ons dan weten via het feedbackkanaal in de rechterbovenhoek.

Ik zie dubbele rijen voor de afhankelijkheden. Wordt dit gedrag verwacht?

Op dit moment wordt de uitgaande afhankelijkheidsaanroep weergegeven, gescheiden van de binnenkomende aanvraag. Normaal gesproken zien de twee aanroepen er identiek uit, waarbij alleen de duurwaarde verschilt vanwege de retour van het netwerk. Het voorlooppictogram en de afzonderlijke stijl van de duurbalken helpen onderscheid te maken tussen deze balken. Is deze presentatie van de gegevens verwarrend? Geef ons uw feedback!


Hoe zit het met klokverschillen tussen verschillende componentinstanties?

Tijdlijnen worden aangepast voor scheeftrekken van de klok in het transactiediagram. U kunt de exacte tijdstempels zien in het detailvenster of met behulp van Log Analytics.


Waarom ontbreken bij de nieuwe ervaring de meeste gerelateerde items-zoekopdrachten?

Dit gedrag is opzettelijk ontworpen. Alle gerelateerde items, voor alle onderdelen, zijn al beschikbaar aan de linkerkant in de bovenste en onderste secties. De nieuwe ervaring bevat twee gerelateerde items die niet aan de linkerkant worden behandeld: alle telemetrie van vijf minuten vóór en na deze gebeurtenis en de tijdlijn van de gebruiker.


Is er een manier om minder gebeurtenissen per transactie te zien wanneer ik de JavaScript SDK van Application Insights gebruik?

De ervaring met diagnostische gegevens over transacties toont alle telemetrie in één bewerking die een bewerkings-id deelt. De Application Insights SDK voor JavaScript maakt standaard een nieuwe bewerking voor elke unieke paginaweergave. In een toepassing met één pagina (SPA) wordt slechts één paginaweergavegebeurtenis gegenereerd en wordt één bewerkings-id gebruikt voor alle gegenereerde telemetriegegevens. Als gevolg hiervan kunnen veel gebeurtenissen worden gecorreleerd aan dezelfde bewerking.

In deze scenario's kunt u Automatisch bijhouden van routes gebruiken om automatisch nieuwe bewerkingen te maken voor navigatie in uw BEVEILIGD-WACHTWOORDVERIFICATIE. U moet enableAutoRouteTracking inschakelen, zodat een paginaweergave wordt gegenereerd telkens wanneer de URL-route wordt bijgewerkt (logische paginaweergave vindt plaats). Als u de bewerkings-id handmatig wilt vernieuwen, roept u het aan appInsights.properties.context.telemetryTrace.traceID = Microsoft.ApplicationInsights.Telemetry.Util.generateW3CId(). Als u een PageView-gebeurtenis handmatig activeert, wordt ook de bewerkings-id opnieuw ingesteld.


Waarom worden de duur van transactiedetails niet opgetellen tot de duur van de bovenste aanvraag?

Tijd die niet wordt uitgelegd in het Gantt-diagram, is tijd die niet wordt gedekt door een bijgehouden afhankelijkheid. Dit probleem kan optreden omdat externe aanroepen niet automatisch of handmatig zijn geïnstrueerd. Dit kan ook gebeuren omdat de tijd die in het proces is genomen, in plaats van vanwege een externe aanroep.

Als alle aanroepen zijn geïnstrumenteerd, is dit de waarschijnlijke hoofdoorzaak voor de tijd die is besteed. Een handig hulpprogramma voor het diagnosticeren van het proces is de .NET Profiler.


Wat gebeurt er als ik het bericht 'Fout bij het ophalen van gegevens' zie tijdens het navigeren in Application Insights in Azure Portal?

Deze fout geeft aan dat de browser een vereiste API niet kan aanroepen of dat de API een foutreactie heeft geretourneerd. Als u problemen met het gedrag wilt oplossen, opent u een InPrivate-browservenster en schakelt u browserextensies uit die worden uitgevoerd, en identificeert u of u het portalgedrag nog steeds kunt reproduceren. Als de portalfout nog steeds optreedt, kunt u testen met andere browsers of andere computers, DNS- of andere netwerkgerelateerde problemen onderzoeken vanaf de clientcomputer waar de API-aanroepen mislukken. Als de portalfout zich blijft voordoen en verder moet worden onderzocht, verzamelt u een browsernetwerktracering tijdens het reproduceren van het onverwachte portalgedrag en opent u vervolgens een ondersteuningsaanvraag vanuit Azure Portal.

Volgende stappen