Sdílet prostřednictvím

Události telemetrie pro synchronizaci a akce mobilních aplikací

  • Článek

Data mobilních aplikací Power Apps související s událostmi offline synchronizace jsou k dispozici pro modelem řízené aplikace a aplikace plátna. Tato data lze použít k vyhodnocení stavu a výkonu událostí offline synchronizace pro vaši organizaci.

Tato data přecházejí do tabulky Power Apps>Synchronizace a akce mobilní aplikace v Application Insights. Záznam se zaprotokoluje, když uživatel přistupuje k mobilní aplikaci Power Apps, která je nakonfigurována pro offline režim. Další data týkající se událostí selhání v modelem řízených aplikacích jsou k dispozici prostřednictvím Power Apps>UCI.

Definice událostí synchronizace a akcí mobilní aplikace

  • id: ID události.
  • target: Název scénáře sledovaného událostí.
  • type: Zdrojová tabulka události.
  • name: Název scénáře sledovaného událostí.
  • duration: Doba trvání scénáře v milisekundách. Doba trvání může zahrnovat dlouhá časová období, kdy je aplikace neaktivní.
  • operation_Id: Jedinečný identifikátor relace.
  • operation_ParentId: Jedinečný identifikátor scénáře sledovaného událostí.
  • user_Id: Microsoft Entra ID uživatele.
  • application_Version: Verze aplikace.
  • customDimensions: Obsahuje následující atributy:
    • "EventName": Souhrn scénáře sledovaného událostí (ScenarioEnd).
    • "ScenarioResult": SUCCESS (úspěch) nebo FAILURE (selhání).
    • ErrorCode: Kód chyby vygenerovaný při selhání synchronizace. Další informace najdete v tabulce mapování kódů chyb.
    • ErrorMessage: Prázdné při úspěchu nebo řetězci popisujícím chybu.
    • FailureType: Definuje typ selhání synchronizace.
    • LogLevel: Závažnost nebo úroveň vykazování události. Platné hodnoty jsou info (informace), error (chyba), warning (varování), error (chyba) nebo verbose (popis).
    • DataSyncMode: Typ offline synchronizace uživatele.
      • DELTA_SYNC: Automatická přírůstková synchronizace.
      • GRID_SYNC: Aktivuje se aktualizací v zobrazení mřížky.
      • FIRST_SYNC: Počáteční synchronizace na zařízení (nebo po odhlášení nebo změně konfigurace).
      • FORCED_SYNC: Spouští se z tlačítka stránky Stav zařízení.
      • SINGLE_RECORD_SYNC: Aktivováno nabízenými oznámeními.
    • AppFlavor: Nativní aplikace nainstalovaná na zařízeních. Platné hodnoty jsou FieldService a PowerApps.
    • AppInfo_Version: Verze nativní aplikace, jak je zobrazena v obchodě s aplikacemi.
    • ActiveDuration: Doba trvání scénáře v milisekundách, včetně času, kdy je aplikace aktivní.
    • DeviceInfo_Id: Jedinečný identifikátor zařízení.
    • DeviceInfo_model: Model zařízení (například iPhone 13).
    • DeviceInfo_make: Značka zařízení (například Apple).
    • DeviceInfo_OsName: Operační systém zařízení (například Android).
    • DeviceInfo_OsVersion: Verze operačního systému (například Android 13).
    • Loc_country: Původ telemetrického zařízení.
    • eventContext: Obsahuje následující vlastnosti:
      • CurrentSyncId: ID vstupenky úspěšné synchronizace. Resetuje se po každé úspěšné synchronizaci. (Neresetuje se po chybě.)
      • CurrentActivityId: ID vstupenky synchronizace. Resetuje se po každé synchronizaci.
      • entityName: Název tabulky v událostech stahování dat.
      • ProfileId: ID offline profilu nakonfigurovaného pro aplikaci a uživatele.
      • RecordCount: Počet stažených záznamů.
      • ResponseSize: Velikost dat příchozí datové části, jak vykazuje HTTPClient (komprimovaná velikost).
      • ContentLength: Velikost dat příchozí datové části, jak vykazuje HTTPClient (komprimovaná velikost).

Události selhání sjednoceného klientského rozhraní

  • timestamp [UTC]: Kdy k události došlo.
  • problemId: "uci_trace" nebo "uciMonitorFailure" (odkud pocházejí data).
  • type: "uci_trace" nebo "uciMonitorFailure" (odkud pocházejí data).
  • outType: "uci_trace" nebo "uciMonitorFailure" (odkud pocházejí data).
  • outerMessage: Chybová zpráva.
  • itemType: "výjimka"
  • CustomDimensions:
    • eventContext: Další podrobnosti související s chybou.
    • ServerConnectivityState: Je uživatel v režimu offline? (Offline/Online)
    • NetworkConnectivityState: Má uživatel připojení k internetu? Upozorňujeme, že uživatel může být v režimu offline, ale může mít připojení k internetu.
    • IsOfflineByDefaultApp: Pokud je hodnota false, znamená to, že je zapnuta funkce Práce v režimu offline. Pokud je true, znamená to, že zapnuta funkce Nejprve offline.
    • callStack: Programovací kód, ve kterém došlo k chybě.
    • hostSubType: "PowerApps-Player-iOS-fieldservice"
    • hostType: "MobileApplication"
  • Operation_ID: Zřetězení řetězců sessionID následované znakem „_“ a ID externí korelace, například e11e8465-bc8f-4319-b64a-9c1e424531480da90a33-ad68-4a4e-bd45-5728d5da719a.
  • Operation_ParentID: ID aktivity související s chybou.
  • SessionId: ID relace chyby.
  • UserId: ID uživatele Dynamics 365.
  • User_authenticatedID: ID uživatele Dynamics 365.
  • Application_version: Verze aplikace, například 9.2.24045.00212.
  • Client_Type: Verze operačního systému, například iOS nebo Android.

Ukázkové scénáře

Selhání offline synchronizace podle kódu chyby

Tento dotaz vám umožní zjistit, s jakými typy selhání se pracovníci v první linii setkávají, když se synchronizace nezdaří. Některá selhání jsou vyloučena, například pokud je mobilní aplikace během synchronizace zavřená nebo pokud se síť během synchronizace odpojí a zabrání dokončení synchronizace. Definice kódů selhání je uvedena v tabulce mapování chybových kódů.

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)

Průměrné záznamy synchronizované podle tabulky

Tento dotaz umožňuje vyhodnotit, které tabulky přispívají k synchronizaci nejvíce záznamy. Pomocí těchto dat se můžete pokusit dále optimalizovat svůj offline profil, abyste snížili počet záznamů nebo množství dat v každé tabulce.

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

Průměrná doba synchronizace podle režimu synchronizace

Tento dotaz umožňuje vyhodnotit průměrnou dobu trvání synchronizace pro uživatele ve vaší organizaci.

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

Podrobnosti o synchronizaci podle uživatele

Tento dotaz poskytuje pohled na synchronizaci podle jednotlivých uživatelů, včetně data poslední synchronizace, poslední chyby, doby trvání synchronizace a synchronizovaných záznamů.

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

Uživatelé podle typu zařízení a verze aplikace

Tento dotaz poskytuje další informace o uživatelích ve vaší organizaci, kteří přistupují k mobilní aplikaci na svém modelu zařízení.

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

Mapování kódu chyby

Kód chyby Typ selhání definice
-2146864604 CONFIG_ERROR Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2146864606 CONFIG_ERROR Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2146864607 CONFIG_ERROR Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2146864608 CONFIG_ERROR Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2146869250 CONFIG_ERROR Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147015328 ACCESS_ERROR Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147088248 CONFIG_ERROR Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147155198 CHYBA Kódy chyb začínající na –214 naleznete v tématu Kódy chyb webových služeb.
-2147155198 ACCESS_ERROR Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147167669 ACCESS_ERROR Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147180269 ACCESS_ERROR Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147180284 ACCESS_ERROR Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147187375 CHYBA Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147187388 CHYBA Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147187389 CHYBA Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147204270 CHYBA Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147204339 CHYBA Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147204784 CHYBA Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147209463 ACCESS_ERROR Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147217124 CHYBA Kódy chyb začínající na –214 naleznete v tématu Kódy chyb webových služeb.
-2147220884 CHYBA Kódy chyb začínající na –214 naleznete v tématu Kódy chyb webových služeb.
-2147220955 ACCESS_ERROR Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147220956 EXTERNAL_ERROR Kódy chyb začínající na –214 naleznete v tématu Kódy chyb webových služeb.
-2147220960 ACCESS_ERROR Chyba konfigurace aplikace nebo uživatele. Viz Kódy chyb webových služeb.
-2147220970 CHYBA Kódy chyb začínající na –214 naleznete v tématu Kódy chyb webových služeb.
-2147220989 CHYBA Kódy chyb začínající na –214 naleznete v tématu Kódy chyb webových služeb.
-50 CHYBA Vnitřní chyba
0 CHYBA Neznámá chyba.
2000 CHYBA Nemapovaná chyba.
2002 CHYBA Časový limit pro Dataverse SQL.
2003 DATABASE_ERROR Chyba databáze.
2004 NETWORK_ERROR Chyba sítě.
2005 SERVER_ERROR Chyba serveru.
2006 AUTH_ERROR Chyba ověření.
2007 DEVICE_ERROR Chyba Disk je plný.
2008 CHYBA Vnitřní chyba
2009 AUTH_ERROR Chyba ověření.
2011 CONFIG_ERROR Chyba oprávnění modulu aplikace.
2016 CONFIG_ERROR Chyba konfigurace režimu offline.
2017 CONFIG_ERROR Chyba konfigurace profilu offline.
3000 EXPECTED_ERROR Synchronizace interní události.
3003 CONFIG_ERROR Chyba konfigurace profilu offline.