Analysere systemgenererede logfiler ved hjælp af Application Insights

Oprette forbindelse med din lærredapp og Application Insights, som er en funktion i Azure Monitor. Application Insights indeholder analyseværktøjer, der hjælper med at diagnosticere problemer og forstå brugeradfærd i apps. Brug de indsamlede oplysninger til at træffe bedre forretningsbeslutninger og forbedre appkvaliteten.

Forudsætninger

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

Bemærk

Hvis du vil have vist telemetrioplysninger, skal lejeradministratoren aktivere lærredapp-indsigt. Log på som administrator i Power Platform Administration. Vælg Indstillinger>Lejerindstillinger>Lærredapp-indsigt. I lærredapp-indsigt skal du slå kontakten til og gemme ændringerne. Få mere at vide i Lejerindstillinger.

Oprette en Application Insights-ressource

Send systemoprettede logfiler fra en app ved at oprette en Application Insights-ressource til lagring af hændelser.

Flere oplysninger om opret en arbejdsområdebaseret ressource til Application Insights Azure portalen.

Oprette forbindelse fra din app til Application Insights

Bemærk

• Når du angiver en forbindelsesstreng, skal du huske, at data kan sendes på tværs af lejere. Sporingshændelser sendes til den App Insights-ressource, der svarer til den forbindelsesstreng, du har angivet for din app, også selvom forekomsten af destinationsappen Insights er i en anden lejer end appen.
• Vær forsigtig, når du importerer eksisterende .msapp-filer, da der kan være forbindelsesstrenge til App Insights. Åbn appen manuelt efter importen for at kontrollere, at den korrekte forbindelsesstreng i App Insights bruges.

1. Log på Power Apps.

2. Åbn en app at redigere den.

3. Vælg objektet App i navigationstræet til venstre, og indsæt Forbindelsesstreng fra din Application Insights-ressource:

   

4. Gem og Udgiv din app.

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

Når du gennemser appskærmene, logges automatisk hændelser til Application Insights. Disse omfatter brugsoplysninger som:

• Hvor brugere kan aktivere appen fra
• Hvilke enheder brugerne bruger
• De typer af browsere, som brugerne anvender

Vigtige oplysninger

Afspil 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.

Vise hændelser i Application Insights

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

2. Vælg visningen Brugere i venstre navigationsrude, og vælg sektionen Brug.

   Bemærk

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

   • Antallet af brugere, der fik set appen
   • Antal af brugersessioner
   • Antal logførte hændelser
   • Oplysninger brugernes operativsystemer og browserversion
   • Brugernes område og placering

   Få mere at vide om analyse af brugere, sessioner og hændelser i Application Insights.

3. Vælg en brugersession for at se specifikke detaljer, f.eks. sessionslængde og 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.

   

Tip

Udforsk flere Application Insights funktioner, såsom:

• Tragter
• Kohorter
• Effektanalyse
• Opbevaringsanalyse
• Brugsflows

Oprette brugerdefinerede sporingshændelser

Skriv brugerdefinerede sporinger til Application Insights for at analysere oplysninger, der er specifikke for din app. 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 hjælper dig med at diagnosticere problemer ved at sende et spor af oplysninger, når brugerne gennemser din app og udfører handlinger. Sporingsmeddelelser, der sendes for Application Insights at modtage en af tre forespørgsler:

• Information
• Advarsel!
• Error

Send en sporingsmeddelelse med den relevante alvorsgrad baseret på situationen. Du kan anmode om data og udføre bestemte handlinger på baggrund af alvoren

Bemærk

Hvis du logfører personlige data, skal du være opmærksom på dine forpligtelser i forhold til forskellige love og regler om beskyttelse af personlige oplysninger. Se Microsoft Trust Center og Service Trust Portal for af få flere oplysninger.

Opret en komponent i din app for at indsamle feedback på hvert skærmbillede og logføre hændelser 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 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 egenskaben Navn og Visningsnavn (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 FrownIcon, 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 your feedback!");
    

    

    Bemærk

    Formeludtrykket sender UserName, UserEmail, Skærm 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 your 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 eller en sur smiley fra dine skærmbilleder.

    Vigtige oplysninger

    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 brugerdefinerede 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 Application Insights-ressourcen, 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 for at se feedback fra din app:

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

   

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

   Værdierne for Skærm, UserName, UserEmail og FeedbackValue for OnSelect-hændelsen af ikonet for glad smiley eller sur smiley i din komponent er blevet registreret. Værdier registreres også 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 effektive. Du kan bruge dem til at samle flere tabeller, aggregere store mængder data og udføre komplekse handlinger. Få mere at vide om brug af logføringsforespørgsler.

Analysér data om appens livscyklus i Application Insights

Sessionsoversigtshændelsen logføres én gang pr. session og indeholder oplysninger om vellykket appåbning, optimal appåbning vs. ikke-optimale sessioner og metrikværdier for ydeevne for appåbning.

Grænser

Disse hændelser er nøjagtige for lærredapp, der kører i en webbrowser. De er ikke tilgængelige for apps, der kører på Power Apps-mobilenheder, og deres værdier er muligvis ikke altid tilgængelige eller nøjagtige for brugerdefinerede sider.

Her er et eksempel på en forespørgsel, der viser, hvordan du får adgang til hændelsen med sessionsoversigten og alle tilgængelige felter:

customEvents 
| where name == "PowerAppsClient.PublishedApp.SessionLoadSummary" 
// 
| extend cd = parse_json(customDimensions) 
// 
| extend sessionSummary = parse_json(tostring(cd["ms-sessionSummary"])) 
| extend successfulAppLaunch = tobool(sessionSummary["successfulAppLaunch"]) 
| extend unsuccessfulReason = tostring(sessionSummary["unsuccessfulReason"]) 
| extend appLoadResult = tostring(sessionSummary["appLoadResult"]) 
| extend appLoadNonOptimalReason = 
tostring(sessionSummary["appLoadNonOptimalReason"]) 
// 
| extend timeToAppInteractive = todouble(sessionSummary["timeToAppInteractive"]) 
| extend timeToAppFullLoad = todouble(sessionSummary["timeToAppFullLoad"]) 
// 
| project 
    timestamp, 
    session_Id, 
    successfulAppLaunch, 
    unsuccessfulReason, 
    appLoadResult, 
    appLoadNonOptimalReason, 
    timeToAppInteractive, 
    timeToAppFullLoad 
| limit 5 

Følgende felter hjælper med at måle, hvor vellykkede appåbninger og latens for ydeevnemarkører er knyttet til slutbrugeroplevelser.

Felt	Description
successfulAppLaunch	Boolesk værdi, der angiver, om sessionen har startet appen
unsuccessfulReason	Hvis sessionen ikke kunne starte appen, angiver dette årsagen / fejlen. Dette felt vil være en tom streng, hvis sessionen lykkedes.
appLoadResult	Angiver, om sessionen var optimal eller ej. Mulige værdier: optimal, andet
appLoadNonOptimalReason	Hvis sessionen ikke var optimal, angiver dette årsagen. Mulige værdier: interaktion-påkrævet, begrænset, skærm-navigeret-væk, andet
timeToAppInteractive	Varighed i millisekunder for appsessionen at nå en interaktiv tilstand. I denne tilstand kan brugerne begynde at interagere med det første skærmbillede, men dataene indlæses muligvis ikke fuldt ud.
timeToAppFullLoad	Varighed i millisekunder for appsessionen at nå en fuldt indlæst tilstand, hvor alle dataanmodninger for det første skærmbillede er indlæst.

Eksempelforespørgsler

Succesfrekvens for åbning af app

Denne forespørgsel viser succesraten for åbning af appen pr. dag. Dette kan bruges til at evaluere stigninger eller tendenser i problemer, som brugerne kan opleve

customEvents 
| where name == "PowerAppsClient.PublishedApp.SessionLoadSummary" 
| extend cd = parse_json(customDimensions) 
| extend sessionSummary = parse_json(tostring(cd["ms-sessionSummary"])) 
| extend successfulAppLaunch = tobool(sessionSummary["successfulAppLaunch"]) 
| summarize 
sessions_total = dcount(session_Id), 
sessions_success = dcountif(session_Id, successfulAppLaunch == true) 
by bin(timestamp, 1d) 
| extend successRate =  
100.0 * (todouble(sessions_success) / todouble(sessions_total)) 
| project timestamp, successRate 
| render timechart

Antal mislykkede sessioner efter årsag

Denne forespørgsel viser antallet af mislykkede sessioner efter årsag/fejl. Dette kan bruges til at foretage fejlfinding af fejl i forbindelse med åbning af apps eller evaluere tendenser i problemer, som brugerne kan opleve.

customEvents 
| where name == "PowerAppsClient.PublishedApp.SessionLoadSummary" 
| extend cd = parse_json(customDimensions) 
| extend sessionSummary = parse_json(tostring(cd["ms-sessionSummary"])) 
| extend successfulAppLaunch = tobool(sessionSummary["successfulAppLaunch"]) 
| extend unsuccessfulReason = tostring(sessionSummary["unsuccessfulReason"]) 
| where successfulAppLaunch == false 
| summarize 
count() 
by unsuccessfulReason, bin(timestamp, 1d) 
| render timechart

Ydeevne for åbning af app

Denne forespørgsel viser ydeevnemetrikker for åbning af app efter dag. Dette kan bruges til at evaluere ydeevnetendenser over tid eller efter at have foretaget ændringer. Vi anbefaler:

1. Brug af 75 %-fraktilen af felterne timeToAppInteractive og timeToAppFullLoad for at undgå støj forårsaget af afvigende værdier.
2. Filtrering til kun optimale sessioner for at undgå støj i dataene forårsaget af forventede sager som sessioner med brugerinteraktion, sessioner, hvor appen blev indlæst i en baggrundsfane osv.

customEvents 
| where name == "PowerAppsClient.PublishedApp.SessionLoadSummary" 
| extend cd = parse_json(customDimensions) 
| extend sessionSummary = parse_json(tostring(cd["ms-sessionSummary"])) 
| extend appLoadResult = tostring(sessionSummary["appLoadResult"]) 
| extend timeToAppInteractive = todouble(sessionSummary["timeToAppInteractive"]) 
| extend timeToAppFullLoad = todouble(sessionSummary["timeToAppFullLoad"]) 
| where appLoadResult == "optimal" 
| summarize 
percentile(timeToAppInteractive, 75), 
percentile(timeToAppFullLoad, 75) 
by bin(timestamp, 1d) 
| render timechart

Appindlæsningstilstand ved HTTP-kald

Der er en ny anmodningsoverskrift x-ms-app-load-state, der angiver, om et HTTP-kald bidrog til start af appen. Dette kan specifikt bruges til at bestemme, hvilke HTTP-kald der påvirkede timeToAppFullLoad ovenfor.

Overskriften kan være en af to værdier:

Værdi	Description
TTFL	Angiver, at anmodningen har bidraget til timeToAppFullLoad
PostTTFL	Angiver, at anmodningen ikke bidrog til timeToAppFullLoad

Her er en eksempelforespørgsel, der viser, hvordan du får adgang til headerværdien og projicerer den i kolonnen appLoadState:

dependencies 
| extend cd = parse_json(customDimensions) 
| extend requestHeaders = parse_json(tostring(cd["requestHeaders"])) 
| extend appLoadState = tostring(requestHeaders["x-ms-app-load-state"]) 
| project timestamp, session_Id, appLoadState, name, duration 
| limit 5

Antal HTTP-kald, der bidrager til fuld belastning

Denne forespørgsel viser det gennemsnitlige antal HTTP-kald, der bidrager til timeToAppFullLoad pr. dag. Dette kan bruges til at evaluere antallet af kald, som appen foretager ved start, og som kan bidrage til dårlig ydeevne.

dependencies 
| extend cd = parse_json(customDimensions) 
| extend requestHeaders = parse_json(tostring(cd["requestHeaders"])) 
| extend appLoadState = tostring(requestHeaders["x-ms-app-load-state"]) 
| where appLoadState == "TTFL" 
| summarize httpCalls = count() by session_Id, bin(timestamp, 1d) 
| summarize avg(httpCalls) by timestamp 
| render timechart

Varighed af HTTP-kald, der bidrager til fuld belastning

Denne forespørgsel viser den samlede varighed af HTTP-kald, der bidrager til timeToAppFullLoad, pr. dag. Dette kan bruges til at evaluere den samlede effekt af HTTP-kald på ydeevnen ved start af apps.

dependencies 
| extend cd = parse_json(customDimensions) 
| extend requestHeaders = parse_json(tostring(cd["requestHeaders"])) 
| extend appLoadState = tostring(requestHeaders["x-ms-app-load-state"]) 
| where appLoadState == "TTFL" 
| summarize httpCallDuration = sum(duration) by session_Id, bin(timestamp, 1d) 
| summarize percentile(httpCallDuration, 80) by timestamp 
| render timechart

Varighed af HTTP-kald, der bidrager til fuld indlæsning efter URL-adresse

I lighed med ovenstående viser denne forespørgsel antallet og varigheden af HTTP-kald, der bidrager til timeToAppFullLoad, efter URL. Dette kan bruges til at identificere bestemte langsomme HTTP-kald, der påvirker ydeevnen ved start af apps.

dependencies 
| extend cd = parse_json(customDimensions) 
| extend requestHeaders = parse_json(tostring(cd["requestHeaders"])) 
| extend appLoadState = tostring(requestHeaders["x-ms-app-load-state"]) 
| where appLoadState == "TTFL" 
| summarize 
count(), percentile(duration, 80) by name

Overvåge ikke-håndterede fejl (eksperimentel)

[Dette afsnit indeholder dokumentationen til den foreløbige udgivelse. Der kan blive foretaget ændringer.]

Vigtige oplysninger

• Dette er en eksperimentel funktion.
• Eksperimentelle funktioner er ikke beregnet til produktion og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.

Du kan ikke altid forudse eller planlægge for alle fejl, der kan opstå, mens appen kører. Ikke-håndterede Power Fx-formelfejl rapporteres til brugere som bannermeddelelser. De kan også rapporteres til Application Insights for at vise deres hyppighed og alvorsgrad uden at være afhængige af, at appens brugere rapporterer problemer. Du kan også konfigurere advarsler i realtid, når der opstår kørselsfejl, for at gøre det mere proaktivt.

Aktivere fejloverførsel til Application Insights

Aktivér den indstilling, der lader Power Apps overføre uhåndterede kørselsfejl til Azure Application Insights.

Advarsel!

Aktivering af indstillingen Overfør fejl til Azure Application Insights kan medføre ekstra omkostninger til lagring af Application Insights logfiler.

1. Åbn lærredappen til redigering.
2. Vælg Indstillinger>Opdateringer>eksperimentel, og aktivér Overfør fejl til Azure Application Insights.
3. Gem og publicer derefter din app.

Fejlhændelser i Application Insights

Uhåndterede Power Fx fejl, som brugere støder på under kørsel af apps, rapporteres til tabellen Traces. Ikke-håndterede fejl kan identificeres og skelnes fra andre fejlhændelser ved hændelsesmeddelelsen "Uhåndteret fejl". Dimensionen "severityLevel" for disse hændelser er 3 (TraceSeverity.Error).

Der vises detaljerede fejlmeddelelser i dimensionen "errors" i egenskaben customDimension. I situationer, hvor der opstod flere fejl under samme handling, er fejlene samlet i dimensionen "fejl" for en enkelt sporingshændelse. Fejlmeddelelserne svarer til dem, der er rapporteret i Overvågning under en direkte fejlfindingssession.

Denne eksempelforespørgsel identificerer ikke-håndterede fejl og udvider alle fejlmeddelelser i sporingshændelsen:

traces
    | where message == "Unhandled error"
    | extend customdims = parse_json(customDimensions)
    | extend errors = parse_json(tostring(customdims.['errors']))
    | mv-expand errors
    | project timestamp
        , itemId //unique identifier for the trace event
        , AppName = customdims.['ms-appName']
        , AppId = customdims.['ms-appId']
        , errors = errors.['Message']
    | order by timestamp desc

Korrelationssporing (eksperimentel)

[Dette afsnit indeholder dokumentationen til den foreløbige udgivelse. Der kan blive foretaget ændringer.]

Vigtige oplysninger

• Dette er en eksperimentel funktion.
• Eksperimentelle funktioner er ikke beregnet til produktion og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.

Oprettelse af forbindelse til eksterne data og tjenester er essentiel for de fleste apps. Korrelationssporing genererer og overfører kontekstoplysninger for at forbinde systemgenererede logfiler på tværs af en lærredapp og dens forbindelser med visse begrænsninger. Din app kan f.eks. kalde en brugerdefineret connector, der derefter kalder en Azure-funktion eller en anden REST API. Korrelationssporing giver dig mulighed for at korrelere handlinger, der er foretaget i appen, med de underliggende API-kald på tværs af niveauer. Dette er nyttigt i forbindelse med fejlfinding.

Lærredapp korrelationssporing implementerer kontekstsporing og følger W3C-specifikationen.

Aktivere korrelationssporing

Advarsel!

Aktivering af denne indstilling kan medføre yderligere omkostninger i forbindelse med lagring af Application Insights logfiler.

1. For at aktivere korrelationssporing skal du åbne din lærredapp til redigering.
2. Vælg Indstillinger>Opdateringer>Eksperimentel>, og Aktiver Azure Application Insights korrelationssporing.
3. Gem og publicer appen.

Begrænsninger

• Korrelationssporing fungerer kun med brugerdefinerede connectorer. Andre tilslutningstyper understøttes ikke.
• HTTP-forespørgsler registreres kun i Application Insights, hvis den tilknyttede service også er tilsluttet Application Insights.

Brug af korrelationssporing

Når korrelationssporing er aktiveret, tilføjes der en ny systemgenereret logfilhændelse i afhængighedstabellen for lærredappens Application Insights-forekomst. Denne hændelse registreres, når der modtages et svar fra et netværksopkald. Afhængighedshændelser registrerer oplysninger om netværkskaldet, herunder anmodnings- og svarheadere, svarstatuskode og varigheden af kaldet.

Hvis den tilknyttede tjeneste Application Insights også er tilsluttet, oprettes der en yderligere systemgenereret logfilhændelse, der henter anmodningen, i forespørgselstabellen for servicens Application Insights-forekomst. Nogle Azure-tjenester, f.eks. Azure Functions, kan oprette forbindelse uden kodning fra Azure-portalen. Både lærredappen eller flere apps og tilknyttede services kan have forbindelse til den samme Application Insights-forekomst.

Deltag i netværksopkald for understøttede connectorer med andre systemoprettede logge på dimensionen "operation_Id". Følgende forespørgsel viser et netværksopkald sammen med sporingshændelser, der udsendes under en appsession.

traces | union dependencies | union requests | union pageViews | union customEvents
| project timestamp
    , itemType
    , name
    , operation_Name
    , message
    , severityLevel
    , customDimensions
    , operation_Id
    , operation_ParentId
| where operation_Id == "0a7729e3e83c4e4d93cb4f51149f73b9" //placeholder operation_Id, replace
| order by timestamp asc

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 Eksporter til Power BI (M-forespørgsel) for at downloade en Power BI forespørgselsfil.

   

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

6. Åbn Power BI.

7. Vælg menuen 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 i vinduet, vælg Udført, og vælg derefter Luk & Anvend.

   

Opret diagrammer og visualiseringer i Power BI, der skal repræsentere feedback fra din app, og foretag databaserede beslutninger.

Standardkontekst og -dimensioner for sporingshændelser

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

Dimensionsnavn	Repræsenterer
ms-appId	Program-id'et for den app, der har sendt hændelsen.
ms-appname	Programnavnet for den app, der har sendt hændelsen.
ms-appSessionId	Programsessionens id. Denne værdi udfyldes muligvis ikke i visse scenarier. Hvis denne værdi er tilgængelig, tilsidesættes standarddimensionen sessionID for Application Insights.
ms-tenantID	Det entydige id for den lejer, hvor programmet udgives.
ms-environmentId	Navnet for det miljø, hvor programmet udgives.
userId	Entydigt id for den slutbruger, der er tilknyttet sessionen.
ms-duration	En imputeret værdi, der måler den tid, det tager for en bruger at navigere fra ét skærmbillede til et andet. Denne værdi tilsidesætter standardvarighedsdimensionen PageView for Application Insights.
sessionId	Et sessions-id, der kan bruges til at korrelere alle hændelser, der er knyttet til en enkelt programsession. Denne værdi er altid til stede og anbefales, hvis du vil forstå antallet af entydige sessioner. Denne værdi tages fra spillerens sessions-id og vises, når du får vist detaljer om sessionen, mens du spiller appen. Sessions-id'et får undertiden en standardværdi, en vilkårlig værdi og en entydig Application Insights-genereret værdi. Denne standardværdi er ikke pålidelig og svarer ikke til nogen appspecifikke parametre.
Varighed	En imputeret værdi, der måler den tid, det tager for en bruger at navigere fra ét skærmbillede til et andet. Denne værdi er den samme som den varighed, der rapporteres af ms-duration-dimensionen.
ms-isTest	Angiver, om sessionen er knyttet til Test Studio-testprøven.
ms-currentScreenName	Navnet på den side, en slutbruger navigerer fra (tilgængelig i forbindelse med sidenavigationshændelser).
ms-targetScreenName	Navnet på den side, en bruger navigerer til (i forbindelse med sidenavigationshændelser).

Ikke-understøttede scenarier

Application Insights understøtter ikke disse scenarier.

• Offlinespillerbegivenheder optages ikke.
• Hændelser fra mobilapps (iOS og Android) registreres ikke, når appen stoppes midlertidigt.