Dela via

Telemetrihändelser för synkronisering och åtgärder i mobilappen

  • Artikel

Power Apps mobilprogramdata relaterad till offline-synkroniseringshändelser är tillgängliga för modellbaserade appar och arbetsyteappar. Dessa data kan användas för att utvärdera hälsa och prestanda för offline-synkroniseringshändelser för organisationen.

Dessa data går till tabellen Power Apps>Synkronisering och åtgärder för mobilapp i Application Insights. En post loggas när en användare öppnar en Power Apps mobilapp som är konfigurerad för offlineläge. Mer data, relaterade till felhändelser i modellbaserade appar, finns tillgängliga via Power Apps>UCI.

Definitioner av synkronisering och åtgärder för mobilapp

  • id: Händelse-ID.
  • target: Namnet på scenariot som spårats av händelsen.
  • type: Källtabell för händelsen.
  • name: Namnet på scenariot som spårats av händelsen.
  • duration: Scenariots varaktighet i milisekunder. Varaktighet kan innefatta långa tidsperioder när appen är inaktiv.
  • operation_Id: Unik identifierare för sessionen.
  • operation_ParentId: Unik identifierare för scenariot som spåras av händelsen.
  • user_Id: Microsoft Entra användar-ID.
  • application_Version: Version av appen.
  • customAttribut: Innehåller följande attribut:
    • "EventName": Sammanfattning av scenariot som spåras av händelsen (ScenarioEnd).
    • "ScenarioResult": FRAMGÅNG eller MISSLYCKANDE.
    • ErrorCode: Felkod som genererades vid synkroniseringsfel. Läs mer i Mappningstabell för felkoder.
    • ErrorMessage: Tom när det lyckades eller på en sträng som beskriver felet.
    • FailureType: Definierar typen av synkroniseringsfel.
    • LogLevel: Allvarlighetsgrad eller rapporteringsnivå för händelsen. Giltiga värden är info, error, warning, error eller verbose.
    • DataSyncMode: Vilken typ av offlinesynkronisering användaren har erfarenhet av.
      • DELTA_SYNC: Automatisk inkrementell synkronisering.
      • GRID_SYNC: Utlöses av en uppdatering i en rutnätsvy.
      • FIRST_SYNC: Initial synkronisering på en enhet (eller efter utloggning/omkonfigurering).
      • FORCED_SYNC: Utlöses från knappen på sidan Enhetsstatus.
      • SINGLE_RECORD_SYNC: Utlöses av Push-meddelande.
    • AppFlavor: Inbyggd app installerad på enheten. Giltiga värden är FieldService och PowerApps.
    • AppInfo_Version: Version av den inbyggda appen (se appbutiken).
    • ActiveDuration: Scenariets varaktighet i millisekunder, inkluderar endast tiden då appen är aktiv.
    • DeviceInfo_Id: Unik identifierare för enheten.
    • DeviceInfo_model: Enhetsmodell (till exempel iPhone 13).
    • DeviceInfo_make: Enhetens tillverkare (till exempel Apple).
    • DeviceInfo_OsName: Enhetens operativsystemet (till exempel Android).
    • DeviceInfo_OsVersion: Operativsystemets version (till exempel Android 13).
    • Loc_country: Telemetrienhetens ursprung.
    • eventContext: Innehåller följande egenskaper:
      • CurrentSyncId: ID för en lyckad synkroniseringsomgång. Återställ efter varje lyckad synkronisering. (Den återställs inte efter ett fel.)
      • CurrentActivityId: ID för synkroniseringsomgång. Återställ efter varje synkronisering.
      • entityName: Namnet på tabellen i datahämtningshändelser.
      • ProfileId: ID för offlineprofilen som konfigurerats för appen och användaren.
      • RecordCount: Antal poster som har hämtats.
      • ResponseSize: Storlek på inkommande nyttolastdata enligt HTTPClient (komprimerad storlek).
      • ContentLength: Storlek på inkommande nyttolastdata enligt HTTPClient (komprimerad storlek).

Felhändelser för enhetligt klientgränssnitt

  • timestamp [UTC]: När händelsen inträffade.
  • problemId: "uci_trace" eller "uciMonitorFailure" (där data kom från.)
  • type: "uci_trace" eller "uciMonitorFailure" (där data kom från.)
  • outType: "uci_trace" eller "uciMonitorFailure" (där data kom från.)
  • outerMessage: Felmeddelande.
  • itemType: "exception"
  • CustomDimensions:
    • eventContext: Mer information om felet.
    • ServerConnectivityState: Är användaren i offlineläge? (Offline/Online)
    • NetworkConnectivityState: Har användaren internetanslutning? Observera att en användare kan vara i offlineläge men har en Internetanslutning.
    • IsOfflineByDefaultApp: När falskt innebär det att funktionen Arbeta i offlineläge är på. När det är sant innebär det att offline-först är aktiverat.
    • callStack: Programmeringskoden som felet inträffade på.
    • hostSubType: "PowerApps-Player-iOS-fieldservice"
    • hostType: "MobileApplication"
  • Operation_ID: En strängsammanfogning av sessionID followed by a '_' och externt korrelations-ID, till exempel, e11e8465-bc8f-4319-b64a-9c1e42453148_0da90a33-ad68-4a4e-bd45-5728d5da719a.
  • Operation_ParentID: Aktivitets-ID relaterat till fel.
  • SessionId: Sessions-ID för fel.
  • UserId: Dynamics 365 användar-ID.
  • User_authenticatedID: Dynamics 365 användar-ID.
  • Application_version: App-version, till exempel 9.2.24045.00212.
  • Client_Type: Operativsystemsversion, till exempel iOS eller Android.

Exempelscenarier

Offlinesynkronisering misslyckades av felkod

Med den här frågan kan du se vilka typer av fel som personer i frontlinjen stöter på när en synkronisering misslyckas. Vissa fel undantas, till exempel om mobilappen stängs under synkronisering eller om nätverksanslutningen bryts under synkronisering och förhindrar att synkroniseringen slutförs. Definitionen av felkoder visas i mappningstabellen för felkoder.

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)

Genomsnittligt antal poster som synkroniserats efter tabell

Med den här frågan kan du utvärdera vilka tabeller som bidrar med de flesta poster till en synkronisering. Med hjälp av dessa data kan du försöka optimera offlineprofilen ytterligare och minska antalet poster eller data i varje 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

Genomsnittlig synkroniseringstid efter synkroniseringsläge

Med den här frågan kan du utvärdera den genomsnittliga synkroniseringstiden för användare 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

Synkroniseringsinformation efter användare

Den här frågan ger en vy över synkroniseringen per användare, inklusive senaste synkroniseringsdatum, senaste fel, synkroniseringens varaktighet och synkroniserade 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

Användare efter enhetstyp och appversion

Den här frågan ger mer information om användare i organisationen som använder mobilappen på sin enhetsmodell.

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

Mappning av felkod

Felkod Feltyp Definition
-2146864604 CONFIG_ERROR Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2146864606 CONFIG_ERROR Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2146864607 CONFIG_ERROR Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2146864608 CONFIG_ERROR Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2146869250 CONFIG_ERROR Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147015328 ACCESS_ERROR Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147088248 CONFIG_ERROR Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147155198 FEL Information om felkoder som börjar i –214 finns i Felkoder för webbtjänsten.
-2147155198 ACCESS_ERROR Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147167669 ACCESS_ERROR Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147180269 ACCESS_ERROR Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147180284 ACCESS_ERROR Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147187375 FEL Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147187388 FEL Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147187389 FEL Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147204270 FEL Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147204339 FEL Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147204784 FEL Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147209463 ACCESS_ERROR Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147217124 FEL Information om felkoder som börjar i –214 finns i Felkoder för webbtjänsten.
-2147220884 FEL Information om felkoder som börjar i –214 finns i Felkoder för webbtjänsten.
-2147220955 ACCESS_ERROR Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147220956 EXTERNAL_ERROR Information om felkoder som börjar i –214 finns i Felkoder för webbtjänsten.
-2147220960 ACCESS_ERROR Fel vid app- eller användarkonfiguration. Se Felkoder för webbtjänsten.
-2147220970 FEL Information om felkoder som börjar i –214 finns i Felkoder för webbtjänsten.
-2147220989 FEL Information om felkoder som börjar i –214 finns i Felkoder för webbtjänsten.
-50 FEL Internt fel.
0 FEL Okänt fel.
2000 FEL Omappat fel.
2002 FEL Dataverse SQL tidsgräns.
2003 DATABASE_ERROR Databasfel.
2004 NETWORK_ERROR Nätverksfel.
2005 SERVER_ERROR Serverfel.
2006 AUTH_ERROR Autentiseringsfel.
2007 DEVICE_ERROR Fel: Disken är full.
2008 FEL Internt fel.
2009 AUTH_ERROR Autentiseringsfel.
2011 CONFIG_ERROR Fel: Behörighet för appmodul saknas.
2016 CONFIG_ERROR Offline konfigurationsfel.
2017 CONFIG_ERROR Offline-profil konfigurationsfel.
3000 EXPECTED_ERROR Synkronisera intern händelse.
3003 CONFIG_ERROR Offline-profil konfigurationsfel.