Debuggen von Anwendungen mit Azure Application Insights in Visual StudioDebug your applications with Azure Application Insights in Visual Studio

In Visual Studio (2015 und höher) können Sie mithilfe von Telemetriedaten aus Azure Application Insights sowohl beim Debuggen als auch in der Produktion in Ihrer ASP.NET-Web-App die Leistung analysieren und Probleme diagnostizieren.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.

Wenn Sie die ASP.NET-Web-App mit Visual Studio 2017 oder höher erstellt haben, ist das Application Insights-SDK bereits vorhanden.If you created your ASP.NET web app using Visual Studio 2017 or later, it already has the Application Insights SDK. Andernfalls können Sie Application Insights Ihrer App hinzufügen, falls Sie dies noch nicht getan haben.Otherwise, if you haven't done so already, add Application Insights to your app.

Zur Liveüberwachung Ihrer App in der Produktion zeigen Sie die Application Insights-Telemetrie normalerweise im Azure-Portal an, in dem Sie Warnungen festlegen und leistungsfähige Überwachungstool anwenden können.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. Für das Debuggen können Sie die Telemetriedaten in Visual Studio auch durchsuchen und analysieren.But for debugging, you can also search and analyze the telemetry in Visual Studio. Mit Visual Studio können Sie Telemetriedaten von Ihrem Produktionsstandort sowie aus Debugläufen auf Ihrem Entwicklungscomputer analysieren.You can use Visual Studio to analyze telemetry both from your production site and from debugging runs on your development machine. Im letzteren Fall können Sie die Debugläufe auch dann analysieren, wenn Sie das SDK nicht zum Senden von Telemetriedaten an das Azure-Portal konfiguriert haben.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.

Debuggen des ProjektsDebug your project

Führen Sie Ihre Web-App im lokalen Debugmodus aus, indem Sie F5 drücken.Run your web app in local debug mode by using F5. Öffnen Sie verschiedene Seiten, um Telemetriedaten zu generieren.Open different pages to generate some telemetry.

In Visual Studio wird die Anzahl von Ereignissen angezeigt, die vom Application Insights-Modul in Ihrem Projekt protokolliert wurden.In Visual Studio, you see a count of the events that have been logged by the Application Insights module in your project.

In Visual Studio wird die Schaltfläche „Application Insights“ während des Debuggens angezeigt.

Klicken Sie auf diese Schaltfläche, um Ihre Telemetriedaten zu durchsuchen.Click this button to search your telemetry.

Im Fenster „Application Insights-Suche“ werden Ereignisse angezeigt, die protokolliert wurden.The Application Insights Search window shows events that have been logged. (Wenn Sie sich bei der Einrichtung von Application Insights bei Azure angemeldet haben, können Sie die gleichen Ereignisse im Azure-Portal durchsuchen.)(If you signed in to Azure when you set up Application Insights, you can search the same events in the Azure portal.)

Klicken Sie mit der rechten Maustaste auf das Projekt, und wählen Sie „Application Insights > Durchsuchen“ aus.

Hinweis

Klicken Sie nach dem Aktivieren bzw. Deaktivieren von Filtern am Ende des Textsuchfelds auf die Schaltfläche „Suchen“.After you select or deselect filters, click the Search button at the end of the text search field.

Die Freitextsuche funktioniert in allen Feldern in den Ereignissen.The free text search works on any fields in the events. Suchen Sie z. B. einen Teil der URL einer Seite, den Wert einer Eigenschaft, z. B. Ort des Kunden, oder bestimmte Wörter in einem Ablaufverfolgungsprotokoll.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.

Klicken Sie auf ein beliebiges Ereignis, um seine detaillierten Eigenschaften anzuzeigen.Click any event to see its detailed properties.

Für Anforderungen an Ihre Web-App können Sie sich bis zum Code durchklicken.For requests to your web app, you can click through to the code.

Klicken unter „Anforderungsdetails“ bis zum Code

Außerdem können Sie zum Diagnostizieren von fehlerhaften Anforderungen oder von Ausnahmen auch verwandte Elemente öffnen.You can also open related items to help diagnose failed requests or exceptions.

Scrollen zu verwandten Elementen unter „Anforderungsdetails“

Anzeigen von Ausnahmen und nicht erfolgreichen AnforderungenView exceptions and failed requests

Ausnahmeberichte werden im Suchfenster angezeigt.Exception reports show in the Search window. (Bei einigen älteren Typen der ASP.NET-Anwendung müssen Sie die Ausnahmeüberwachung einrichten, um Ausnahmen anzuzeigen, die vom Framework verarbeitet werden.)(In some older types of ASP.NET application, you have to set up exception monitoring to see exceptions that are handled by the framework.)

Klicken Sie auf eine Ausnahme, um eine Stapelüberwachung zu erhalten.Click an exception to get a stack trace. Wenn der Code der App in Visual Studio geöffnet ist, können Sie sich durch die Stapelüberwachung bis zur entsprechenden Zeile im Code klicken.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.

Ausnahmestapelüberwachung

Anzeigen von Zusammenfassungen von Anforderungen und Ausnahmen im CodeView request and exception summaries in the code

In der Codebereichszeile wird oberhalb jeder Handlermethode die Anzahl von Anforderungen und Ausnahmen angezeigt, die von Application Insights innerhalb der letzten 24 Stunden protokolliert wurden.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.

Ausnahmestapelüberwachung

Hinweis

CodeLens zeigt Application Insights-Daten nur an, wenn Sie Ihre App zum Senden von Telemetriedaten an das Application Insights-Portal konfiguriert haben.Code Lens shows Application Insights data only if you have configured your app to send telemetry to the Application Insights portal.

Weitere Informationen zu Application Insights in CodeLensMore about Application Insights in Code Lens

Mit dem Tool Trends können Sie visualisieren, wie sich Ihre App im Laufe der Zeit verhält.Trends is a tool for visualizing how your app behaves over time.

Wählen Sie auf der Application Insights-Symbolleiste oder im Application Insights-Suchfenster die Schaltfläche Telemetrietrends untersuchen .Choose Explore Telemetry Trends from the Application Insights toolbar button or Application Insights Search window. Wählen Sie eine der fünf allgemeinen Abfragen aus, um zu beginnen.Choose one of five common queries to get started. Sie können unterschiedliche Datasets basierend auf Telemetrietypen, Zeiträumen und anderen Eigenschaften analysieren.You can analyze different datasets based on telemetry types, time ranges, and other properties.

Wählen Sie zum Ermitteln von Anomalien in Ihren Daten in der Dropdownliste „Ansichtstyp“ eine Anomalieoption.To find anomalies in your data, choose one of the anomaly options under the "View Type" dropdown. Mit den Filteroptionen am unteren Rand des Fensters ist es einfach, bestimmte Teilmengen Ihrer Telemetriedaten anzuzeigen.The filtering options at the bottom of the window make it easy to hone in on specific subsets of your telemetry.

Trends

Weitere Informationen zu TrendsMore about Trends.

Lokale ÜberwachungLocal monitoring

(Visual Studio 2015 Update 2) Falls Sie das SDK nicht zum Senden von Telemetriedaten an das Application Insights-Portal konfiguriert haben (sodass kein Instrumentationsschlüssel in „ApplicationInsights.config“ enthalten ist), werden im Diagnosefenster Telemetriedaten aus der letzten Debugsitzung angezeigt.(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.

Dies ist wünschenswert, wenn Sie bereits eine frühere Version der Anwendung veröffentlicht haben.This is desirable if you have already published a previous version of your app. Die Telemetriedaten aus den Debugsitzungen und die Telemetriedaten der veröffentlichten App im Application Insights-Portal müssen getrennt behandelt werden.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.

Dies ist ebenfalls hilfreich, wenn Sie über benutzerdefinierte Telemetriedaten verfügen, die Sie vor dem Senden an das Portal debuggen möchten.It's also useful if you have some custom telemetry that you want to debug before sending telemetry to the portal.

  • Zunächst habe ich Application Insights vollständig für das Senden von Telemetriedaten an das Portal konfiguriert. Aber nun möchte ich die Telemetriedaten nur in Visual Studio anzeigen.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.

    • In den Einstellungen des Suchfensters steht eine Option zum Durchsuchen der lokalen Diagnosen zur Verfügung, auch wenn Ihre App Telemetriedaten an das Portal sendet.In the Search window's Settings, there's an option to search local diagnostics even if your app sends telemetry to the portal.
    • Damit keine Telemetriedaten mehr an das Portal gesendet werden, kommentieren Sie die Zeile <instrumentationkey>... in „ApplicationInsights.config“ aus. Wenn Sie bereit sind, Telemetriedaten erneut an das Portal zu senden, heben Sie die Auskommentierung auf.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ächste SchritteNext steps

Hinzufügen weiterer DatenAdd more data
Überwachen Sie Nutzung, Verfügbarkeit, Abhängigkeiten und Ausnahmen.Monitor usage, availability, dependencies, exceptions. Integrieren Sie Ablaufverfolgungen aus Protokollierungsframeworks.Integrate traces from logging frameworks. Schreiben Sie benutzerdefinierte Telemetriedaten.Write custom telemetry.
Visual Studio
Navigation und Dashboards im Application Insights-PortalWorking with the Application Insights portal
Zeigen Sie Dashboards, leistungsstarke Diagnose- und Analysetools, Warnungen, eine Livezuordnung der Abhängigkeiten Ihrer Anwendung sowie exportierte Telemetriedaten an.View dashboards, powerful diagnostic and analytic tools, alerts, a live dependency map of your application, and exported telemetry data.
Visual Studio