Analysere telemetri i en lærredapp ved hjælp af Application Insights

Du kan oprette forbindelse til din app ved hjælp af Application Insights, som er en funktion i Azure Monitor. Application Insights indeholder effektive analyseværktøjer, der kan hjælpe dig med at diagnosticere problemer og forstå, hvad brugerne rent faktisk gør med din app.

Når appen er knyttet til Applications Insights, kan du indsamle oplysninger, som kan hjælpe dig med at træffe bedre beslutninger for din virksomhed og øge kvaliteten af dine apps.

I denne hurtige introduktion skal du oprette en lærredapp, som hedder Kudos. På den måde kan du udforske, opleve og anvende telemetri-koncepterne til dine egne lærredapps. Kudos-eksempelappen er en del af en pakke af apps til medarbejderengagement, som kan downloades fra Startsæt til medarbejderoplevelser.

Forudsætninger

• Du skal have adgang til Azure-portalen.
• Du skal have tilladelse til at oprette Azure-ressourcer.

Valgfri

• Hent og Installer appen Kudos fra Startsæt til medarbejderoplevelser. Du kan også bruge en eksisterende app.

Oprette en Application Insights-ressource

Før du kan sende telemetri til en app, skal du oprette en Application Insights-ressource til opbevaring af hændelserne.

1. Log på Azure-portalen.

2. Søg efter Application Insights:

   

3. Oprette en Application Insights-ressource:

   

4. Angiv de ønskede værdier, og vælg Gennemse og opret. Du kan få flere oplysninger ved at læse Oprette en Application Insights-ressource.

   

5. Når Application Insights-forekomsten er oprettet, kan du se oversigten over forekomsten. Kopier Instrumenteringsnøglen. Du skal bruge denne nøgle til at konfigurere din app.

   

Oprette forbindelse fra din app til Application Insights

1. Log på Power Apps.

2. Vælg Apps i venstre navigationsrude. Vælg appen Kudos på listen over apps, og vælg derefter Rediger:

   

   Bemærk

   Du kan også oprette en ny app eller redigere en eksisterende app i stedet.

3. Vælg objektet App i navigationstræet til venstre, og indsæt Instrumenteringsnøgle:

   

4. Gem og Udgiv din app.

5. Afspil den udgivne app, og gennemse forskellige skærmbilleder.

Når du gennemser forskellige skærmbilleder, logføres hændelser automatisk i Application Insights, herunder oplysninger om forbrug som f.eks.:

• Hvor appen åbnes fra.
• De enheder, der bruges.
• De browsertyper, der bruges.

Vise hændelser i Application Insights

1. Log på Azure-portalen, og åbn den Application Insights-ressource, du har oprettet tidligere.

2. Rul ned i venstre navigationsrude, og vælg Brugere i sektionen Brug.

   Bemærk

   I visningen Brugere vises detaljer om brugen af appen, f.eks.:

   • Antallet af brugere, der fik set appen.
   • Antallet af sessioner for hver bruger af appen.
   • Antal hændelser, der er logført for appen.
   • Oplysninger om operativsystemer og browserversion for brugerne.
   • Brugernes område og placering.

   Du kan finde flere oplysninger ved at læse Brugere, sessioner og hændelsesanalyser i Application Insights.

3. Vælg en af brugersessionerne for at dykke ned i bestemte detaljer. Du kan få vist oplysninger som f.eks. sessionens længde og de besøgte skærmbilleder:

   

4. Vælg visningen Hændelser i venstre navigationsrude, og vælg sektionen Brug. Du kan se en oversigt over alle skærmbilleder, der er vist på tværs af alle appsessioner:

   

Oprette brugerdefinerede sporingshændelser

Du kan skrive brugerdefinerede spor direkte til Application Insights og begynde at analysere de oplysninger, der er specifikke for dit scenarie. Spor-funktionen giver dig mulighed for at indsamle:

• Detaljerede brugsoplysninger for kontrolelementer på skærmbillederne.
• Hvilke specifikke brugere der har adgang til din app.
• De fejl, der opstår.

Sporing kan også hjælpe med at diagnosticere problemer, fordi du kan sende et informationsspor, efterhånden som brugerne gennemser din app og udfører forskellige handlinger.

Der findes tre niveauer for sporing af meddelelser, når der sendes brugerdefinerede sporingsoplysninger til Application Insights fra din app:

• Oplysninger
• Advarsel!
• Fejl

Afhængigt af dit scenarie kan du vælge at sende en sporingsmeddelelse med den rette alvorsgrad. Du kan anmode om data og udføre bestemte handlinger på baggrund af meddelelsens alvor.

Du skal nu opdatere din app og oprette en ny komponent for at indsamle feedback på de enkelte skærmbilleder i appen. Du skal skrive hændelserne i Application Insights.

1. Log på Power Apps.

2. Vælg Apps i venstre navigationsrude. Vælg appen Kudos på listen over apps, og vælg derefter Rediger.

   Bemærk

   Du kan også oprette en ny app eller redigere en eksisterende app i stedet.

3. Vælg indstillingen Komponenter i Trævisning:

   

4. Vælg Ny komponent, og tilpas derefter bredden til 200 og højden til 75:

   

5. Vælg Indsæt i menuen, og vælg derefter Ikoner for at tilføje Emoji – Sur smiley og Emoji – Smiley:

   

6. Vælg Ny brugerdefineret egenskab for at oprette en brugerdefineret egenskab:

   

7. Angiv egenskabens Navn og Visningsnavn som f.eks. FeedbackSceen.

8. Angiv egenskabens Beskrivelse.

9. Vælg Egenskabstype som Input og Datatype som Skærmbillede:

   

   Bemærk

   Inputegenskab giver dig mulighed for at registrere skærmbillednavnet og komponenten, så du kan logføre disse oplysninger i Application Insights.

10. Vælg komponenten i Trævisning, vælg Flere handlinger (...), og vælg derefter Omdøb for at omdøbe komponenten med et sigende navn, f.eks. FeedbackComponent.

    

11. Vælg ikonerne, vælg Flere handlinger (...), og vælg derefter Omdøb for at omdøbe ikonerne med meningsfulde navne, f.eks. SurIkon og SmileyIkon.

12. Vælg SurIon, vælg egenskaben OnSelect, og angiv derefter følgende udtryk i formellinjen:

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

    

    Bemærk

    Formeludtrykket sender UserName, UserEmail, Screen og Feedback (med værdien -1) til Application Insights.

13. Vælg SmileyIkon, vælg egenskaben OnSelect, og angiv derefter følgende udtryk i formellinjen:

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

14. Føj komponenten til et af skærmbillederne i appen:

    

15. Vælg Gem, og vælg derefter Udgiv for at gemme og publicere din app.

16. Afspil den udgivne app, og send feedback med en smiley og en sur smiley fra dine skærmbilleder.

    Vigtigt

    Du skal afspille den udgivne app for at sende hændelser til Application Insights. Der sendes ikke hændelser til Application Insights, når du får vist appen i Power Apps Studio.

    

Analysere data i Application Insights

Du kan nu begynde at analysere de data, du har sendt ved hjælp af funktionen Spor fra din app i Application Insights.

1. Log på Azure-portalen, og åbn den Application Insights-ressource, du har oprettet tidligere:

   

2. Vælg Logfiler under Overvågning i venstre navigationsrude:

   

3. Angiv følgende forespørgsel, og vælg Kør. Den feedback, der modtages fra din app, returneres:

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

   

4. Vælg en række i resultaterne, og udvid feltet customDimensions.

   Værdierne for Screen, UserName, UserEmail og FeedbackValue for OnSelect-hændelsen af ikonet for smiley eller sur smiley i din komponent er blevet registreret.
   Der er også registreret flere værdier for de enkelte hændelser, der sendes til Application Insights, f.eks. appId, appName og appSessionId.

   

5. I følgende eksempelforespørgsel kan du udvide egenskaberne for de brugerdefinerede JSON-dimensioner og projicere kolonnerne i resultatvisningen.

   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

   Logføringsforespørgsler er ekstremt effektive. Du kan bruge dem til at samle flere tabeller, aggregere store mængder data og udføre komplekse handlinger. Du kan få flere oplysninger ved at læse Logføringsforespørgsler.

Eksportér data til Power BI

Du kan eksportere Application Insights-dataene og forespørgselsresultaterne til analyse og datapræsentation i Power BI.

1. Log på Azure-portalen, og åbn den Application Insights-ressource, du har oprettet tidligere:

2. Vælg Logfiler under Overvågning i venstre navigationsrude:

3. Vælg Eksport i rullemenuen i vinduet til forespørgsel om loganalyse.

4. Vælg indstillingen Eksportér til Power BI (M-forespørgsel). Dette medfører, at der hentes en Power BI-forespørgselsfil til computeren:

   

5. Åbn den hentede fil i et tekstredigeringsprogram, og kopiér forespørgslen til udklipsholderen.

6. Åbn Power BI.

7. Vælg rullemenuen Hent data på båndet Start, og vælg derefter Tom forespørgsel:

   

8. Vælg Avanceret editor i forespørgselsvinduet. Indsæt forespørgslen fra trin 5 i vinduet, vælg Udført, og vælg derefter Luk og anvend:

   

9. Du kan også oprette diagrammer og visualiseringer i Power BI, der skal repræsentere feedback modtaget i din app, samt foretage databaserede beslutninger og handlinger.

   

Standardkontekst og -dimensioner for sporingshændelser

Der føjes også et sæt standarddimensioner til egenskaben customDimensions for de enkelte sporingshændelser. Disse dimensioner kan bruges til at identificere det program og de programsessioner, hændelserne forekom i. Hvis du logfører flere brugerdefinerede data ved hjælp af sporingsfunktionen, vises de også i de brugerdefinerede dimensioner.

Ikke-understøttede scenarier

Appindsigt understøtter ikke følgende scenarier.

• Offline- og mobilapps/spillerhændelser (både Android og iOS) registreres ikke.
• Netværksanmodninger og -fejl registreres ikke.
• GCC og ikke-offentlige clouds understøttes ikke.