Del via

Telemetrihændelser til mobilappsynkronisering og -handlinger

  • Artikel

Data fra Power Apps-mobilapps, der er relateret til hændelser med offlinesynkronisering, er tilgængelige for modelbaserede apps og lærredapps. Disse data kan bruges til at evaluere tilstanden og ydeevnen af offlinesynkroniseringshændelser for din organisation.

Disse data overføres til tabellen Power Apps>Synkronisering og handlinger for mobilapp i Application Insights. En post logføres, når en bruger får adgang til en Power Apps-mobilapp, der er konfigureret til offlinetilstand. Flere data, der er relateret til fejlhændelser i modelbaserede apps, er tilgængelige via Power Apps>UCI.

Definitioner af mobilappsynkronisering og handlingshændelser

  • id: Hændelses-id.
  • target: Navnet på det scenarie, der spores af hændelsen.
  • type: Kildetabel for hændelsen.
  • name: Navnet på det scenarie, der spores af hændelsen.
  • duration: Scenariets varighed i millisekunder. Varigheden kan omfatte lange perioder, hvor appen er inaktiv.
  • operation_Id: Entydigt id for sessionen.
  • operation_ParentId: Entydigt id for det scenarie, der spores af hændelsen.
  • user_Id: Microsoft Entra-bruger-id.
  • application_Version: Version af appen.
  • customDimensions: Indeholder følgende attributter:
    • "EventName": Oversigt over det scenarie, der spores af hændelsen (ScenarioEnd).
    • "ScenarioResult": SUCCESS eller FAILURE.
    • ErrorCode: Fejlkode, der genereres ved synkroniseringsfejl. Få mere at vide i Fejlkodetilknytningstabel.
    • ErrorMessage: Tom ved vellykket udførelse eller streng, der beskriver fejlen.
    • FailureType: Definerer typen af synkroniseringsfejl.
    • LogLevel: Alvorsgraden eller rapporteringsniveauet for hændelsen. Gyldige værdier er info, error, warning, error eller verbose.
    • DataSyncMode: Hvilken type offlinesynkronisering brugeren har oplevet.
      • DELTA_SYNC: Automatisk trinvis synkronisering.
      • GRID_SYNC: Udløses af en opdatering af en gittervisning.
      • FIRST_SYNC: Første synkronisering på en enhed (eller efter logout/omkonfiguration).
      • FORCED_SYNC: Udløses fra knappen på siden Enhedsstatus.
      • SINGLE_RECORD_SYNC: Udløses af pushmeddelelse.
    • AppFlavor: Indbygget app installeret på enhederne. Gyldige værdier er FieldService og PowerApps.
    • AppInfo_Version: Version af den indbyggede app, som vist i appbutikken.
    • ActiveDuration: Scenariets varighed i millisekunder, som kun omfatter den tid, hvor appen er aktiv.
    • DeviceInfo_Id: Entydigt id for enheden.
    • DeviceInfo_model: Enhedsmodel (f.eks. iPhone 13).
    • DeviceInfo_make: Enhedsmærke (f.eks. Apple).
    • DeviceInfo_OsName: Enhedens operativsystem (f.eks. Android).
    • DeviceInfo_OsVersion: Version af operativsystem (f.eks. Android 13).
    • Loc_country: Telemetrienhedens oprindelse.
    • eventContext: Indeholder følgende egenskaber:
      • CurrentSyncId: Id for en vellykket synkronisering. Nulstil efter hver vellykket synkronisering. (Den nulstilles ikke efter en fejl).
      • CurrentActivityId: Id for godkendt synkronisering. Nulstilles efter hver synkronisering.
      • entityName: Navnet på tabellen i hændelser med datadownload.
      • ProfileId: Id for den offlineprofil, der er konfigureret for appen og brugeren.
      • RecordCount: Antal downloadede poster.
      • ResponseSize: Størrelsen på indgående nyttedata som rapporteret af HTTPClient (komprimeret størrelse).
      • ContentLength: Størrelsen på indgående nyttedata som rapporteret af HTTPClient (komprimeret størrelse).

Hændelser med fejl i Unified Client Interface

  • timestamp [UTC]: Hvornår hændelsen fandt sted.
  • problemId: "uci_trace" eller "uciMonitorFailure" (hvor dataene kom fra).
  • type: "uci_trace" eller "uciMonitorFailure" (hvor dataene kom fra).
  • outType: "uci_trace" eller "uciMonitorFailure" (hvor dataene kom fra).
  • outerMessage: Fejlmeddelelse.
  • itemType: "undtagelse"
  • CustomDimensions:
    • eventContext: Flere detaljer relateret til fejlen.
    • ServerConnectivityState: Er brugeren i offlinetilstand? (Offline/Online)
    • NetworkConnectivityState: Har brugeren internetforbindelse? Bemærk, at en bruger kan være i offlinetilstand, men have internetforbindelse.
    • IsOfflineByDefaultApp: Når den er false, betyder det, at funktionen Arbejd i offlinetilstand er slået til. Når det er true, betyder det, at offline-først er slået til.
    • callStack: Den programmeringskode, hvor fejlen opstod.
    • hostSubType: "PowerApps-Player-iOS-fieldservice"
    • hostType: "MobileApplication"
  • Operation_ID: En strengsammenkædning af sessionID efterfulgt af '_' og eksternt korrelations-id, f.eks. e11e8465-bc8f-4319-b64a-9c1e42453148_0da90a33-ad68-4a4e-bd45-5728d5da719a.
  • Operation_ParentID: Aktivitets-id, der er relateret til fejlen.
  • SessionId: Sessions-id for fejlen.
  • UserId: Dynamics 365-bruger-id.
  • User_authenticatedID: Dynamics 365-bruger-id.
  • Application_version: Appversion, f.eks. 9.2.24045.00212.
  • Client_Type: Version af operativsystem, f.eks. iOS eller Android.

Eksempelscenarier

Fejl ved offlinesynkronisering efter fejlkode

Med denne forespørgsel kan du se, hvilke typer fejl frontlinjemedarbejderne oplever, når en synkronisering mislykkes. Nogle fejl er forventede, f.eks. hvis mobilappen lukkes under synkronisering, eller hvis netværket afbrydes under synkronisering og forhindrer synkroniseringen i at blive fuldført. Definitionen af fejlkoder vises i Fejlkodetilknytningstabellen.

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)

Gennemsnitligt antal synkroniserede poster pr. tabel

Med denne forespørgsel kan du evaluere, hvilke tabeller der bidrager med flest poster til en synkronisering. Ved hjælp af disse data kan du forsøge at optimere din offlineprofil yderligere for at reducere poster eller data i hver tabel.

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

Gennemsnitlig synkroniseringstid pr. synkroniseringstilstand

Denne forespørgsel giver dig mulighed for at evaluere den gennemsnitlige synkroniseringsvarighed for brugere i din organisation.

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

Synkroniseringsoplysninger pr. bruger

Denne forespørgsel giver en visning pr. bruger af synkronisering, herunder dato for seneste synkronisering, seneste fejl, varighed af synkronisering og synkroniserede poster.

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

Brugere efter enhedstype og appversion

Denne forespørgsel indeholder flere oplysninger om brugere i organisationen, der har adgang til mobilprogrammet på deres enhedsmodel.

dependencies
| where name == "Offline.SyncDatabase"
| extend cd = parse_json(customDimensions)
| extend AppVersion = tostring(cd.AppInfo_Version)
| summarize dcount(user_Id) by AppVersion, client_Type

Fejlkodetilknytning

Fejlkode Fejltype Definition
-2146864604 CONFIG_ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2146864606 CONFIG_ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2146864607 CONFIG_ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2146864608 CONFIG_ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2146869250 CONFIG_ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147015328 ACCESS_ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147088248 CONFIG_ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147155198 ERROR Du kan finde fejlkoder, der begynder med -214, under Fejlkoder til webtjeneste.
-2147155198 ACCESS_ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147167669 ACCESS_ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147180269 ACCESS_ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147180284 ACCESS_ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147187375 ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147187388 ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147187389 ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147204270 ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147204339 ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147204784 ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147209463 ACCESS_ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147217124 ERROR Du kan finde fejlkoder, der begynder med -214, under Fejlkoder til webtjeneste.
-2147220884 ERROR Du kan finde fejlkoder, der begynder med -214, under Fejlkoder til webtjeneste.
-2147220955 ACCESS_ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147220956 EXTERNAL_ERROR Du kan finde fejlkoder, der begynder med -214, under Fejlkoder til webtjeneste.
-2147220960 ACCESS_ERROR Fejl i app- eller brugerkonfiguration. Se Fejlkoder til webtjeneste.
-2147220970 ERROR Du kan finde fejlkoder, der begynder med -214, under Fejlkoder til webtjeneste.
-2147220989 ERROR Du kan finde fejlkoder, der begynder med -214, under Fejlkoder til webtjeneste.
-50 ERROR Intern fejl.
0 ERROR Ukendt fejl.
2000 ERROR Ikke-tilknyttet fejl.
2002 ERROR Dataverse SQL-timeout.
2003 DATABASE_ERROR Databasefejl.
2004 NETWORK_ERROR Netværksfejl.
2005 SERVER_ERROR Serverfejl.
2006 AUTH_ERROR Godkendelsesfejl.
2007 DEVICE_ERROR Fejl: Disken er fuld.
2008 ERROR Intern fejl.
2009 AUTH_ERROR Godkendelsesfejl.
2011 CONFIG_ERROR Fejl: Rettigheder til appmodul.
2016 CONFIG_ERROR Offlinekonfigurationsfejl.
2017 CONFIG_ERROR Offlineprofilkonfigurationsfejl.
3000 EXPECTED_ERROR Intern synkroniseringshændelse.
3003 CONFIG_ERROR Offlineprofilkonfigurationsfejl.