Application Insights-Telemetrie in Visual Studio CodeLensApplication Insights telemetry in Visual Studio CodeLens

Methoden im Code Ihrer Web-App können mit Telemetrie zu Laufzeitausnahmen und Anforderungsantwortzeiten kommentiert werden.Methods in the code of your web app can be annotated with telemetry about run-time exceptions and request response times. Wenn Sie Azure Application Insights in Ihrer Anwendung installieren, wird die Telemetrie in Visual Studio CodeLens angezeigt. Hierbei handelt es sich um die praktischen Hinweise am Anfang jeder Funktion, die Aufschluss darüber geben, an wie vielen Stellen auf die Funktion verwiesen wird oder von wem sie zuletzt bearbeitet wurde.If you install Azure Application Insights in your application, the telemetry appears in Visual Studio CodeLens - the notes at the top of each function where you're used to seeing useful information such as the number of places the function is referenced or the last person who edited it.

CodeLens

Hinweis

Application Insights in CodeLens ist ab Visual Studio 2015 Update 3 sowie mit der neuesten Version der Developer Analytics Tools-Erweiterungverfügbar.Application Insights in CodeLens is available in Visual Studio 2015 Update 3 and later, or with the latest version of Developer Analytics Tools extension. CodeLens steht in der Enterprise- und in der Professional-Edition von Visual Studio zur Verfügung.CodeLens is available in the Enterprise and Professional editions of Visual Studio.

Anzeigeort von Application Insights-DatenWhere to find Application Insights data

Application Insights-Telemetrie finden Sie in den CodeLens-Indikatoren der öffentlichen Anforderungsmethoden Ihrer Webanwendung.Look for Application Insights telemetry in the CodeLens indicators of the public request methods of your web application. CodeLens-Indikatoren werden in C#- und Visual Basic-Code über der Methode und anderen Deklarationen angezeigt.CodeLens indicators are shown above method and other declarations in C# and Visual Basic code. Wenn Application Insights-Daten für eine Methode verfügbar sind, werden Indikatoren für Anforderungen und Ausnahmen angezeigt (beispielsweise „100 Anforderungen, 1 % nicht erfolgreich“ oder „10 Ausnahmen“).If Application Insights data is available for a method, you'll see indicators for requests and exceptions such as "100 requests, 1% failed" or "10 exceptions." Klicken Sie auf einen CodeLens-Indikator, um weitere Details anzuzeigen.Click a CodeLens indicator for more details.

Tipp

Wenn weitere CodeLens-Indikatoren angezeigt werden, dauert es unter Umständen etwas, bis Application Insights-Indikatoren zu Anforderungen und Ausnahmen geladen werden.Application Insights request and exception indicators may take a few extra seconds to load after other CodeLens indicators appear.

Ausnahmen in CodeLensExceptions in CodeLens

TBD

Der CodeLens-Ausnahmenindikator gibt Aufschluss darüber, wie viele Ausnahmen in den letzten 24 Stunden beim Verarbeiten der von der Methode bedienten Anforderung aufgetreten sind. Dabei werden die 15 am häufigsten aufgetretenen Ausnahmen des jeweiligen Zeitraums angezeigt.The exception CodeLens indicator shows the number of exceptions that have occurred in the past 24 hours from the 15 most frequently occurring exceptions in your application during that period, while processing the request served by the method.

Durch Klicken auf den CodeLens-Ausnahmenindikator werden weitere Details angezeigt:To see more details, click the exceptions CodeLens indicator:

  • Die prozentuale Veränderung der Ausnahmenanzahl der letzten 24 Stunden im Vergleich zu den vorherigen 24 StundenThe percentage change in number of exceptions from the most recent 24 hours relative to the prior 24 hours
  • Wählen Sie Gehe zu Code aus, um zum Quellcode der Funktion zu gelangen, durch die die Ausnahme ausgelöst wird.Choose Go to code to navigate to the source code for the function throwing the exception
  • Wählen Sie Suchen aus, um für diese Ausnahme alle Instanzen der letzten 24 Stunden abzufragen.Choose Search to query all instances of this exception that have occurred in the past 24 hours
  • Wählen Sie Trend aus, um für die Ausnahme eine Trendvisualisierung der Vorkommen der letzten 24 Stunden anzuzeigen.Choose Trend to view a trend visualization for occurrences of this exception in the past 24 hours
  • Wählen Sie Alle Ausnahmen in dieser App anzeigen aus, um alle Ausnahmen abzufragen, die in den letzten 24 Stunden aufgetreten sind.Choose View all exceptions in this app to query all exceptions that have occurred in the past 24 hours
  • Wählen Sie Ausnahmetrends untersuchen aus, um eine Trendvisualisierung für alle Ausnahmen der letzten 24 Stunden anzuzeigen.Choose Explore exception trends to view a trend visualization for all exceptions that have occurred in the past 24 hours.

Tipp

Wenn in CodeLens keine Ausnahmen angezeigt werden, aber eigentlich Ausnahmen vorliegen müssten, vergewissern Sie sich, dass in CodeLens die richtige Application Insights-Ressource ausgewählt ist.If you see "0 exceptions" in CodeLens but you know there should be exceptions, check to make sure the right Application Insights resource is selected in CodeLens. Wenn Sie eine andere Ressource auswählen möchten, klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, und wählen Sie Application Insights > Telemetriequelle auswählen aus.To select another resource, right-click on your project in the Solution Explorer and choose Application Insights > Choose Telemetry Source. CodeLens wird nur für die 15 Ausnahmen angezeigt, die in Ihrer Anwendung innerhalb der letzten 24 Stunden am häufigsten aufgetreten sind. Für Ausnahmen ab dem 16. Häufigkeitsrang wird „0 Ausnahmen“ angezeigt.CodeLens is only shown for the 15 most frequently occurring exceptions in your application in the past 24 hours, so if an exception is the 16th most frequently or less, you'll see "0 exceptions." Ausnahmen aus ASP.NET-Ansichten werden unter Umständen nicht für die Controllermethoden angezeigt, die diese Ansichten generiert haben.Exceptions from ASP.NET views may not appear on the controller methods that generated those views.

Tipp

Falls in CodeLens „?If you see "? Ausnahmen“ angezeigt wird, müssen Sie entweder Ihr Azure-Konto mit Visual Studio verknüpfen, oder Ihre Anmeldeinformationen für das Azure-Konto sind abgelaufen.exceptions" in CodeLens, you need to associate your Azure account with Visual Studio or your Azure account credential may have expired. Klicken Sie in einem solchen Fall auf „?In either case, click "? Ausnahmen“, und wählen Sie Konto hinzufügen aus, um Ihre Anmeldeinformationen einzugeben.exceptions" and choose Add an account... to enter your credentials.

Anforderungen in CodeLensRequests in CodeLens

TBD

Der CodeLens-Anforderungsindikator zeigt die Anzahl von HTTP-Anforderungen, die von einer Methode in den letzten 24 Stunden bedient wurden, sowie den Prozentsatz nicht erfolgreicher Anforderungen an.The request CodeLens indicator shows the number of HTTP requests that been serviced by a method in the past 24 hours, plus the percentage of those requests that failed.

Durch Klicken auf den CodeLens-Anforderungsindikator werden weitere Details angezeigt:To see more details, click the requests CodeLens indicator:

  • Der absolute Wert und die prozentuale Veränderung der Anzahl von Anforderungen, nicht erfolgreichen Anforderungen und durchschnittlichen Antwortzeiten der letzten 24 Stunden im Vergleich zu den vorherigen 24 StundenThe absolute and percentage changes in number of requests, failed requests, and average response times over the past 24 hours compared to the prior 24 hours
  • Die Zuverlässigkeit der Methode als Prozentsatz der Anforderungen, bei denen in den letzten 24 Stunden kein Fehler aufgetreten istThe reliability of the method, calculated as the percentage of requests that did not fail in the past 24 hours
  • Wählen Sie für Anforderungen oder fehlerhafte Anforderungen die Option Suche aus, um alle (nicht erfolgreichen) Anforderungen der letzten 24 Stunden abzufragen.Choose Search for requests or failed requests to query all the (failed) requests that occurred in the past 24 hours
  • Wählen Sie Trend aus, um eine Trendvisualisierung für Anforderungen, nicht erfolgreiche Anforderungen oder durchschnittliche Antwortzeiten der letzten 24 Stunden anzuzeigen.Choose Trend to view a trend visualization for requests, failed requests, or average response times in the past 24 hours.
  • Wählen Sie links oben in der CodeLens-Detailansicht den Namen der Application Insights-Ressource aus, um eine andere Quellressource für die CodeLens-Daten auszuwählen.Choose the name of the Application Insights resource in the upper left corner of the CodeLens details view to change which resource is the source for CodeLens data.

Nächste SchritteNext steps

Arbeiten mit Application Insights in Visual StudioWorking with Application Insights in Visual Studio
Durchsuchen Sie die Telemetriedaten, zeigen Sie Daten in CodeLens an, und konfigurieren Sie Application Insights.Search telemetry, see data in CodeLens, and configure Application Insights. Alles in Visual Studio.All within Visual Studio.
Klicken Sie mit der rechten Maustaste auf das Projekt, und wählen Sie „Application Insights > Durchsuchen“ aus.
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
Enthält Informationen zu Dashboards, leistungsstarken Diagnose- und Analysetools, Warnungen und zum Export von Telemetriedaten sowie eine Livekarte der Abhängigkeiten Ihrer Anwendung.Dashboards, powerful diagnostic and analytic tools, alerts, a live dependency map of your application, and telemetry export.
Visual Studio