Telemetrihendelser for mobilappsynkronisering og -handlinger
Power Apps-mobilprogramdata relatert til frakoblede synkroniseringshendelser er tilgjengelige for modelldrevne apper og lerretsapper. Disse dataene kan brukes til å evaluere tilstanden og ytelsen til frakoblede synkroniseringshendelser for organisasjonen.
Disse dataene går inn i tabellen Power Apps>Synkronisering og handlinger for mobilapp i Application Insights. En oppføring logges når en bruker åpner en Power Apps-mobilapp, som er konfigurert for frakoblet modus. Mer data, som er relatert til feilhendelser i modelldrevne apper, er tilgjengelig via Power Apps>UCI.
Hvis du vil ha flere spørringseksempler og et eksempelinstrumentbord, kan du gå til Eksempel på instrumentbord for telemetri for frakoblet profilbruk for Field Service Mobile-appen.
Hendelsesdefinisjoner for synkronisering og handlinger for mobilapp
- id: Hendelses-ID.
- target: Navnet på scenarioet som spores av hendelsen.
- type: Kildetabell for hendelsen.
- name: Navnet på scenarioet som spores av hendelsen.
- duration: Varigheten til scenarioet i millisekunder. Varigheten kan omfatte lange perioder mens appen er inaktiv.
- operation_Id: Unik identifikator for økten.
- operation_ParentId: Unik identifikator for scenarioet som spores av hendelsen.
- user_Id: Bruker-ID for Microsoft Entra.
- application_Version: Versjonen av appen.
-
customDimensions: Inneholder følgende attributter:
- "EventName": Sammendrag av scenarioet som spores av hendelsen (ScenarioEnd).
- "ScenarioResult": SUCCESS eller FAILURE.
- ErrorCode: Feilkode som genereres ved synkroniseringsfeil. Finn ut mer i tabellen for feilkodetilordning.
- ErrorMessage: Tom hvis det ikke oppstod noen feil, eller streng som beskriver feilen.
- FailureType: Definerer typen synkroniseringsfeil.
- LogLevel: Alvorsgraden eller rapporteringsnivået for hendelsen. Gyldige verdier er info, error, warning, error eller verbose.
-
DataSyncMode: Hvilken type frakoblet synkronisering brukeren har opplevd.
- DELTA_SYNC: Automatisk trinnvis synkronisering.
- GRID_SYNC: Utløst av en oppdatering i en rutenettvisning.
- FIRST_SYNC: Første synkronisering på en enhet (eller etter en avlogging / ny konfigurasjon).
- FORCED_SYNC: Utløst fra knappen på Enhetsstatus-siden.
- SINGLE_RECORD_SYNC: Utløst av push-varsel.
- AppFlavor: Opprinnelig app som er installert på enhetene. Gyldige verdier er FieldService og PowerApps.
- AppInfo_Version: Versjonen av den opprinnelige appen, slik den vises i appbutikken.
- ActiveDuration: Scenariovarighet i millisekunder der bare tiden mens appen er aktiv, er inkludert.
- DeviceInfo_Id: Unik identifikator for enheten.
- DeviceInfo_model: Enhetsmodell (for eksempel iPhone 13).
- DeviceInfo_make: Enhetsfabrikat (for eksempel Apple).
- DeviceInfo_OsName: Operativsystemet på enheten (for eksempel Android).
- DeviceInfo_OsVersion: Versjonen av operativsystemet (for eksempel Android 13).
- Loc_country: Enhetsopprinnelse for telemetri.
-
eventContext: Inneholder følgende egenskaper:
- CurrentSyncId: ID for en vellykket synkronisering. Tilbakestill etter hver vellykket synkronisering. (Den tilbakestilles ikke etter en feil.)
- CurrentActivityId: ID for synkroniseringen. Tilbakestill etter hver synkronisering.
- entityName: Navnet på tabellen i datanedlastingshendelser.
- ProfileId: ID for den frakoblede profilen som er konfigurert for appen og brukeren.
- RecordCount: Antall oppføringer som er lastet ned.
- ResponseSize: Størrelse på innkommende nyttelastdata som rapportert av HTTPClient (komprimert størrelse).
- ContentLength: Størrelse på innkommende nyttelastdata som rapportert av HTTPClient (komprimert størrelse).
Feilhendelser i enhetlig klientgrensesnitt
- timestamp [UTC]: Når hendelsen skjedde.
- problemId: "uci_trace" eller "uciMonitorFailure" (der dataene kom fra.)
- type: "uci_trace" eller "uciMonitorFailure" (der dataene kom fra.)
- outType: "uci_trace" eller "uciMonitorFailure" (der dataene kom fra.)
- outerMessage: Feilmelding.
- itemType: "exception"
-
CustomDimensions:
- eventContext: Flere detaljer knyttet til feilen.
- ServerConnectivityState: Er brukeren i frakoblet modus? (Frakoblet/tilkoblet)
- NetworkConnectivityState: Har brukeren Internett-tilkobling? Vær oppmerksom på at en bruker kan være i frakoblet modus, men ha en Internett-tilkobling.
- IsOfflineByDefaultApp: Når denne er false, betyr det at funksjonen Arbeid i frakoblet modus er aktivert. Når denne er true, betyr det at Offline først er aktivert.
- callStack: Programmeringskoden der feilen oppstod.
- hostSubType: "PowerApps-Player-iOS-fieldservice"
- hostType: "MobileApplication"
- Operation_ID: En strengsammenkjeding av sessionID etterfulgt av en _ og ID for ekstern korrelasjon, for eksempel e11e8465-bc8f-4319-b64a-9c1e42453148_0da90a33-ad68-4a4e-bd45-5728d5da719a.
- Operation_ParentID: Aktivitets-ID knyttet til feil.
- SessionId: Økt-ID for feil.
- UserId: Bruker-ID for Dynamics 365.
- User_authenticatedID: Bruker-ID for Dynamics 365.
- Application_version: Appversjonen, for eksempel 9.2.24045.00212.
- Client_Type: Operativsystemversjon, for eksempel iOS eller Android.
Eksempelscenarioer
Synkroniseringsfeil i frakoblet modus etter feilkode
Med denne spørringen kan du se hvilke typer feil frontlinjearbeidere kan få når en synkronisering mislykkes. Enkelte feil utelates, for eksempel hvis mobilprogrammet lukkes under synkronisering, eller hvis nettverket kobles fra under synkronisering og hindrer at synkroniseringen fullføres. Definisjon av feilkoder vises i tabellen for feilkodetilordning.
dependencies
| where name == "Offline.SyncDatabase"
| where success == false
| extend cd = parse_json(customDimensions)
| extend AppVersion = tostring(cd.AppInfo_Version)
| extend ErrorCode = tostring(cd.ErrorCode)
| extend ErrorMessage = tostring(cd.ErrorMessage)
| extend FailureType = tostring(cd.FailureType)
| summarize dcount(user_Id), count() by ErrorCode, ErrorMessage, FailureType, bin(timestamp, 1d)
Oppføringer i gjennomsnitt synkronisert etter tabell
Med denne spørringen kan du evaluere hvilke tabeller som bidrar med flest oppføringer til en synkronisering. Du kan bruke disse dataene til å prøve å optimalisere den frakoblede profilen ytterligere for å redusere antall oppføringer eller data i hver tabell.
dependencies
| where name endswith_cs "Offline.DdsClient.GetRecords"
| extend cd = parse_json(customDimensions)
| extend ec = parse_json(tostring(cd.eventContext))
| extend RecordCount = toint(ec.RecordCount)
| extend EntityName = tostring(ec.EntityName)
| extend syncid = tostring(ec.CurrentSyncId)
| extend DataSyncMode = tostring(cd.DataSyncMode)
//| where DataSyncMode == "FIRST_SYNC" //This is used to pivot on the type of sync being executed.
| summarize sum(RecordCount) by syncid, EntityName, DataSyncMode, user_Id
| summarize percentile(sum_RecordCount, 50), arg_max(sum_RecordCount, user_Id), count() by EntityName, DataSyncMode
Gjennomsnittlig synkroniseringsvarighet etter synkroniseringsmodus
Denne spørringen gjør at du kan evaluere den gjennomsnittlige synkroniseringsvarigheten for brukere i organisasjonen.
dependencies
| where name == "Offline.SyncDatabase"
| extend cd = parse_json(customDimensions)
| extend ActiveDuration = toint(tostring(cd.ActiveDuration))
| extend WithBackgroundTime = duration
| extend DataSyncMode = tostring(cd.DataSyncMode)
| summarize percentile(ActiveDuration, 50), percentile(WithBackgroundTime, 50) by client_Type, DataSyncMode
Synkroniseringsdetaljer etter bruker
Denne spørringen gir en per bruker-visning av synkronisering, inkludert dato for siste synkronisering, siste feil, synkroniseringsvarighet og synkroniserte oppføringer.
dependencies
| where name == "Offline.SyncDatabase"
| extend cd = parse_json(customDimensions)
| extend ActiveDuration = toint(tostring(cd.ActiveDuration))
| extend WithBackgroundTime = duration
| extend DataSyncMode = tostring(cd.DataSyncMode)
| extend ErrorMessage = tostring(cd.ErrorMessage)
| summarize percentile(ActiveDuration, 50), percentile(WithBackgroundTime, 50), arg_max(timestamp, ErrorMessage), countif(success == false) by user_Id, DataSyncMode
Brukere etter enhetstype og appversjon
Denne spørringen gir mer informasjon om brukere i organisasjonen som åpner mobilprogrammet på enhetsmodellen sin.
dependencies
| where name == "Offline.SyncDatabase"
| extend cd = parse_json(customDimensions)
| extend AppVersion = tostring(cd.AppInfo_Version)
| summarize dcount(user_Id) by AppVersion, client_Type
Feilkodetilordning
Feilkode | Feiltype | Definisjon |
---|---|---|
-2146864604 | CONFIG_ERROR | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2146864606 | CONFIG_ERROR | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2146864607 | CONFIG_ERROR | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2146864608 | CONFIG_ERROR | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2146869250 | CONFIG_ERROR | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147015328 | ACCESS_ERROR | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147088248 | CONFIG_ERROR | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147155198 | FEIL | Når det gjelder feilkoder som begynner med –214, kan du se Feilkoder for nettjenesten. |
-2147155198 | ACCESS_ERROR | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147167669 | ACCESS_ERROR | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147180269 | ACCESS_ERROR | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147180284 | ACCESS_ERROR | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147187375 | FEIL | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147187388 | FEIL | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147187389 | FEIL | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147204270 | FEIL | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147204339 | FEIL | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147204784 | FEIL | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147209463 | ACCESS_ERROR | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147217124 | FEIL | Når det gjelder feilkoder som begynner med –214, kan du se Feilkoder for nettjenesten. |
-2147220884 | FEIL | Når det gjelder feilkoder som begynner med –214, kan du se Feilkoder for nettjenesten. |
-2147220955 | ACCESS_ERROR | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147220956 | EXTERNAL_ERROR | Når det gjelder feilkoder som begynner med –214, kan du se Feilkoder for nettjenesten. |
-2147220960 | ACCESS_ERROR | Feil ved app- eller brukerkonfigurasjon. Se Feilkoder for nettjenesten. |
-2147220970 | FEIL | Når det gjelder feilkoder som begynner med –214, kan du se Feilkoder for nettjenesten. |
-2147220989 | FEIL | Når det gjelder feilkoder som begynner med –214, kan du se Feilkoder for nettjenesten. |
-50 | FEIL | Intern feil. |
0 | FEIL | Ukjent feil. |
2000 | FEIL | Ikke tilordnet-feil. |
2002 | FEIL | Dataverse SQL-tidsavbrudd. |
2003 | DATABASE_ERROR | Databasefeil. |
2004 | NETWORK_ERROR | Nettverksfeil. |
2005 | SERVER_ERROR | Serverfeil. |
2006 | AUTH_ERROR | Godkjenningsfeil. |
2007 | DEVICE_ERROR | Feil på grunn av full disk. |
2008 | FEIL | Intern feil. |
2009 | AUTH_ERROR | Godkjenningsfeil. |
2011 | CONFIG_ERROR | Feil ved rettighet til appmodulen. |
2016 | CONFIG_ERROR | Feil ved konfigurasjon i frakoblet modus. |
2017 | CONFIG_ERROR | Feil ved konfigurasjon av frakoblet profil. |
3000 | EXPECTED_ERROR | Synkroniser intern hendelse. |
3003 | CONFIG_ERROR | Feil ved konfigurasjon av frakoblet profil. |