Del via

Telemetrihendelser for mobilappsynkronisering og -handlinger

  • Artikkel

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.