Fouten opsporen in uw toepassingen met Azure-toepassing Insights in Visual StudioDebug your applications with Azure Application Insights in Visual Studio

In Visual Studio (2015 en hoger) kunt u de prestaties analyseren en problemen in uw ASP.NET web-app identificeren tijdens de foutopsporing en algemeen gebruik. Dit gebeurt aan de hand van telemetrie uit Azure Application Insights.In Visual Studio (2015 and later), you can analyze performance and diagnose issues in your ASP.NET web app both in debugging and in production, using telemetry from Azure Application Insights.

Als u uw ASP.NET-web-app hebt gemaakt met Visual Studio 2017 of hoger, beschikt deze al over de Application Insights-SDK.If you created your ASP.NET web app using Visual Studio 2017 or later, it already has the Application Insights SDK. Anders voegt u Application Insights aan uw app toe als u dit nog niet hebt gedaan.Otherwise, if you haven't done so already, add Application Insights to your app.

Als uw app wilt bewaken wanneer deze in live productie is, bekijkt u normaal gesproken de Application Insights-telemetrie in de Azure-portal, waar u waarschuwingen kunt instellen en krachtige bewakingsprogramma's kunt toepassen.To monitor your app when it's in live production, you normally view the Application Insights telemetry in the Azure portal, where you can set alerts and apply powerful monitoring tools. Voor foutopsporing kunt u echter ook de telemetrie in Visual Studio zoeken en analyseren.But for debugging, you can also search and analyze the telemetry in Visual Studio. U kunt Visual Studio gebruiken om telemetrie te analyseren van uw productie site en van fout opsporing wordt uitgevoerd op uw ontwikkel computer.You can use Visual Studio to analyze telemetry both from your production site and from debugging runs on your development machine. In het laatste geval kunt u foutopsporingsruns al analyseren nog voordat u de SDK hebt geconfigureerd om telemetrie naar de Azure-portal te verzenden.In the latter case, you can analyze debugging runs even if you haven't yet configured the SDK to send telemetry to the Azure portal.

Fouten opsporen in uw projectDebug your project

Voer uw web-app in de lokale foutopsporingsmodus door op F5 te drukken.Run your web app in local debug mode by using F5. Open verschillende pagina's om telemetrie te genereren.Open different pages to generate some telemetry.

In Visual Studio ziet u het aantal gebeurtenissen dat is vastgelegd door de module Application Insights in uw project.In Visual Studio, you see a count of the events that have been logged by the Application Insights module in your project.

Tijdens het opsporen van fouten wordt in Visual Studio de knop Application Insights weergegeven.

Klik op deze knop om uw telemetrie te doorzoeken.Click this button to search your telemetry.

In het zoekvenster van Application Insights worden geregistreerde gebeurtenissen weergegeven.The Application Insights Search window shows events that have been logged. (Als u zich bij het instellen van Application Insights hebt aangemeld bij Azure, kunt u dezelfde gebeurtenissen in de Azure Portal zoeken.)(If you signed in to Azure when you set up Application Insights, you can search the same events in the Azure portal.)

Klik met de rechtermuisknop op het project en kies Application Insights > Zoeken.

Notitie

Nadat u filters hebt in- of uitgeschakeld, klikt u op de knop Zoeken aan het einde van het veld Tekst zoeken.After you select or deselect filters, click the Search button at the end of the text search field.

U kunt zoeken met vrije tekst gebruiken voor alle velden in de gebeurtenissen.The free text search works on any fields in the events. Zoek bijvoorbeeld naar een deel van de URl van een pagina, naar de waarde van een eigenschap, zoals de clientlocatie, of naar specifieke woorden in een traceringslogboek.For example, search for part of the URL of a page; or the value of a property such as client city; or specific words in a trace log.

Klik op een gebeurtenis om de gedetailleerde eigenschappen ervan weer te geven.Click any event to see its detailed properties.

Voor aanvragen voor uw web-app, kunt u verder klikken naar de code.For requests to your web app, you can click through to the code.

Klik onder Aanvraagdetails door naar de code

U kunt ook de Verwante items openen om mislukte aanvragen of uitzonderingen te diagnosticeren.You can also open related items to help diagnose failed requests or exceptions.

Blader onder Aanvraagdetails naar beneden, naar gerelateerde items

Uitzonde ringen en mislukte aanvragen weer gevenView exceptions and failed requests

Uitzonderingsrapporten worden weergegeven in het venster Zoeken.Exception reports show in the Search window. (In enkele oudere typen ASP.NET-toepassingen moet u uitzonderingencontrole instellen om te zien welke uitzonderingen door het framework worden afgehandeld.)(In some older types of ASP.NET application, you have to set up exception monitoring to see exceptions that are handled by the framework.)

Klik op een uitzondering voor een stack-trace.Click an exception to get a stack trace. Als de code van de app in Visual Studio is geopend, kunt u via de stack-trace doorklikken naar de relevante coderegel.If the code of the app is open in Visual Studio, you can click through from the stack trace to the relevant line of the code.

Scherm afbeelding toont het object about in een stack-trace.

Samen vattingen van aanvragen en uitzonde ringen in de code weer gevenView request and exception summaries in the code

In de lens regel van de code boven elke handler-methode ziet u het aantal aanvragen en uitzonde ringen dat door Application Insights in de afgelopen 24 uur is geregistreerd.In the Code Lens line above each handler method, you see a count of the requests and exceptions logged by Application Insights in the past 24 h.

Scherm afbeelding toont een uitzonde ring in het dialoog venster context.

Notitie

Code Lens toont alleen Application Insights-gegevens als u uw app hebt geconfigureerd om telemetrie te verzenden naar de Application Insights-portal.Code Lens shows Application Insights data only if you have configured your app to send telemetry to the Application Insights portal.

Meer informatie over Application Insights in Code LensMore about Application Insights in Code Lens

Trends is een hulpprogramma waarmee u de werking van uw app gedurende een bepaalde periode kunt visualiseren.Trends is a tool for visualizing how your app behaves over time.

Kies Telemetrietrends verkennen op de Application Insights-werkbalkknop of in het Application Insights-zoekvenster.Choose Explore Telemetry Trends from the Application Insights toolbar button or Application Insights Search window. Kies een van de vijf algemene query's om te beginnen.Choose one of five common queries to get started. U kunt verschillende gegevenssets analyseren op basis van telemetrietypen, tijdsbereik en andere eigenschappen.You can analyze different datasets based on telemetry types, time ranges, and other properties.

Als u wilt zoeken naar afwijkingen in uw gegevens, kiest u een van de afwijkingsopties onder de vervolgkeuzelijst Type weergave.To find anomalies in your data, choose one of the anomaly options under the "View Type" dropdown. Met de filteropties aan de onderkant van het venster kunt u eenvoudig specifieke subreeksen van uw telemetrie selecteren.The filtering options at the bottom of the window make it easy to hone in on specific subsets of your telemetry.

Trends

Meer informatie over Trends.More about Trends.

Lokale bewakingLocal monitoring

(Uit Visual Studio 2015 update 2) Als u de SDK niet hebt geconfigureerd voor het verzenden van telemetrie naar de Application Insights Portal (zodat er geen instrumentatie sleutel in ApplicationInsights.config is), wordt in het venster diagnostische gegevens telemetrie van uw nieuwste foutopsporingssessie weer gegeven.(From Visual Studio 2015 Update 2) If you haven't configured the SDK to send telemetry to the Application Insights portal (so that there is no instrumentation key in ApplicationInsights.config) then the diagnostics window displays telemetry from your latest debugging session.

Dit is handig als u al een eerdere versie van uw app hebt gepubliceerd.This is desirable if you have already published a previous version of your app. Zo voorkomt u dat de telemetrie van uw foutopsporingssessies in de Application Insights-portal wordt verward met de telemetrie over de gepubliceerde app.You don't want the telemetry from your debugging sessions to be mixed up with the telemetry on the Application Insights portal from the published app.

Ook als u beschikt over aangepaste telemetrie waarin u fouten wilt opsporen voordat u deze naar de portal verzendt, komt deze functie van pas.It's also useful if you have some custom telemetry that you want to debug before sending telemetry to the portal.

  • In eerste instantie heb ik Application Insights voor het verzenden van telemetrie naar de portal volledig geconfigureerd. Maar nu wil ik de telemetrie alleen bekijken in Visual Studio.At first, I fully configured Application Insights to send telemetry to the portal. But now I'd like to see the telemetry only in Visual Studio.

    • De instellingen van het venster Zoeken bevat een optie om lokale diagnostische gegevens te doorzoeken, zelfs als uw app telemetrie verzendt naar de portal.In the Search window's Settings, there's an option to search local diagnostics even if your app sends telemetry to the portal.
    • Als u wilt stoppen met het verzenden van telemetrie naar de portal, kunt u de regel <instrumentationkey>... van ApplicationInsights.config afmelden. Als u klaar bent om telemetrie naar de portal te verzenden, moet u de opmerking opheffen.To stop telemetry being sent to the portal, comment out the line <instrumentationkey>... from ApplicationInsights.config. When you're ready to send telemetry to the portal again, uncomment it.

Volgende stappenNext steps