Aracılığıyla paylaş


Mobil uygulama eşitlemesi ve eylemleri için telemetri olayları

Çevrimdışı senkronizasyon olaylarıyla ilgili Power Apps mobil uygulama verileri model odaklı ve tuval uygulamaları için kullanılabilir. Bu veriler, kuruluşunuz için çevrimdışı eşitleme olaylarının durumunu ve performansını değerlendirmek için kullanılabilir.

Bu veriler, Application Insights içindeki Power Apps>Mobil uygulama eşitleme ve eylemler tablosuna gider. Bir kullanıcı, çevrimdışı mod için yapılandırılmış bir Power Apps mobil uygulamaya eriştiğinde bir giriş günlüğe kaydedilir. Model temelli uygulamalardaki hata olaylarıyla ilgili daha fazla veri, Power Apps>UCI aracılığıyla kullanılabilir.

Ek sorgu örnekleri ve örnek bir pano için bkz. Field Service mobil uygulaması çevrimdışı profil kullanımı için örnek telemetri panosu.

Mobil uygulama eşitlemesi ve eylemleri olay tanımları

  • kimlik: Olay Kimliği.
  • hedef: Olay tarafından izlenen senaryonun adı.
  • tür: Olayın kaynak tablosu.
  • ad: Olay tarafından izlenen senaryonun adı.
  • süre: Milisaniye cinsinden senaryo süresi. Süre, uygulamanın etkin olmadığı uzun süreleri içerebilir.
  • operation_Id: Oturum için benzersiz tanımlayıcı.
  • operation_ParentId: Olay tarafından izlenen senaryonun benzersiz tanımlayıcısı.
  • user_Id: Microsoft Entra kullanıcı kimliği.
  • application_Version: Uygulama sürümü.
  • customDimensions : Aşağıdaki öznitelikleri içerir:
    • "EventName": Olayın izlediği senaryonun özeti (ScenarioEnd).
    • "ScenarioResult": BAŞARILI veya BAŞARISIZ.
    • ErrorCode: Eşitleme hatası üzerine oluşturulan hata kodu. Hata kodu eşleme tablosunda daha fazla bilgi edinin.
    • ErrorMessage: Başarılı olduğunda veya hatayı açıklayan dizede boş.
    • FailureType: Eşitleme hatasının türünü tanımlar.
    • LogLevel: Olayın önem derecesi veya raporlama düzeyi. Geçerli değerler: bilgi, hata, uyarı, hata veya ayrıntılı.
    • DataSyncMode: Kullanıcının deneyimlediği çevrimdışı eşitleme türü.
      • DELTA_SYNC: Otomatik artımlı senkronizasyon.
      • GRID_SYNC: Izgara görünümünde bir yenileme ile tetiklenir.
      • FIRST_SYNC: Bir cihazda ilk senkronizasyon (veya oturum kapatma/yeniden yapılandırmadan sonra).
      • FORCED_SYNC: Cihaz Durumu sayfası düğmesinden tetiklenir.
      • SINGLE_RECORD_SYNC: Anında iletme bildirimi tarafından tetiklendi.
    • AppFlavor: Cihazlarda yüklü yerel uygulama. Geçerli değerler FieldService ve PowerApps.
    • AppInfo_Version: Yerel uygulamanın uygulama mağazasında görüldüğü şekliyle sürümü.
    • ActiveDuration: Yalnızca uygulamanın etkin olduğu süre dahil olmak üzere milisaniye cinsinden senaryo süresi.
    • DeviceInfo_Id: Cihazın benzersiz kimlik belirleyicisi.
    • DeviceInfo_model: Cihaz modeli (ör. iPhone 13).
    • DeviceInfo_make: Cihaz markası (Apple gibi).
    • DeviceInfo_OsName: Cihaz işletim sistemi (Android gibi).
    • DeviceInfo_OsVersion: İşletim sistemi sürümü (Android 13 gibi).
    • Loc_country: Telemetri cihazı kaynağı.
    • eventContext: Aşağıdaki özellikleri içerir:
      • CurrentSyncId: Başarılı bir eşitleme geçişinin kimliği. Her başarılı senkronizasyondan sonra sıfırlayın. (Bir hatadan sonra sıfırlanmaz.)
      • CurrentActivityId: Eşitleme geçişinin kimliği. Her senkronizasyondan sonra sıfırlayın.
      • entityName: Veri indirme olaylarındaki tablonun adı.
      • ProfileId: Uygulama ve kullanıcı için yapılandırılan çevrimdışı profilin kimliği.
      • RecordCount: İndirilen kayıtların sayısı.
      • ResponseSize: HTTPClient tarafından bildirilen gelen yük veri boyutu (sıkıştırılmış boyut).
      • ContentLength: HTTPClient tarafından bildirilen gelen yük veri boyutu (sıkıştırılmış boyut).

Birleşik İstemci Arabirimi hata olayları

  • zaman damgası [UTC]: Olayın gerçekleştiği zaman.
  • problemId: "uci_trace" veya "uciMonitorFailure" (Verilerin geldiği yer.)
  • tür: "uci_trace" veya "uciMonitorFailure" (Verilerin geldiği yer.)
  • outType: "uci_trace" veya "uciMonitorFailure" (Verilerin geldiği yer.)
  • outerMessage: Hata iletisi.
  • itemType: "özel durum"
  • CustomDimensions:
    • eventContext: Hatayla ilgili daha fazla ayrıntı.
    • ServerConnectivityState: Kullanıcı çevrimdışı modda mı? (Çevrimdışı/Çevrimiçi)
    • NetworkConnectivityState: Kullanıcının internet bağlantısı var mı? Bir kullanıcının çevrimdışı modda olabileceğini, ancak internet bağlantısına sahip olabileceğini unutmayın.
    • IsOfflineByDefaultApp: false olduğunda, Çevrimdışı modda çalış özelliğinin açık olduğu anlamına gelir. Doğru olduğunda, çevrimdışı önceliğin açık olduğu anlamına gelir.
    • callStack: Hatanın oluştuğu programlama kodu.
    • hostSubType: "PowerApps-Player-iOS-fieldservice"
    • hostType: "MobileApplication"
  • Operation_ID: sessionID'nin bir dize bitiştirmesi ve ardından bir '_' ve Dış bağıntı kimliği, örneğin, e11e8465-bc8f-4319-b64a-9c1e42453148_0da90a33-ad68-4a4e-bd45-5728d5da719a.
  • Operation_ParentID: Hatayla ilgili etkinlik kimliği.
  • SessionId: Hatanın oturum kimliği.
  • UserId: Dynamics 365 kullanıcı kimliği.
  • User_authenticatedID: Dynamics 365 kullanıcı kimliği.
  • Application_version: Uygulama sürümü, örneğin, 9.2.24045.00212.
  • Client_Type: İşletim sistemi sürümü, örneğin iOS veya Android.

Örnek senaryolar

Hata koduna göre çevrimdışı eşitleme hataları

Bu sorgu, bir eşitleme başarısız olduğunda ön saf çalışanlarının ne tür hatalarla karşılaştığını görmenizi sağlar. Eşitleme sırasında mobil uygulamanın kapatılması veya eşitleme sırasında ağ bağlantısının kesilmesi ve eşitlemenin tamamlanmasını engellemesi gibi bazı hatalar istisnadır. Hata kodlarının tanımı, Hata kodu eşleme tablosunda gösterilir.

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)

Tabloya göre eşitlenen ortalama kayıtlar

Bu sorgu, hangi tabloların bir eşitlemeye en çok kayıtla katkıda bulunduğunu değerlendirmenize olanak tanır. Bu verileri kullanarak, her tablodaki kayıtları veya verileri azaltmak için çevrimdışı profilinizi daha da iyileştirmeyi deneyebilirsiniz.

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

Senkronizasyon moduna göre ortalama senkronizasyon süresi

Bu sorgu, kuruluşunuzdaki kullanıcılar için ortalama eşitleme süresini değerlendirmenize olanak tanır.

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

Kullanıcının eşitleme ayrıntıları

Bu sorgu, son eşitleme tarihi, son hata, eşitleme süresi ve eşitlenen kayıtlar dahil olmak üzere eşitlemenin kullanıcı başına görünümünü sağlar.

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

Cihaz türüne ve uygulama sürümüne göre kullanıcılar

Bu sorgu, kuruluşunuzda mobil uygulamaya cihaz modellerinden erişen kullanıcılar hakkında daha fazla bilgi sağlar.

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

Hata kodu eşleştirmesi

Hata kodu Hata türü Açıklama
-2146864604 CONFIG_ERROR Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2146864606 CONFIG_ERROR Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2146864607 CONFIG_ERROR Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2146864608 CONFIG_ERROR Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2146869250 CONFIG_ERROR Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147015328 ACCESS_ERROR Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147088248 CONFIG_ERROR Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147155198 HATA –214 ile başlayan hata kodları için bkz. Web hizmeti hata kodları.
-2147155198 ACCESS_ERROR Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147167669 ACCESS_ERROR Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147180269 ACCESS_ERROR Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147180284 ACCESS_ERROR Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147187375 HATA Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147187388 HATA Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147187389 HATA Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147204270 HATA Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147204339 HATA Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147204784 HATA Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147209463 ACCESS_ERROR Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147217124 HATA –214 ile başlayan hata kodları için bkz. Web hizmeti hata kodları.
-2147220884 HATA –214 ile başlayan hata kodları için bkz. Web hizmeti hata kodları.
-2147220955 ACCESS_ERROR Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147220956 EXTERNAL_ERROR –214 ile başlayan hata kodları için bkz. Web hizmeti hata kodları.
-2147220960 ACCESS_ERROR Uygulama veya kullanıcı yapılandırma hatası. Bkz. Web hizmeti hata kodları.
-2147220970 HATA –214 ile başlayan hata kodları için bkz. Web hizmeti hata kodları.
-2147220989 HATA –214 ile başlayan hata kodları için bkz. Web hizmeti hata kodları.
-50 HATA İç hata.
0 HATA Bilinmeyen hata.
Kategori 2000 HATA Eşlenmemiş hata.
Kategori 2002 HATA Dataverse SQL zaman aşımı.
Kategori 2003 DATABASE_ERROR Veritabanı hatası.
Kategori 2004 NETWORK_ERROR Ağ hatası.
Kategori 2005 SERVER_ERROR Sunucu hatası.
Kategori 2006 AUTH_ERROR Kimlik doğrulama hatası.
Kategori 2007 DEVICE_ERROR Disk dolu hatası.
Kategori 2008 HATA İç hata.
Kategori 2009 AUTH_ERROR Kimlik doğrulama hatası.
Kategori 2011 CONFIG_ERROR Uygulama modülü ayrıcalık hatası.
Kategori 2016 CONFIG_ERROR Çevrimdışı yapılandırma hatası.
Kategori 2017 CONFIG_ERROR Çevrimdışı profil yapılandırma hatası.
Kategori 3000 EXPECTED_ERROR Dahili olayı senkronize edin.
Kategori 3003 CONFIG_ERROR Çevrimdışı profil yapılandırma hatası.