Verwenden von Search in Application InsightsUsing Search in Application Insights

Search ist eine Funktion in Application Insights, mit der Sie einzelne Telemetrieelemente wie Seitenaufrufe, Ausnahmen und Webanforderungen suchen und untersuchen können.Search is a feature of Application Insights that you use to find and explore individual telemetry items, such as page views, exceptions, or web requests. Außerdem können Sie Protokollablaufverfolgungen und Ereignisse anzeigen, die Sie programmiert haben.And you can view log traces and events that you have coded.

(Verwenden Sie Analytics zum Anwenden komplexerer Abfragen auf Ihre Daten.)(For more complex queries over your data, use Analytics.)

Im Azure-PortalIn the Azure portal

Sie können die Diagnosesuche über die Application Insights-Registerkarte „Übersicht“ Ihrer Anwendung (auf der oberen Leiste) oder über die Option „Untersuchen“ auf der linken Seite öffnen.You can open diagnostic search from the Application Insights Overview tab of your application (located at in the top bar) or under investigate on the left.

Registerkarte „Suche“

Navigieren Sie zum Dropdownmenü „Ereignistypen“, um eine Liste von Telemetrieelementen anzuzeigen: Serveranforderungen, Seitenaufrufe, benutzerdefinierte Ereignisse, die Sie programmiert haben, usw.Go to the Event types' drop-down menu to see a list of telemetry items- server requests, page views, custom events that you have coded, and so on. Am Anfang der Ergebnisliste befindet sich ein Übersichtsdiagramm, das die Anzahl der Ereignisse im Zeitablauf zeigt.At the top of the results' list, is a summary chart showing counts of events over time.

Klicken Sie auf eine Stelle außerhalb des Dropdownmenüs oder auf die Option „Aktualisieren“, um neue Ereignisse zu erhalten.Click out of the drop-down menu or Refresh to get new events.

In Visual StudioIn Visual Studio

In Visual Studio gibt es auch das Fenster „Application Insights-Suche“.In Visual Studio, there's also an Application Insights Search window. Es eignet sich am besten für die Anzeige von Telemetrieereignissen, die von der Anwendung generiert wurden, die Sie debuggen.It's most useful for displaying telemetry events generated by the application that you're debugging. Es kann aber auch die Ereignisse zeigen, die in Ihrer veröffentlichten App im Azure-Portal gesammelt wurden.But it can also show the events collected from your published app at the Azure portal.

Öffnen Sie das Fenster „Search“ in Visual Studio:Open the Search window in Visual Studio:

Geöffnetes Visual Studio-Fenster „Application Insights-Suche“

Das Fenster „Search“ bietet ähnliche Features wie das Webportal:The Search window has features similar to the web portal:

Visual Studio-Fenster „Application Insights-Suche“

Die Registerkarte „Nachverfolgungsvorgang“ ist verfügbar, wenn Sie eine Anforderung oder einen Seitenaufruf öffnen.The Track Operation tab is available when you open a request or a page view. Ein „Vorgang“ ist eine Folge von Ereignissen, die einer einzelnen Anforderung oder einem einzelnem Seitenaufruf zugeordnet sind.An 'operation' is a sequence of events that is associated with to a single request or page view. Abhängigkeitsaufrufe, Ausnahmen, Ablaufverfolgungsprotokolle und benutzerdefinierte Ereignisse können beispielsweise Teil eines einzelnen Vorgangs sein.For example, dependency calls, exceptions, trace logs, and custom events might be part of a single operation. Die Registerkarte "Nachverfolgungsvorgang" zeigt den Zeitpunkt und die Dauer dieser Ereignisse in Bezug auf die Anforderung oder den Seitenaufruf.The Track Operation tab shows graphically the timing and duration of these events in relation to the request or page view.

Überprüfen einzelner ElementeInspect individual items

Wählen Sie ein beliebiges Telemetrieelement aus, um Schlüsselfelder und verwandte Elemente anzuzeigen.Select any telemetry item to see key fields and related items.

Screenshot einer einzelnen Abhängigkeitsanforderung

Dadurch wird eine Detailansicht der gesamten Transaktion eingeblendet.This will launch the end-to-end transaction details view.

Filtern von EreignistypenFilter event types

Öffnen Sie das Dropdownmenü „Ereignistypen“, und wählen Sie die anzuzeigenden Ereignistypen aus.Open the Event types' drop-down menu and choose the event types you want to see. (Falls Sie die Filter später wiederherstellen möchten, klicken Sie auf „Zurücksetzen“.)(If, later, you want to restore the filters, click Reset.)

Die Ereignistypen sind:The event types are:

  • Ablaufverfolgung - Diagnoseprotokolle, einschließlich TrackTrace, log4Net, NLog und Aufrufe von „System.Diagnostic.Trace“.Trace - Diagnostic logs including TrackTrace, log4Net, NLog, and System.Diagnostic.Trace calls.
  • Anforderung: Von Ihrer Serveranwendung empfangene HTTP-Anforderungen, einschließlich Seiten, Skripts, Bilder, Formatdateien und Daten.Request - HTTP requests received by your server application, including pages, scripts, images, style files, and data. Diese Ereignisse werden verwendet, um die Übersichtsdiagramme für Anforderungen und Antworten zu erstellen.These events are used to create the request and response overview charts.
  • Seitenaufruf - Vom Webclient gesendete Telemetriedaten, die zum Erstellen von Seitenaufrufberichten verwendet werden.Page View - Telemetry sent by the web client, used to create page view reports.
  • Benutzerdefiniertes Ereignis: Wenn Sie Aufrufe von „TrackEvent()“ zum Überwachen der Nutzung eingefügt haben, können Sie diese hier suchen.Custom Event - If you inserted calls to TrackEvent() in order to monitor usage, you can search them here.
  • Ausnahme: Nicht vom Server abgefangene Ausnahmen und Ausnahmen, die Sie mit „TrackException()“ protokollieren können.Exception - Uncaught exceptions in the server, and those that you log by using TrackException().
  • Abhängigkeit - Aufrufe aus Ihrer Serveranwendung an andere Dienste wie REST-APIs oder Datenbanken und AJAX-Aufrufe aus Ihrem Clientcode.Dependency - Calls from your server application to other services such as REST APIs or databases, and AJAX calls from your client code.
  • Verfügbarkeit: Ergebnisse von Verfügbarkeitstests.Availability - Results of availability tests.

Filtern von EigenschaftswertenFilter on property values

Sie können Ereignisse anhand der Werte ihrer Eigenschaften filtern.You can filter events on the values of their properties. Die verfügbaren Eigenschaften hängen von den ausgewählten Ereignistypen ab.The available properties depend on the event types you selected. Klicken Sie auf das FiltersymbolClick on the filter icon Filtersymbol , um loszulegen.to start.

Das Auswählen keiner Werte einer bestimmten Eigenschaft hat dieselbe Wirkung wie das Auswählen aller Werte,Choosing no values of a particular property has the same effect as choosing all values. nämlich dass das Filtern anhand dieser Eigenschaft deaktiviert wird.It switches off filtering on that property.

Beachten Sie, dass die Zahlen rechts neben den Filterwerten anzeigen, wie viele Vorkommen es in der aktuell gefilterten Gruppe gibt.Notice that the counts to the right of the filter values show how many occurrences there are in the current filtered set.

Suchen von Ereignissen mit der gleichen EigenschaftFind events with the same property

Wenn Sie alle Elemente mit dem gleichen Eigenschaftswert ermitteln möchten, geben Sie den Wert entweder in die Suchleiste ein, oder aktivieren Sie beim Durchsuchen der Eigenschaften auf der Registerkarte „Filter“ das entsprechende Kontrollkästchen.To find all the items with the same property value, either type it into the search bar or click the checkbox when looking through properties in the filter tab.

Aktivieren des Kontrollkästchens einer Eigenschaft auf der Registerkarte „Filter“

Durchsuchen der DatenSearch the data

Hinweis

Um komplexere Abfragen zu stellen, öffnen Sie oben auf dem Blatt „Suche“ das Feld Protokolle (Analytics) .To write more complex queries, open Logs (Analytics) from the top of the Search blade.

Sie können alle Eigenschaftswerte nach Ausdrücken durchsuchen.You can search for terms in any of the property values. Dies ist nützlich, wenn Sie benutzerdefinierte Ereignisse mit Eigenschaftswerten geschrieben haben.This is useful if you have written custom events with property values.

Sie können auch einen Zeitbereich festlegen, da die Suche in einem kürzeren Bereich schneller erfolgt.You might want to set a time range, as searches over a shorter range are faster.

Diagnosesuche öffnen

Suchen Sie nach vollständigen Wörtern, nicht nach Teilzeichenfolgen.Search for complete words, not substrings. Verwenden Sie Anführungszeichen, um Sonderzeichen zu umschließen.Use quotation marks to enclose special characters.

ZeichenfolgeString Nicht gefundenNot found GefundenFound
HomeController.InfoHomeController.About home
controller
out
homecontroller
about
"homecontroller.about"
USAUnited States Uni
ted
united
states
united AND states
"united states"

Dies sind einige Suchausdrücke, die Sie verwenden können:Here are the search expressions you can use:

BeispielabfrageSample query WirkungEffect
apple Findet alle Ereignisse im Uhrzeitbereich, deren Felder den Begriff „apple“ enthalten.Find all events in the time range whose fields include the word "apple"
apple AND banana
apple banana
Findet Ereignisse, die beide Wörter enthalten.Find events that contain both words. Verwenden Sie „AND“ in Großbuchstaben, nicht „and“.Use capital "AND", not "and".
Kurzform.Short form.
apple OR banana Findet Ereignisse, die eines der beiden Wörter enthalten.Find events that contain either word. Verwenden Sie „OR“ in Großbuchstaben, nicht „or“.Use "OR", not "or".
apple NOT banana Findet Ereignisse, die das eine Wort enthalten, aber nicht das andere.Find events that contain one word but not the other.

StichprobenSampling

Wenn die App viele Telemetriedaten generiert (und Sie die ASP.NET SDK-Version 2.0.0-beta3 oder höher verwenden), reduziert das Modul für die adaptive Stichprobenerstellung automatisch die an das Portal gesendete Datenmenge, indem nur ein repräsentativer Bruchteil der Ereignisse gesendet wird.If your app generates a large amount of telemetry (and you are using the ASP.NET SDK version 2.0.0-beta3 or later), the adaptive sampling module automatically reduces the volume that is sent to the portal by sending only a representative fraction of events. Ereignisse, die mit derselben Anforderung im Zusammenhang stehen, werden als Gruppe aus- oder abgewählt, sodass Sie zwischen verwandten Ereignissen navigieren können.However, events that are related to the same request are selected or deselected as a group, so that you can navigate between related events.

Erfahren Sie mehr über das Erstellen von Stichproben.Learn about sampling.

Erstellen eines ArbeitselementsCreate work item

Sie können einen Fehler mit den Details aus einem beliebigen Telemetrieelement in GitHub oder Azure DevOps erstellen.You can create a bug in GitHub or Azure DevOps with the details from any telemetry item.

Navigieren Sie zur Ansicht mit End-to-End-Transaktionsdetails, indem Sie auf ein beliebiges Telemetrieelement klicken, und wählen Sie anschließend Arbeitselement erstellen aus.Go to the end-to-end transaction detail view by clicking on any telemetry item then select Create work item.

Klicken Sie auf „Neues Arbeitselement“, bearbeiten Sie die Felder, und klicken Sie dann auf „OK“.

Wenn Sie diesen Vorgang zum ersten Mal ausführen, werden Sie aufgefordert, einen Link zu Ihrer Azure DevOps-Organisation und Ihrem Projekt zu konfigurieren.The first time you do this, you are asked to configure a link to your Azure DevOps organization and project.

(Sie können den Link auch auf der Registerkarte „Arbeitselemente“ konfigurieren.)(You can also configure the link on the Work Items tab.)

Senden weiterer Telemetriedaten an Application InsightsSend more telemetry to Application Insights

Neben der standardmäßig vom Application Insights SDK gesendeten Telemetriedaten können Sie folgende Aktionen ausführen:In addition to the out-of-the-box telemetry sent by Application Insights SDK, you can:

  • Erfassen von Protokollablaufverfolgungen mithilfe Ihres bevorzugten Protokollierungsframeworks in .NET oder Java.Capture log traces from your favorite logging framework in .NET or Java. Das heißt, dass Sie Ihre Protokollablaufverfolgungen durchsuchen und mit Seitenaufrufen, Ausnahmen und anderen Ereignissen korrelieren können.This means you can search through your log traces and correlate them with page views, exceptions, and other events.
  • Schreiben von Code zum Senden benutzerdefinierter Ereignisse, Seitenaufrufe und Ausnahmen.Write code to send custom events, page views, and exceptions.

Erfahren Sie, wie Sie Protokolle und benutzerdefinierte Telemetrie an Application Insights senden können.Learn how to send logs and custom telemetry to Application Insights.

FRAGEN UND ANTWORTENQ & A

Wie viele Daten werden beibehalten?How much data is retained?

Entsprechende Informationen finden Sie unter Zusammenfassung der Grenzwerte.See the Limits summary.

Wie kann ich die POST-Daten in meinen Serveranforderungen anzeigen?How can I see POST data in my server requests?

POST-Daten werden nicht automatisch protokolliert. Sie können jedoch TrackTrace oder Protokollaufrufe verwenden.We don't log the POST data automatically, but you can use TrackTrace or log calls. Fügen Sie die POST-Daten in den "message"-Parameter ein.Put the POST data in the message parameter. Sie können nicht anhand der Nachricht wie anhand von Eigenschaften filtern, aber dafür ist der Größengrenzwert höher.You can't filter on the message in the same way you can filter on properties, but the size limit is longer.

Nächste SchritteNext steps