行動裝置應用程式同步處理和動作的遙測事件

發行項
11/13/2024

與離線同步事件相關的 Power Apps 行動應用程式資料可用於模型導向和畫布應用程式。此資料可用於評估您的組織的離線同步事件的運作狀況和效能。

此資料將進入 Application Insights 中的 Power Apps>行動應用程式同步和動作表。當使用者存取設定為離線模式的 Power Apps 行動應用程式時，會記錄一個條目。可透過 Power Apps>UCI 取得與模型導向應用程式中失敗事件相關的更多資料。

行動應用程式同步和操作事件定義

識別碼：事件識別碼。
目標：事件追蹤的情境的名稱。
類型：事件的來源資料表。
名稱：事件追蹤的情境的名稱。
期間：情境期間 (以毫秒為單位)。持續時間可能包括應用程式處於非使用狀態的較長時間段。
operation_Id：工作階段的唯一識別碼。
operation_ParentId：事件追蹤情境的唯一識別碼。
user_Id：Microsoft Entra 使用者識別碼。
application_Version：應用程式的版本。
customDimensions：包含以下屬性：
- 「EventName」：事件追蹤的情境摘要 (ScenarioEnd)。
- 「ScenarioResult」：成功或失敗。
- ErrorCode：同步失敗時生成的錯誤碼。有關詳細資訊，請參閱錯誤碼對應表。
- ErrorMessage：成功時為空，或包含描述錯誤的字串。
- FailureType：定義同步失敗的類型。
- LogLevel：事件的嚴重性或報告等級。有效值為資訊、錯誤、警告、錯誤或詳細。
- DataSyncMode：使用者經歷過什麼類型的離線同步。
  - DELTA_SYNC：自動增量同步。
  - GRID_SYNC：由格線檢視上的重新整理觸發。
  - FIRST_SYNC：在裝置上進行初始同步 (或登出/重新設定後)。
  - FORCED_SYNC：從「裝置狀態」頁面按鈕觸發。
  - SINGLE_RECORD_SYNC: 由推播通知觸發。
- AppFlavor：安裝在裝置上的原生應用程式。有效值為「FieldService」與「PowerApps」。
- AppInfo_Version：原生應用程式的版本，如應用程式商店中所示。
- ActiveDuration：情境持續時間 (以毫秒為單位)，僅包括應用程式處於活動狀態的時間。
- DeviceInfo_Id：裝置的唯一識別碼。
- DeviceInfo_model：裝置型號 (例如 iPhone 13)。
- DeviceInfo_make：裝置品牌 (例如 Apple)。
- DeviceInfo_OsName：裝置作業系統 (如 Android)。
- DeviceInfo_OsVersion：作業系統版本 (例如 Android 13)。
- Loc_country：遙測裝置的原點。
- eventContext：包含下列屬性：
  - CurrentSyncId：成功同步的識別碼。每次成功同步後重設。(發生錯誤後不會重設。)
  - CurrentActivityId：同步傳遞的識別碼。每次同步後重設。
  - entityName：資料下載事件中資料表的名稱。
  - ProfileId：為應用程式和使用者設定的離線設定檔的識別碼。
  - RecordCount：下載的記錄數。
  - ResponseSize：HTTPClient 報告的傳入負載資料大小 (壓縮大小)。
  - ContentLength：HTTPClient 報告的傳入負載資料大小 (壓縮大小)。

統一用戶端介面失敗事件

時間戳記 [UTC]：事件發生的時間。
problemId：「uci_trace」或「uciMonitorFailure」(資料的來源)。
類型：「uci_trace」或「uciMonitorFailure」(資料的來源)。
outType：「uci_trace」或「uciMonitorFailure」(資料的來源)。
outerMessage：錯誤訊息。
itemType：「例外狀況」
CustomDimensions：
- eventContext：與錯誤相關的更多詳細資訊。
- ServerConnectivityState：使用者是否處於離線模式？ (離線/線上)
- NetworkConnectivityState：使用者是否有網際網路連線？請注意，使用者可以處於離線模式，但仍有網路連線。
- IsOfflineByDefaultApp：如果為 False，則表示離線作業模式功能已開啟。如果為 True，則表示離線優先已開啟。
- callStack：發生錯誤的程式設計代碼。
- hostSubType："PowerApps-Player-iOS-fieldservice"
- hostType：「MobileApplication」
Operation_ID：sessionID 後面跟著「_」和外部相互關聯識別碼的字串串連，例如 e11e8465-bc8f-4319-b64a-9c1e42453148_0da90a33-ad68-4a4e-bd45-5728d5da719a。
Operation_ParentID：與錯誤相關的活動識別碼。
SessionId：錯誤的工作階段識別碼。
UserId：Dynamics 365 使用者識別碼。
User_authenticatedID：Dynamics 365 使用者識別碼。
Application_version：應用程式版本，例如 9.2.24045.00212。
Client_Type：作業系統版本，例如 iOS 或 Android。

範例案例

離線同步失敗 (錯誤碼)

透過此查詢，您可以查看同步失敗時第一線工作人員遇到的錯誤類型。某些故障除外，例如行動應用程式在同步時關閉，或網路在同步時中斷連線並阻止同步完成。失敗代碼的定義如錯誤碼對應表所示。

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)

按表同步的平均記錄數

此查詢可讓您評估哪些資料表為同步貢獻了最多記錄。使用此資料，您可以嘗試進一步最佳化離線設定檔，以減少每個資料表中的記錄或資料。

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

按同步模式劃分的平均同步持續時間

此查詢允許您評估組織中使用者的平均同步持續時間。

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

按照使用者同步詳細資料

此查詢提供每個使用者的同步檢視，包括上次同步日期、上次錯誤、同步持續時間和同步記錄。

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

按裝置類型和應用程式版本劃分使用者

此查詢提供有關組織中在其裝置型號上存取行動應用程式的使用者的更多資訊。

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

錯誤碼對應

錯誤碼	失敗類型	定義
-2146864604	CONFIG_ERROR	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2146864606	CONFIG_ERROR	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2146864607	CONFIG_ERROR	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2146864608	CONFIG_ERROR	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2146869250	CONFIG_ERROR	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147015328	ACCESS_ERROR	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147088248	CONFIG_ERROR	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147155198	錯誤	有關以–214 開頭的錯誤代碼，請參閱 Web 服務錯誤代碼。
-2147155198	ACCESS_ERROR	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147167669	ACCESS_ERROR	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147180269	ACCESS_ERROR	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147180284	ACCESS_ERROR	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147187375	錯誤	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147187388	錯誤	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147187389	錯誤	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147204270	錯誤	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147204339	錯誤	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147204784	錯誤	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147209463	ACCESS_ERROR	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147217124	錯誤	有關以–214 開頭的錯誤代碼，請參閱 Web 服務錯誤代碼。
-2147220884	錯誤	有關以–214 開頭的錯誤代碼，請參閱 Web 服務錯誤代碼。
-2147220955	ACCESS_ERROR	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147220956	EXTERNAL_ERROR	有關以–214 開頭的錯誤代碼，請參閱 Web 服務錯誤代碼。
-2147220960	ACCESS_ERROR	應用或使用者配置錯誤。請參閱 Web 服務錯誤碼。
-2147220970	錯誤	有關以–214 開頭的錯誤代碼，請參閱 Web 服務錯誤代碼。
-2147220989	錯誤	有關以–214 開頭的錯誤代碼，請參閱 Web 服務錯誤代碼。
-50	錯誤	內部錯誤。
12	錯誤	未知的錯誤。
2000	錯誤	未對應的錯誤。
2002	錯誤	Dataverse SQL 逾時。
2003	DATABASE_ERROR	資料庫錯誤。
2004	NETWORK_ERROR	網路錯誤。
2005	SERVER_ERROR	伺服器錯誤。
2006	AUTH_ERROR	驗證錯誤。
2007	DEVICE_ERROR	磁碟已滿錯誤。
2008	錯誤	內部錯誤。
2009	AUTH_ERROR	驗證錯誤。
2011	CONFIG_ERROR	應用程式模組權限錯誤。
2016	CONFIG_ERROR	離線設定錯誤。
2017	CONFIG_ERROR	離線設定檔配置錯誤。
3000	EXPECTED_ERROR	同步內部事件。
3003	CONFIG_ERROR	離線設定檔配置錯誤。

共用方式為