Incidències de telemetria per a la sincronització i les accions de l'aplicació mòbil

Power Apps Les dades d'aplicacions mòbils relacionades amb esdeveniments de sincronització fora de línia estan disponibles per a aplicacions basades en models i llenç. Aquestes dades es poden utilitzar per avaluar l'estat i el rendiment dels esdeveniments de sincronització fora de línia per a la vostra organització.

Aquestes dades van a la Power Apps>taula de sincronització i accions de l'aplicació mòbil a Application Insights. Es registra una entrada quan un usuari accedeix a una Power Apps aplicació mòbil, que està configurada per al mode fora de línia. Hi ha més dades, relacionades amb esdeveniments de fallada en aplicacions basades en models, disponibles a través de l'UCI Power Apps>.

Per obtenir exemples de consulta addicionals i un escriptori digital d'exemple, visiteu Escriptori digital de telemetria d'exemple per a l'ús del perfil fora de línia de l'aplicació mòbil del Field Service.

Sincronització d'aplicacions mòbils i definicions d'esdeveniments d'acció

id: ID d'esdeveniment.
target: nom de l'escenari del qual fa el seguiment l'esdeveniment.
type: Taula d'origen de l'esdeveniment.
name: nom de l'escenari del qual fa el seguiment l'esdeveniment.
durada: durada de l'escenari en mil·lisegons. La durada pot incloure llargs períodes de temps en què l'aplicació està inactiva.
operation_Id: identificador únic de la sessió.
operation_ParentId: identificador únic de l'escenari seguit per l'esdeveniment.
user_Id: Microsoft Entra ID d'usuari.
application_Version: Versió de l'aplicació.
customDimensions: conté els atributs següents:
- "EventName": resum de l'escenari seguit per l'esdeveniment (ScenarioEnd).
- "ScenarioResult": ÈXIT o FRACÀS.
- Codi d'error: codi d'error generat en cas d'error de sincronització. Obteniu més informació a Taula d'assignació de codis d'error.
- ErrorMessage: buit en cas d'èxit o cadena que descriu l'error.
- FailureType: defineix el tipus d'error de sincronització.
- LogLevel: la gravetat o el nivell d'informe de l'esdeveniment. Els valors vàlids són info, error, warning, error o verbose.
- DataSyncMode: quin tipus de sincronització fora de línia ha experimentat l'usuari.
  - DELTA_SYNC: Sincronització incremental automàtica.
  - GRID_SYNC: S'activa per una actualització en una visualització de quadrícula.
  - FIRST_SYNC: Sincronització inicial en un dispositiu (o després d'una tanca de sessió/reconfiguració).
  - FORCED_SYNC: S'activa des del botó de la pàgina Estat del dispositiu.
  - SINGLE_RECORD_SYNC: S'activa mitjançant una notificació push.
- AppFlavor: aplicació nativa instal·lada als dispositius. Els valors vàlids són FieldService i PowerApps.
- AppInfo_Version: Versió de l'aplicació nativa, tal com es veu a la botiga d'aplicacions.
- ActiveDuration: durada de l'escenari en mil·lisegons, incloent-hi només el temps mentre l'aplicació està activa.
- DeviceInfo_Id: identificador únic del dispositiu.
- DeviceInfo_model: model de dispositiu (com ara l'iPhone 13).
- DeviceInfo_make: marca del dispositiu (com ara Apple).
- DeviceInfo_OsName: Sistema operatiu del dispositiu (com ara Android).
- DeviceInfo_OsVersion: Versió del sistema operatiu (com ara Android 13).
- Loc_country: Origen del dispositiu de telemetria.
- eventContext: conté les propietats següents:
  - CurrentSyncId: ID d'una passada de sincronització correcta. Restableix després de cada sincronització correcta. (No es restableix després d'un error.)
  - CurrentActivityId: ID del passi de sincronització. Restableix després de cada sincronització.
  - entityName: Nom de la taula en esdeveniments de baixada de dades.
  - ProfileId: identificador del perfil fora de línia configurat per a l'aplicació i l'usuari.
  - RecordCount: nombre de registres descarregats.
  - ResponseSize: mida de les dades de càrrega entrant tal com informa HTTPClient (mida comprimida).
  - ContentLength: mida de les dades de càrrega entrant tal com informa HTTPClient (mida comprimida).

Esdeveniments d'error de la interfície de client unificada

marca de temps [UTC]: Quan va passar l'esdeveniment.
problemId: "uci_trace" o "uciMonitorFailure" (d'on provenen les dades.)
type: "uci_trace" o "uciMonitorFailure" (d'on provenen les dades).
outType: "uci_trace" o "uciMonitorFailure" (d'on provenen les dades).
outerMessage: missatge d'error.
itemType: "excepció"
Dimensions personalitzades:
- eventContext: més detalls relacionats amb l'error.
- ServerConnectivityState: l'usuari està en mode fora de línia? (Fora de línia/en línia)
- NetworkConnectivityState: L'usuari té connexió a Internet? Tingueu en compte que un usuari pot estar en mode fora de línia, però tenir una connexió a Internet.
- IsOfflineByDefaultApp: quan és fals, vol dir que la funció Treballa en mode fora de línia està activada. Quan és cert, vol dir que Offline-first està activat.
- callStack: el codi de programació on s'ha produït l'error.
- hostSubType: "PowerApps-Jugador-iOS-fieldservice"
- hostType: "Aplicació mòbil"
Operation_ID: Una concatenació de cadena de sessionID seguida d'un '_' i un ID de correlació externa, per exemple, e11e8465-bc8f-4319-b64a-9c1e42453148_0da90a33-ad68-4a4e-bd45-5728d5da719a.
Operation_ParentID: identificador d'activitat relacionat amb l'error.
SessionId: ID de sessió d'error.
ID d'usuari: ID d'usuari del Dynamics 365.
User_authenticatedID: ID d'usuari del Dynamics 365.
Application_version: Versió de l'aplicació, per exemple, 9.2.24045.00212.
Client_Type: Versió del sistema operatiu, com ara iOS o Android.

Situacions d'exemple

Errors de sincronització fora de línia per codi d'error

Aquesta consulta us permet veure quins tipus d'errors troben els treballadors de primera línia quan falla una sincronització. S'exceptuen alguns errors, com ara si l'aplicació mòbil es tanca durant la sincronització o si la xarxa es desconnecta durant la sincronització i impedeix que es completi la sincronització. La definició dels codis d'error es mostra a la taula Assignació de codis d'error.

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)

Mitjana de registres sincronitzats per taula

Aquesta consulta us permet avaluar quines taules contribueixen amb més registres a una sincronització. Amb aquestes dades podeu intentar optimitzar encara més el vostre perfil fora de línia per reduir els registres o les dades de cada taula ....

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

Durada mitjana de la sincronització per mode de sincronització

Aquesta consulta us permet avaluar la durada mitjana de la sincronització per als usuaris de la vostra organització.

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

Sincronitza els detalls per usuari

Aquesta consulta proporciona una vista per usuari de la sincronització, incloent-hi la data de l'última sincronització, l'últim error, la durada de la sincronització i els registres sincronitzats.

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

Usuaris per tipus de dispositiu i versió de l'aplicació

Aquesta consulta proporciona més informació sobre els usuaris de la vostra organització que accedeixen a l'aplicació mòbil al seu model de dispositiu.

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

Mapatge de codis d'error

Codi d'error	Tipus d'error	Definició
-2146864604	CONFIG_ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2146864606	CONFIG_ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2146864607	CONFIG_ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2146864608	CONFIG_ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2146869250	CONFIG_ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147015328	ACCÉS_ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147088248	CONFIG_ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147155198	ERROR	Per als codis d'error que comencen per –214, consulteu Codis d'error del servei web.
-2147155198	ACCÉS_ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147167669	ACCÉS_ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147180269	ACCÉS_ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147180284	ACCÉS_ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147187375	ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147187388	ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147187389	ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147204270	ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147204339	ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147204784	ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147209463	ACCÉS_ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147217124	ERROR	Per als codis d'error que comencen per –214, consulteu Codis d'error del servei web.
-2147220884	ERROR	Per als codis d'error que comencen per –214, consulteu Codis d'error del servei web.
-2147220955	ACCÉS_ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147220956	ERROR_EXTERN	Per als codis d'error que comencen per –214, consulteu Codis d'error del servei web.
-2147220960	ACCÉS_ERROR	Error de configuració de l'aplicació o de l'usuari. Vegeu els codis d'error del servei web.
-2147220970	ERROR	Per als codis d'error que comencen per –214, consulteu Codis d'error del servei web.
-2147220989	ERROR	Per als codis d'error que comencen per –214, consulteu Codis d'error del servei web.
-50	ERROR	Error intern.
0	ERROR	Error desconegut.
2000	ERROR	Error no assignat.
2002	ERROR	Dataverse Temps d'espera SQL.
2003	ERROR_BASE_DADES	Error de base de dades.
2004	ERROR_XARXA	Error de xarxa.
2005	SERVER_ERROR	Error del servidor.
2006	AUTH_ERROR	Error d'autenticació.
2007	ERROR_DISPOSITIU	Error de disc ple.
2008	ERROR	Error intern.
2009	AUTH_ERROR	Error d'autenticació.
2011	CONFIG_ERROR	Error de privilegis del mòdul d'aplicació.
2016	CONFIG_ERROR	Error de configuració fora de línia.
2017	CONFIG_ERROR	Error de configuració del perfil fora de línia.
3000	ERROR_ESPERAT	Sincronitza l'esdeveniment intern.
3003	CONFIG_ERROR	Error de configuració del perfil fora de línia.

Comentaris

Us ha resultat útil aquesta pàgina?

Last updated on 2025-07-09