Zoeken gebruiken in Application Insights

Transacties zoeken is een functie van Application Insights waarmee u afzonderlijke telemetrie-items kunt zoeken en verkennen, zoals paginaweergaven, uitzonderingen of webaanvragen. En u kunt logboek traceringen en gebeurtenissen weergeven die u hebt gecodeerd.

(Gebruik Analytics voor complexere query's op uw gegevens.)

In Azure Portal

U kunt zoeken in transacties openen via het tabblad Insights overzicht van uw toepassing (in de bovenste balk) of onder Onderzoeken aan de linkerkant.

Tabblad Zoeken

Ga naar de vervolgkeuzelijst Gebeurtenistypen voor een lijst met telemetrie-items: serveraanvragen, paginaweergaven, aangepaste gebeurtenissen die u hebt gecodeerd, en meer. Bovenaan de lijst met resultaten staat een overzichtsgrafiek met het aantal gebeurtenissen gedurende een periode.

Klik buiten de vervolgkeuzelijst of Vernieuwen om nieuwe gebeurtenissen op te halen.

In Visual Studio

In Visual Studio is er ook een venster Application Insights Search. Dit is het handigst voor het weergeven van telemetriegebeurtenissen die zijn gegenereerd door de toepassing die u wilt debuggen. Maar het kan ook de gebeurtenissen tonen die zijn verzameld van uw gepubliceerde app op Azure Portal.

Open het venster Zoeken in Visual Studio:

Visual Studio application Insights openen

Het venster Zoeken bevat functies die vergelijkbaar zijn met de webportal:

Visual Studio Zoekvenster Insights toepassingstoepassing

Het tabblad Bewerking bijhouden is beschikbaar wanneer u een aanvraag of een paginaweergave opent. Een 'bewerking' is een reeks gebeurtenissen die is gekoppeld aan één aanvraag- of paginaweergave. Afhankelijkheidsoproepen, uitzonderingen, traceerlogboeken en aangepaste gebeurtenissen kunnen bijvoorbeeld deel uitmaken van één bewerking. Op het tabblad Bewerking bijhouden ziet u grafisch de timing en duur van deze gebeurtenissen in relatie tot de aanvraag- of paginaweergave.

Afzonderlijke items inspecteren

Selecteer een telemetrie-item om sleutelvelden en gerelateerde items te bekijken.

Schermopname van een afzonderlijke afhankelijkheidsaanvraag

Hiermee wordt de weergave met end-to-end-transactiedetails geopend.

Gebeurtenistypen filteren

Open de vervolgkeuzelijst Gebeurtenistypen en kies de gebeurtenistypen die u wilt zien. (Als u de filters later wilt herstellen, klikt u op Opnieuw instellen.)

De gebeurtenistypen zijn:

  • Traceer - Diagnostische logboeken, waaronder TrackTrace-, log4Net-, NLog- en System.Diagnostic.Trace-aanroepen.
  • Aanvraag: HTTP-aanvragen die worden ontvangen door uw servertoepassing, waaronder pagina's, scripts, afbeeldingen, stijlbestanden en gegevens. Deze gebeurtenissen worden gebruikt om de overzichtsgrafieken voor aanvragen en antwoorden te maken.
  • Paginaweergave - Telemetrie die wordt verzonden door de webclient, wordt gebruikt om rapporten voor paginaweergaven te maken.
  • Aangepaste gebeurtenis: als u aanroepen naar TrackEvent() hebt ingevoegd om het gebruik te controleren,kunt u deze hier doorzoeken.
  • Uitzondering: niet-beladen uitzonderingen op de serveren uitzonderingen die u aanmeldt met trackException().
  • Afhankelijkheid - Roept vanuit uw servertoepassing aan naar andere services, zoals REST API's of databases, en AJAX-aanroepen vanuit uw clientcode.
  • Beschikbaarheid: resultaten van beschikbaarheidstests.

Filteren op eigenschapswaarden

U kunt gebeurtenissen filteren op de waarden van hun eigenschappen. De beschikbare eigenschappen zijn afhankelijk van de gebeurtenistypen die u hebt geselecteerd. Klik op het filterpictogram Filterpictogram om te starten.

Het kiezen van geen waarden van een bepaalde eigenschap heeft hetzelfde effect als het kiezen van alle waarden. Hiermee wordt het filteren op die eigenschap uitgeschakeld.

U ziet dat de tellingen rechts van de filterwaarden laten zien hoeveel exemplaren er zijn in de huidige gefilterde set.

Gebeurtenissen met dezelfde eigenschap zoeken

Als u alle items met dezelfde eigenschapswaarde wilt zoeken, typt u deze in de zoekbalk of klikt u op het selectievakje wanneer u eigenschappen op het filtertabblad bekijkt.

Klik op het selectievakje van een eigenschap op het filtertabblad

De gegevens doorzoeken

Notitie

Als u complexere query's wilt schrijven, opent u Logboeken (Analytics) bovenaan de blade Zoeken.

U kunt zoeken naar termen in een van de eigenschapswaarden. Dit is handig als u aangepaste gebeurtenissen met eigenschapswaarden hebt geschreven.

Mogelijk wilt u een tijdsbereik instellen, omdat zoekopdrachten over een korter bereik sneller zijn.

Diagnostische gegevens zoeken openen

Zoek naar volledige woorden, niet naar subtekenreeksen. Gebruik aanhalingstekens om speciale tekens in te plaatsen.

Tekenreeks Niet gevonden Gevonden
HomeController.About home
controller
out
homecontroller
about
"homecontroller.about"
Verenigde Staten Uni
ted
united
states
united AND states
"united states"

Dit zijn de zoekexpressies die u kunt gebruiken:

Voorbeeldquery Effect
apple Alle gebeurtenissen zoeken in het tijdsbereik waarvan de velden het woord 'apple' bevatten
apple AND banana
apple banana
Gebeurtenissen zoeken die beide woorden bevatten. Gebruik het kapitaal 'AND', niet 'en'.
Korte vorm.
apple OR banana Gebeurtenissen zoeken die een van beide woorden bevatten. Gebruik 'OR', niet 'of'.
apple NOT banana Gebeurtenissen zoeken die het ene woord bevatten, maar niet het andere.

Steekproeven

Als uw app een grote hoeveelheid telemetrie genereert (en u de ASP.NET SDK versie 2.0.0-beta3 of hoger gebruikt), vermindert de module voor adaptieve steekproeven automatisch het volume dat naar de portal wordt verzonden door slechts een representatieve fractie van de gebeurtenissen te verzenden. Gebeurtenissen die aan dezelfde aanvraag zijn gerelateerd, worden echter geselecteerd of gedeselected als groep, zodat u tussen gerelateerde gebeurtenissen kunt navigeren.

Meer informatie over steekproeven.

Werkitem maken

U kunt een bug maken in GitHub of Azure DevOps met de details van een telemetrie-item.

Ga naar de detailweergave van de end-to-end-transactie door op een telemetrie-item te klikken en vervolgens Werkitem maken te selecteren.

Klik op Nieuw werkitem, bewerk de velden en klik vervolgens op OK.

De eerste keer dat u dit doet, wordt u gevraagd om een koppeling naar uw Azure DevOps-organisatie en -project te configureren.

(U kunt de koppeling ook configureren op het tabblad Werkitems.)

Meer telemetrie verzenden naar Application Insights

Naast de out-of-the-box telemetrie die wordt verzonden door Application Insights SDK, kunt u het volgende doen:

  • Leg logboek traceringen vast uit uw favoriete framework voor logboekregistratie in .NET of Java. Dit betekent dat u uw logboek traceringen kunt doorzoeken en deze kunt correleren met paginaweergaven, uitzonderingen en andere gebeurtenissen.
  • Schrijf code om aangepaste gebeurtenissen, paginaweergaven en uitzonderingen te verzenden.

Meer informatie over het verzenden van logboeken en aangepaste telemetrie naar Application Insights.

Q & A

Hoeveel gegevens worden bewaard?

Zie het overzicht limieten.

Hoe kan ik POST-gegevens in mijn serveraanvragen zien?

De POST-gegevens worden niet automatisch gelogd, maar u kunt TrackTrace of logboekaanroepen gebruiken. Plaats de POST-gegevens in de berichtparameter. U kunt niet op dezelfde manier filteren op het bericht als u kunt filteren op eigenschappen, maar de groottelimiet is langer.

Volgende stappen