Jaa

Mobiilisovelluksen synkronoinnin ja toimintojen telemetriatapahtumat

  • Artikkeli

Offline-synkronointitapahtumiin liittyvät Power Apps -mobiilisovellustiedot ovat käytettävissä mallipohjaisten ja pohjaan perustuvien sovellusten osalta. Tietojen avulla voidaan arvioida organisaation offline-synkronointitapahtumien kuntoa ja suorituskykyä.

Nämä tiedot tallennetaan Power Apps>Mobiilisovelluksen synkronointi ja toiminnot -taulukkoon Application Insightsissa. Merkintä kirjataan, kun käyttäjä käyttää Power Apps -mobiilisovellusta, joka on määritetty offline-tilaan. Lisätietoja virhetapahtumista mallipohjaisissa sovelluksissa on käytettävissä kohdassa Power Apps>UCI.

Mobiilisovelluksen synkronointi ja toimintotapahtumien määritelmät

  • id: tapahtumatunnus.
  • target: tapahtuman seuraamaan skenaarioon nimi.
  • type: tapahtuman lähdetaulukko.
  • name: tapahtuman seuraamaan skenaarioon nimi.
  • duration: skenaarion kesto millisekunteina. Kesto voi sisältää pitkiä ajanjaksoja, jolloin sovellus on passiivinen.
  • operation_Id: istunnon yksilöllinen tunniste.
  • operation_ParentId: tapahtuman seuraaman skenaarion yksilöllinen tunniste.
  • user_Id: Microsoft Entra -käyttäjätunnus.
  • application_Version: sovelluksen versio.
  • customDimensions: sisältää seuraavat määritteet:
    • "EventName": tapahtuman seuraamaan skenaarioon yhteenveto (ScenarioEnd).
    • "ScenarioResult": ONNISTUI tai EPÄONNISTUI.
    • ErrorCode: virhekoodi, joka luodaan synkronoinnin epäonnistuessa. Lisätietoja: Virhekoodien yhdistämismääritystaulukko.
    • ErrorMessage: tyhjä skenaarion onnistuessa tai merkkijono, jolla virhe kuvaillaan.
    • FailureType: määrittää synkronointivirheen tyypin.
    • LogLevel: tapahtuman vakavuus tai raportointitaso. Kelvolliset arvot ovat tieto, virhe, varoitus, virhe tai sanallinen arvo.
    • DataSyncMode: millaista offline-synkronointia käyttäjätä on kokenut.
      • DELTA_SYNC: automaattinen lisäävä synkronointi.
      • GRID_SYNC: käynnistyy ruudukkonäkymän päivityksen perusteella.
      • FIRST_SYNC: laitteen ensimmäinen synkronointi (tai kirjautumisen tai uudelleenmäärityksen jälkeen).
      • FORCED_SYNC: käynnistyy Laitetila-sivun painikkeen perusteella.
      • SINGLE_RECORD_SYNC: käynnistyy palveluilmoituksen perusteella.
    • AppFlavor: laitteille asennettu alkuperäissovellus. Kelvolliset arvot ovat FieldService ja PowerApps.
    • AppInfo_Version: sovelluskaupan mukainen alkuperäissovelluksen versio.
    • ActiveDuration: skenaarion kesto millisekunteina sisältäen vain ajan, jona sovellus on aktiivinen.
    • DeviceInfo_Id: laitteen yksilöllinen tunniste.
    • DeviceInfo_model: laitemalli (kuten iPhone 13).
    • DeviceInfo_make: laitteen merkki (kuten Apple).
    • DeviceInfo_OsName: laitteen käyttöjärjestelmä (kuten Android).
    • DeviceInfo_OsVersion: käyttöjärjestelmän versio (kuten Android 13).
    • Loc_country: telemetrialaitteen alkuperä.
    • eventContext: sisältää seuraavat ominaisuudet:
      • CurrentSyncId: onnistuneen synkronoinnin suorituksen tunnus. Nollataan jokaisen onnistuneen synkronoinnin jälkeen (ei nollata virheen jälkeen).
      • CurrentActivityId: synkronoinnin suorituksen tunnus. Nollataan jokaisen synkronoinnin jälkeen.
      • entityName: taulukon nimi tietojen lataustapahtumissa.
      • ProfileId: sovellukselle ja käyttäjälle määritetyn offline-profiilin tunnus.
      • RecordCount: ladattujen tietueiden määrä.
      • ResponseSize: saapuvien tietojen koko HTTPClient-ohjelman ilmoituksen mukaan (pakattu koko).
      • ContentLength: saapuvien tietojen koko HTTPClient-ohjelman ilmoituksen mukaan (pakattu koko).

Unified Client Interfacen virhetapahtumat

  • timestamp [UTC]: tapahtuman aika.
  • problemId: "uci_trace" tai "uciMonitorFailure" (mistä tiedot ovat peräisin).
  • type: "uci_trace" tai "uciMonitorFailure" (mistä tiedot ovat peräisin).
  • outType: "uci_trace" tai "uciMonitorFailure" (mistä tiedot ovat peräisin).
  • outerMessage: virhesanoma.
  • itemType: "poikkeus".
  • CustomDimensions:
    • eventContext: lisätietoja virheestä.
    • ServerConnectivityState: määrittää, onko käyttäjä offline-tilassa. (offline/online)
    • NetworkConnectivityState: määrittää, onko käyttäjällä internetyhteys. Huomaa, että käyttäjä voi olla offline-tilassa siten, että hänellä on käytettävissään internetyhteys.
    • IsOfflineByDefaultApp: kun epätosi, tarkoittaa, että Työ on offline-tilassa -ominaisuus on käytössä. Kun tosi, tarkoittaa, että ensisijaisesti offline on käytössä.
    • callStack: ohjelmointikoodi, jossa virhe ilmeni.
    • hostSubType: "PowerApps-soitin-iOS-fieldservice"
    • hostType: "MobileApplication".
  • Operation_ID: sesionID:n merkijonoketjutus, jota seuraa merkki _ ja ulkoinen korrelointitunnus, kuten e11e8465-bc8f-4319-b64a-9c1e42453148_0da90a33-ad68-4a4e-bd45-5728d5da719a.
  • Operation_ParentID: virheeseen liittyvä aktiviteettitunnus.
  • SessionId: virheen istuntotunnus.
  • UserId: Dynamics 365 -käyttäjätunnus.
  • User_authenticatedID: Dynamics 365 -käyttäjätunnus.
  • Application_version: sovelluksen versio, kuten 9.2.24045.00212.
  • Client_Type: käyttöjärjestelmän versio, kuten iOS tai Android.

Esimerkkiskenaarioita

Offline-synkronointivirheet virhesanoman mukaan

Tämän kyselyn avulla voit nähdä, millaisia ongelmia etulinjan työntekijät kohtaavat synkronoinnin epäonnistuessa. Tietyt virheet ovat odotettavissa esimerkiksi, kun mobiilisovellus suljetaan tai verkkoyhteys katkeaa synkronoinnin aikana estäen synkronoinnin valmistumisen. Virhekoodien määritelmät esitetään Virhekoodien yhdistämismääritystaulukossa.

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)

Synkronoituja tietueita keskimäärin taulukon mukaan

Tämän kyselyn avulla voit arvioida, mitkä taulukot vaikuttavat useimpiin synkronoitaviin tietueisiin. Näiden tietojen avulla voit yrittää jatkaa offline-profiilisi optimointia vähentämällä tietueita tai tietoja kussakin taulukossa.

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

Synkronoinnin keskimääräinen kesto synkronointitilan mukaan

Tämän kyselyn avulla voit arvioida organisaatiosi käyttäjien synkronoinnin keskimääräistä kestoa.

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

Synkronointitiedot käyttäjän mukaan

Tämä kysely tarjoaa käyttäjäkohtaisen synkronoinnin näkymän, mukaan lukien viimeisimmän synkronoinnin päivämäärän, viimeisimmän virheen, synkronoinnin keston ja synkronoidut tietueet.

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

Käyttäjät laitetyypin ja sovellusversion mukaan

Tämä kysely antaa lisätietoja organisaatiosi käyttäjistä, jotka käyttävät mobiilisovellusta laitemallillaan.

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

Virhekoodien yhdistämismääritys

Virhekoodi Virheen tyyppi Määritelmä
-2146864604 CONFIG_ERROR Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2146864606 CONFIG_ERROR Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2146864607 CONFIG_ERROR Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2146864608 CONFIG_ERROR Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2146869250 CONFIG_ERROR Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147015328 ACCESS_ERROR Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147088248 CONFIG_ERROR Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147155198 VIRHE Katso merkeillä –214 alkavien virhekoodien osalta Verkkopalvelun virhekoodit.
-2147155198 ACCESS_ERROR Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147167669 ACCESS_ERROR Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147180269 ACCESS_ERROR Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147180284 ACCESS_ERROR Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147187375 VIRHE Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147187388 VIRHE Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147187389 VIRHE Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147204270 VIRHE Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147204339 VIRHE Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147204784 VIRHE Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147209463 ACCESS_ERROR Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147217124 VIRHE Katso merkeillä –214 alkavien virhekoodien osalta Verkkopalvelun virhekoodit.
-2147220884 VIRHE Katso merkeillä –214 alkavien virhekoodien osalta Verkkopalvelun virhekoodit.
-2147220955 ACCESS_ERROR Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147220956 EXTERNAL_ERROR Katso merkeillä –214 alkavien virhekoodien osalta Verkkopalvelun virhekoodit.
-2147220960 ACCESS_ERROR Sovelluksen tai käyttäjän määritysvirhe. Katso Verkkopalvelun virhekoodit.
-2147220970 VIRHE Katso merkeillä –214 alkavien virhekoodien osalta Verkkopalvelun virhekoodit.
-2147220989 VIRHE Katso merkeillä –214 alkavien virhekoodien osalta Verkkopalvelun virhekoodit.
-50 VIRHE Sisäinen virhe.
0 VIRHE Tuntematon virhe.
2000 VIRHE Määrittämätön virhe.
2002 VIRHE Dataverse SQL -aikakatkaisu.
2003 DATABASE_ERROR Tietokantavirhe.
2004 NETWORK_ERROR Verkkovirhe.
2005 SERVER_ERROR Palvelinvirhe.
2006 AUTH_ERROR Todennusvirhe.
2007 DEVICE_ERROR Levy täynnä -virhe.
2008 VIRHE Sisäinen virhe.
2009 AUTH_ERROR Todennusvirhe.
2011 CONFIG_ERROR Sovellusmoduulin oikeuksien virhe.
2016 CONFIG_ERROR Offline-määrityksen virhe.
2017 CONFIG_ERROR Offline-profiilin määritysvirhe.
3000 EXPECTED_ERROR Synkronoinnin sisäinen tapahtuma.
3003 CONFIG_ERROR Offline-profiilin määritysvirhe.