שתף דרך


אירועי מדידת שימוש עבור סנכרון ופעולות של אפליקציות למכשירים ניידים

נתוני אפליקציה למכשירים ניידים של Power Apps הקשורים לאירועי סינכרון לא מקוון זמינים עבור יישומים מונחי-דגמים ויישומי בד ציור. ניתן להשתמש בנתונים אלה כדי להעריך את התקינות והביצועים של אירועי סנכרון לא מקוון עבור הארגון שלך.

נתונים אלה נכנסים לטבלה Power Apps>סינכרון ופעולות של אפליקציות למכשירים ניידים ב-Application Insights. רשומה נרשמת כאשר משתמש ניגש לאפליקציית Power Apps למכשירים ניידים, שתצורתה נקבעה למצב לא מקוון. נתונים נוספים, הקשורים לאירועי כשל ביישומים מונחי-דגמים, זמינים באמצעות Power Apps>UCI.

לקבלת דוגמאות נוספות לשאילתות ולוח מחוונים לדוגמה, יש לבקר בדף לוח מחוונים לדוגמה של מדידת שימוש עבור אפליקציית Field Service למכשירים ניידים שימוש בפרופיל לא מקוון.

סינכרון יישומים למכשירים ניידים הגדרות לאירועי פעולה

  • מזהה: מזהה אירוע.
  • יעד: שם התרחיש שהאירוע עוקב אחריו.
  • סוג: טבלת המקור של האירוע.
  • שם: שם התרחיש שהאירוע עוקב אחריו.
  • משך: משך התרחיש באלפיות שנייה. משך הזמן עשוי לכלול פרקי זמן ארוכים שבהם האפליקציה אינה פעילה.
  • operation_Id: מזהה ייחודי של ההפעלה.
  • operation_ParentId: מזהה ייחודי עבור התרחיש שהאירוע עוקב אחריו.
  • user_Id: מזהה משתמש Microsoft Entra.
  • application_Version: גירסת האפליקציה.
  • customDimensions: מכיל את התכונות הבאות:
    • "EventName": סיכום התרחיש שהאירוע עוקב אחריו (ScenarioEnd).
    • "ScenarioResult": הצלחה או כישלון.
    • קוד שגיאה: קוד שגיאה שנוצר בעת כשל בסינכרון. קבל מידע נוסף בטבלת המיפוי של קודי שגיאות.
    • 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" (מהיכן הגיעו הנתונים.)
  • type: "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 שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2146864606 CONFIG_ERROR שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2146864607 CONFIG_ERROR שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2146864608 CONFIG_ERROR שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2146869250 CONFIG_ERROR שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2147015328 ACCESS_ERROR שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2147088248 CONFIG_ERROR שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2147155198 שגיאה עבור קודי שגיאה המתחילים ב-‎–214, ראה קודי שגיאה של שירות אינטרנט.
‎-2147155198 ACCESS_ERROR שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2147167669 ACCESS_ERROR שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2147180269 ACCESS_ERROR שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2147180284 ACCESS_ERROR שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2147187375 שגיאה שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2147187388 שגיאה שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2147187389 שגיאה שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2147204270 שגיאה שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2147204339 שגיאה שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2147204784 שגיאה שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2147209463 ACCESS_ERROR שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
-2147217124 שגיאה עבור קודי שגיאה המתחילים ב-‎–214, ראה קודי שגיאה של שירות אינטרנט.
‎-2147220884 שגיאה עבור קודי שגיאה המתחילים ב-‎–214, ראה קודי שגיאה של שירות אינטרנט.
‎-2147220955 ACCESS_ERROR שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2147220956 EXTERNAL_ERROR עבור קודי שגיאה המתחילים ב-‎–214, ראה קודי שגיאה של שירות אינטרנט.
‎-2147220960 ACCESS_ERROR שגיאת תצורה של אפליקציה או משתמש. ראה קודי שגיאה של שירות האינטרנט.
‎-2147220970 שגיאה עבור קודי שגיאה המתחילים ב-‎–214, ראה קודי שגיאה של שירות אינטרנט.
‎-2147220989 שגיאה עבור קודי שגיאה המתחילים ב-‎–214, ראה קודי שגיאה של שירות אינטרנט.
‎-50 שגיאה ‏‏שגיאה פנימית.
0 שגיאה שגיאה לא ידועה.
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 שגיאת תצורה של פרופיל לא מקוון.