Telemetrie van een canvas-app analyseren met behulp van Application Insights

U kunt uw app verbinden met Application Insights, een functie van Azure Monitor. Application Insights bevat krachtige analysehulpmiddelen om u te helpen bij het diagnosticeren van problemen en om te begrijpen wat gebruikers daadwerkelijk met uw app doen.

Als uw app verbonden is met Applications Insights, kunt u informatie verzamelen om u te helpen betere zakelijke beslissingen te nemen en de kwaliteit van uw apps te verbeteren.

In deze quickstart instrumenteert u een canvas-app met de naam Kudo's. Dit helpt u bij het verkennen en ontdekken van telemetrieconcepten en deze toe te passen op uw eigen canvas-apps. De voorbeeld-app Kudo's maakt deel uit van een pakket met apps voor werknemersbetrokkenheid dat kan worden gedownload van Employee Experience Starter Kit.

Vereisten

• U moet toegang hebben tot de Azure Portal.
• U moet de machtigingen hebben om Azure-resources te maken.

Optioneel

• Download en installeer de app Kudo's uit de Employee Experience Starter Kit. U kunt ook een bestaande app gebruiken.

Een Application Insights-resource maken

Voordat u telemetrie voor een app kunt verzenden, moet u een Application Insights-resource maken om de gebeurtenissen op te slaan.

1. Meld u aan bij de Azure-portal.

2. Zoeken naar Application Insights:

   

3. Een Application Insights-resource maken:

   

4. Voer de juiste waarden in en selecteer Bekijken + maken. Lees voor meer informatie Een Application Insights-resource maken.

   

5. Nadat het Application Insights-exemplaar is gemaakt, ziet u het exemplaaroverzicht. Kopieer de Instrumentatiesleutel. U hebt deze sleutel nodig om uw app te configureren.

   

Uw app verbinden met Application Insights

1. Meld u aan bij Power Apps.

2. Selecteer Apps in het linkernavigatiedeelvenster. Selecteer in de lijst met apps de app Kudo's en selecteer vervolgens Bewerken:

   

   Notitie

   U kunt ook een nieuwe app maken of een bestaande app bewerken.

3. Selecteer het object App in de linkernavigatiestructuurweergave en plak de Instrumentatiesleutel:

   

4. Sla uw app op en publiceer deze.

5. Speel de gepubliceerde app en blader door verschillende schermen.

Terwijl u door verschillende schermen bladert, worden gebeurtenissen automatisch geregistreerd in Application Insights, inclusief de gebruiksdetails zoals:

• Waar de app vandaan komt.
• Welke apparaten worden gebruikt.
• De gebruikte browsertypes.

Gebeurtenissen weergeven in Application Insights

1. Meld u aan bij Azure Portal en open de Application Insights-resource die u eerder hebt gemaakt.

2. Scrol omlaag in het linkernavigatiedeelvenster en selecteer Gebruikers onder de sectie Gebruik.

   Notitie

   De weergave Gebruikers toont gebruiksdetails van de app, zoals:

   • Aantal gebruikers dat de app heeft bekeken.
   • Aantal sessies door de gebruikers voor de app.
   • Aantal geregistreerde gebeurtenissen voor de app.
   • Besturingssystemen en browserversiegegevens van de gebruikers.
   • Regio en locatie van de gebruikers.

   Lees voor meer informatie Analyse van gebruikers, sessies en gebeurtenissen in Application Insights.

3. Selecteer een van de gebruikerssessies om in te gaan op specifieke details. U kunt informatie zien zoals de sessielengte en de bezochte schermen:

   

4. Selecteer de weergave Gebeurtenissen in het linkernavigatiedeelvenster onder de sectie Gebruik. U kunt een overzicht zien van alle schermen die in alle app-sessies zijn bekeken:

   

Aangepaste traceringsgebeurtenissen maken

U kunt aangepaste traceringen rechtstreeks naar schrijven Application Insights en beginnen met het analyseren van informatie die specifiek is voor uw scenario. Met de functie Trace kunt u het volgende verzamelen:

• Gedetailleerde gebruiksinformatie voor besturingselementen op de schermen.
• Welke specifieke gebruikers toegang hebben tot uw app.
• Welke fouten optreden.

Traceringen kunnen u ook helpen bij het diagnosticeren van problemen, omdat u een spoor van informatie kunt sturen terwijl uw gebruikers door uw app bladeren en verschillende acties uitvoeren.

Traceringsberichten kunnen op drie verschillende manieren worden verzonden wanneer aangepaste traceringsinformatie wordt verzonden naar Application Insights vanuit uw app:

• Gegevens
• Waarschuwing
• Fout

Afhankelijk van uw scenario kunt u ervoor kiezen om een traceringsbericht met de juiste ernst te verzenden. U kunt de gegevens opvragen en specifieke acties ondernemen op basis van de ernst van het bericht.

U werkt nu uw app bij en maakt een nieuw onderdeel om feedback te verzamelen op elk scherm van de app. U schrijft de gebeurtenissen naar Application Insights.

1. Aanmelden bij Power Apps.

2. Selecteer Apps in het linkernavigatiedeelvenster. Selecteer in de lijst met apps de app Kudo's en selecteer vervolgens Bewerken.

   Notitie

   U kunt ook een nieuwe app maken of een bestaande app bewerken.

3. Selecteer de optie Onderdelen in de Structuurweergave:

   

4. Selecteer Nieuw onderdeel en wijzig vervolgens de breedte naar 200 en hoogte naar 75:

   

5. Selecteer Invoegen in het menu en selecteer vervolgens Pictogrammen om Emoji - Frons en Emoji - Glimlach toe te voegen:

   

6. Selecteer Nieuwe aangepaste eigenschap om een aangepaste eigenschap te maken:

   

7. Voer de Naam en Weergavenaam van de eigenschap in, zoals FeedbackScreen.

8. Beschrijving van eigenschap invoeren

9. Selecteer Eigenschapstype als Invoer en Gegevenstype als Scherm:

   

   Notitie

   Met de eigenschap Invoer kunt u de schermnaam en het bijbehorende onderdeel vastleggen, zodat u deze informatie kunt registreren in Application Insights.

10. Selecteer het onderdeel in de Structuurweergave, selecteer Meer acties (...) en selecteer vervolgens Naam wijzigen om het onderdeel een andere naam te geven, zoals FeedbackComponent.

    

11. Selecteer de pictogrammen, selecteer Meer acties (...) en selecteer vervolgens Naam wijzigen om de pictogrammen een andere naam te geven, zoals FrownIcon en SmileIcon.

12. Selecteer FrownIcon, selecteer de eigenschap OnSelect en voer vervolgens de volgende uitdrukking in de formulebalk in:

    Trace(
       "App Feedback",
       TraceSeverity.Information,
           {
             UserName: User().FullName,
             UserEmail: User().Email,
             Screen: FeedbackComponent.FeedbackScreen.Name,
             FeedbackValue: "-1"
           }
         );
    Notify("Thanks for you feedback!");
    

    

    Notitie

    De formule-uitdrukking verzendt UserName, UserEmail, Scherm en Feedback (met de waarde -1) naar Application Insights.

13. Selecteer SmileIcon, selecteer de eigenschap OnSelect en voer vervolgens de volgende uitdrukking in de formulebalk in:

    Trace(
       "App Feedback",
       TraceSeverity.Information,
           {
             UserName: User().FullName,
             UserEmail: User().Email,
             Screen: FeedbackComponent.FeedbackScreen.Name,
             FeebackValue: "1"
           }
         );
    Notify("Thanks for you feedback!");
    

14. Het onderdeel toevoegen aan een van de schermen in uw app:

    

15. Selecteer Opslaan en selecteer vervolgens Publiceren om uw app op te slaan en te publiceren.

16. Speel de gepubliceerde app en stuur een glimlach en frons als feedback vanaf uw schermen.

    Belangrijk

    U moet de gepubliceerde app spelen om gebeurtenissen naar Application Insights te verzenden. Gebeurtenissen worden niet verzonden naar Application Insights wanneer u een voorbeeld van de app bekijkt in Power Apps Studio.

    

Gegevens analyseren in Application Insights

U kunt nu beginnen met het analyseren van de gegevens die u hebt verzonden met de functie Trace van uw app in Application Insights.

1. Meld u aan bij Azure Portal en open de Application Insights-resource die u eerder hebt gemaakt:

   

2. Selecteer Logboeken onder Toezicht houden in het linkernavigatiedeelvenster:

   

3. Voer de volgende query in en selecteer Uitvoeren. De feedback van uw app wordt geretourneerd:

   traces
   | where message == "App Feedback"
   | order by timestamp
   

   

4. Selecteer een rij in de resultaten en breid het veld customDimensions uit.

   De waarden voor Scherm, UserName, UserEmail en FeedbackBalue voor de gebeurtenis OnSelect van de glimlach- of het fronspictogram in uw onderdeel zijn opgenomen.
   Er zijn ook enkele aanvullende waarden geregistreerd voor elke gebeurtenis die naar Application Insights is verzonden, zoals appId, appName en appSessionId.

   

5. Met de volgende voorbeeldquery kunt u de eigenschappen van de aangepaste JSON-afmetingen uitbreiden en de kolommen in de resultatenweergave projecteren.

   traces
       | extend customdims = parse_json(customDimensions)
       | where message == "App Feedback"
       | project timestamp
           , message
           , AppName = customdims.['ms-appName']
           , AppId = customdims.['ms-appId']
           , FeedbackFrom = customdims.UserEmail
           , Screen = customdims.Screen
           , FeedbackValue = customdims.FeedbackValue
       | order by timestamp desc
   

   

   Tip

   Logboekquery's zijn zeer krachtig. U kunt ze gebruiken om meerdere tabellen samen te voegen, grote hoeveelheden gegevens te combineren en complexe bewerkingen uit te voeren. Lees voor meer informatie Logboekquery's.

Gegevens exporteren naar Power BI

U kunt uw Application Insights-gegevens en -queryresultaten exporteren naar Power BI voor analyse en gegevenspresentatie.

1. Meld u aan bij Azure Portal en open de Application Insights-resource die u eerder hebt gemaakt:

2. Selecteer Logboeken onder Toezicht houden in het linkernavigatiedeelvenster:

3. Selecteer Exporteren in het vervolgkeuzemenu in het queryvenster Log Analytics.

4. Selecteer de optie Exporteren naar Power BI (M-query). Hiermee downloadt u een Power BI-querybestand naar uw apparaat:

   

5. Open het gedownloade bestand in een teksteditor en kopieer de query naar het klembord.

6. Power BI openen.

7. Selecteer het vervolgkeuzemenu Gegevens verkrijgen in het lint Start en selecteer vervolgens Lege query:

   

8. Selecteer in het queryvenster Geavanceerde editor. Plak de query van stap 5 in het venster en selecteer Gereed en selecteer vervolgens Sluiten en toepassen:

   

9. U kunt ook grafieken en visualisaties maken in Power BI om feedback te presenteren die in uw app is ontvangen en om op gegevens gebaseerde beslissingen en acties te nemen.

   

Standaard Trace-gebeurteniscontext en -dimensies

Er wordt ook een set standaardafmetingen toegevoegd aan het eigenschap customDimensions voor elke Trace-gebeurtenis. Deze afmetingen kunnen worden gebruikt om de toepassing en toepassingssessies te identificeren waarin de gebeurtenissen plaatsvonden. Als u aanvullende aangepaste gegevens registreert met de functie Trace, worden deze ook weergegeven in de aangepaste afmetingen.

Niet-ondersteunde scenario's

App Insights ondersteunt de volgende scenario's niet.

• Offline en mobiele apps/spelergebeurtenissen (zowel Android als iOS) worden niet vastgelegd.
• Netwerkaanvragen en fouten worden niet vastgelegd.
• GCC en niet-openbare clouds worden niet ondersteund.