Felsöka dina program med Azure Application insikter i Visual StudioDebug your applications with Azure Application Insights in Visual Studio

I Visual Studio (2015 och senare) kan du analysera prestanda och diagnostisera problem i din ASP.NET-webbapp både när du felsöker och i produktion med hjälp av telemetri från 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.

Om du har skapat din ASP.NET-webbapp med Visual Studio 2017 eller senare har den redan Application Insights SDK.If you created your ASP.NET web app using Visual Studio 2017 or later, it already has the Application Insights SDK. I annat fall lägger du till Application Insights i din app, om du inte redan gjort det.Otherwise, if you haven't done so already, add Application Insights to your app.

När appen är live i produktion visar du normalt Application Insights-telemetrin på Azure Portal. Där kan du också ställa in aviseringar och använda kraftfulla övervakningsverktyg.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. Men när det gäller felsökning kan du också söka efter och analysera telemetri i Visual Studio.But for debugging, you can also search and analyze the telemetry in Visual Studio. Du kan använda Visual Studio för att analysera telemetri både från din produktions plats och från fel söknings körningar på din utvecklings dator.You can use Visual Studio to analyze telemetry both from your production site and from debugging runs on your development machine. I det senare fallet kan du analysera felsökningskörningar även om du inte har konfigurerat SDK för att skicka telemetri till Azure Portal ännu.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.

Felsöka ditt projektDebug your project

Kör din webbapp i lokalt felsökningsläge genom att välja F5.Run your web app in local debug mode by using F5. Öppna olika sidor för att skapa viss telemetri.Open different pages to generate some telemetry.

I Visual Studio visas ett antal händelser som har loggats av Application Insights-modulen i projektet.In Visual Studio, you see a count of the events that have been logged by the Application Insights module in your project.

Knappen Application Insights visas under felsökningar i Visual Studio.

Klicka på den här knappen om du vill söka i telemetri.Click this button to search your telemetry.

I sökfönstret för Application Insights visas händelser som har loggats.The Application Insights Search window shows events that have been logged. (Om du har loggat in på Azure när du konfigurerar Application Insights kan du söka i samma händelser i Azure Portal.)(If you signed in to Azure when you set up Application Insights, you can search the same events in the Azure portal.)

Högerklicka på projektet och välj Application Insights, Sök

Anteckning

När du har markerat eller avmarkerat filter klickar du på knappen Sök i slutet av sökfältet.After you select or deselect filters, click the Search button at the end of the text search field.

Fritextsökningen fungerar för alla fält i händelserna.The free text search works on any fields in the events. Du kan till exempel söka efter en del av URL-adressen för en sida, efter värdet för en egenskap, t.ex. klientens stad, eller efter specifika ord i en spårningslogg.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.

Klicka på en händelse om du vill visa händelsens detaljerade egenskaper.Click any event to see its detailed properties.

För begäranden till webbappen kan du klicka vidare till koden.For requests to your web app, you can click through to the code.

Under Information om begäran klickar du vidare till koden.

Du kan också öppna relaterade objekt för att diagnostisera misslyckade begäranden eller undantag.You can also open related items to help diagnose failed requests or exceptions.

Rulla ned till relaterade artiklar under Information om begäran

Visa undantag och misslyckade förfrågningarView exceptions and failed requests

Undantagsrapporter visas i sökfönstret.Exception reports show in the Search window. (I vissa äldre versioner av ASP.NET måste du konfigurera undantagsövervakning för att se undantagen som hanteras av ramverket.)(In some older types of ASP.NET application, you have to set up exception monitoring to see exceptions that are handled by the framework.)

Klicka på ett undantag för att visa en stackspårning.Click an exception to get a stack trace. Om koden för appen är öppen i Visual Studio kan du klicka dig igenom från stackspårningen till relevant kodrad.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.

Skärm bild som visar objektet om i en stack-spår.

Visa sammanfattningar av förfrågningar och undantag i kodenView request and exception summaries in the code

I kod lins linjen ovanför varje hanterare-metod ser du antalet begär Anden och undantag som loggats av Application Insights under de senaste 24 h.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.

Skärm bilden visar ett undantag i en dialog ruta i ett sammanhang.

Anteckning

CodeLens visar Application Insights-data endast om du har konfigurerat appen för att skicka telemetri till Application Insights-portalen.Code Lens shows Application Insights data only if you have configured your app to send telemetry to the Application Insights portal.

Läs mer om Application Insights i CodeLensMore about Application Insights in Code Lens

Trends är ett verktyg för visualisering av hur din app ska bete sig över tiden.Trends is a tool for visualizing how your app behaves over time.

Välj Utforska telemetritrender med verktygsfältsknappen eller sökfönstret för Application Insights.Choose Explore Telemetry Trends from the Application Insights toolbar button or Application Insights Search window. Välj en av fem vanliga frågor för att komma igång.Choose one of five common queries to get started. Du kan analysera olika datauppsättningar baserat på telemetrityper, tidsintervall och andra egenskaper.You can analyze different datasets based on telemetry types, time ranges, and other properties.

För att hitta avvikelser i dina data väljer du ett av avvikelsealternativen i listrutan ”Vytyp”.To find anomalies in your data, choose one of the anomaly options under the "View Type" dropdown. Filtreringsalternativen längst ned i fönstret gör det lättare att justera efter specifika delmängder av dina telemetri.The filtering options at the bottom of the window make it easy to hone in on specific subsets of your telemetry.

Trends

Mer om Trends.More about Trends.

Lokal övervakningLocal monitoring

(Från Visual Studio 2015 uppdatering 2) Om du inte har konfigurerat SDK för att skicka telemetri till Application Insights portal (så att det inte finns någon Instrumentation-nyckel i ApplicationInsights.config) visas telemetri från din senaste felsökningssession i fönstret diagnostik.(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.

Detta är lämpligt om du redan har publicerat en tidigare version av din app.This is desirable if you have already published a previous version of your app. Du vill undvika att telemetri från dina felsökningssessioner blandas med telemetrin på Application Insights-portalen från den publicerade appen.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.

Det är också användbart om du har anpassad telemetri som du vill felsöka innan du skickar telemetri till portalen.It's also useful if you have some custom telemetry that you want to debug before sending telemetry to the portal.

  • Först konfigurerade jag Application Insights att skicka telemetri till portalen. Men nu vill jag bara se Telemetrin i 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.

    • I sökfönstrets inställningar finns det ett alternativ för att söka i lokal diagnostik även om din app skickar telemetri till portalen.In the Search window's Settings, there's an option to search local diagnostics even if your app sends telemetry to the portal.
    • Om du vill stoppa telemetri som skickas till portalen kommenterar du ut raden <instrumentationkey>... från ApplicationInsights.config. När du är redo att skicka telemetri till portalen igen, tar du bort kommentaren.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.

Nästa stegNext steps