Rendszer által generált naplók elemzése a Application Insights

A vászonalapú alkalmazásokat Application Insights a Azure Monitor egyik funkciójához csatlakoztathatja. Application Insights Hatékony elemzési eszközöket tartalmaz, amelyek segítenek diagnosztizálni a problémákat, és megérteni, hogy a felhasználók valójában mit csinálnak az alkalmazásokkal. Információkat gyűjthet, amelyek segítenek jobb üzleti döntések meghozatalában és az alkalmazások minőségének javításában.

Előfeltételek

• Hozzáféréssel kell rendelkeznie a Azure Portal.
• Az Azure-erőforrások létrehozásához engedélyekkelkell rendelkeznie.

Egy Application Insights erőforrás létrehozása

Mielőtt rendszer által generált naplókat küldhet egy alkalmazásból, létre kell hoznia egy Application Insights erőforrást az események tárolásához.

Hozzon létre egy munkaterület-alapú erőforrást Application Insights a Azure Portal.

Az alkalmazása csatlakoztatása az Application Insights szolgáltatáshoz

1. Jelentkezzen be a Power Apps rendszerbe.

2. Nyisson meg egy alkalmazást szerkesztésre.

3. Válassza ki az Alkalmazás objektumot a bal oldali navigációs fa nézetben, és illessze be a kapcsolati sztringet az Application Insights erőforrásból:

   

4. Mentse és tegye közzé az alkalmazást.

5. Játssza le a közzétett alkalmazást, és böngésszen a különböző képernyőkön.

Az alkalmazás képernyőinek böngészése során a rendszer automatikusan naplózza az Application Insights eseményeket, beleértve a használati adatokat, például:

• Az alkalmazás elérhetőségének helye
• Milyen eszközöket használnak
• A használt böngészőtípusok

Események megtekintése a Application Insights-szolgáltatásban

1. Jelentkezzen be a Azure Portal, és nyissa meg a korábban létrehozott erőforrást Application Insights . ...

2. Görgessen le a bal oldali navigációs panelen, és válassza a Felhasználók lehetőséget a Használat szakaszban.

   Feljegyzés

   A Felhasználók nézet az alkalmazás használati adatait jeleníti meg, például:

   • Az alkalmazást megtekintő felhasználók száma
   • Felhasználói munkamenetek száma
   • Naplózott események száma
   • A felhasználók operációs rendszerének és a böngésző verziójának részletei
   • A felhasználók régiója és tartózkodási helye

   További információ a felhasználók, munkamenetek és események elemzéséről Application Insights:

3. Válassza ki a felhasználói munkamenetek egyikét, hogy a konkrét részletekbe tudjon fúrni. Olyan információkat láthat, mint például a munkamenet hossza és a meglátogatott képernyők:

   

4. Válassza az Események nézetet a bal oldali navigációs panelen a Használat szakaszban. Az alkalmazás-munkamenetekben megtekintett összes képernyő összegzését láthatja:

   

Egyéni nyomkövetési események létrehozása

Az egyéni nyomkövetéseket közvetlenül is beírhatja az Application Insights-szolgáltatásba és megkezdheti a forgatókönyvére vonatkozó információk elemzését. A Trace funkció lehetővé teszi a következők gyűjtését:

• Részletes használati információk a képernyőkön lévő vezérlőkhöz
• Mely felhasználók férnek hozzá az alkalmazáshoz
• Milyen hibák fordulnak elő

A Nyomon követés segítheti a problémák diagnosztizálását is, mivel a felhasználók böngészése során elküldheti a nyomon követési információkat az alkalmazáson keresztül, és különböző műveleteket végezhet el. A három súlyossági fokozat egyikével küldött Application Insights nyomkövetési üzenetek száma:

• Tájékoztatás
• Figyelmeztetés:
• Hiba

A forgatókönyvtől függően megadhatja, hogy a megfelelő súlyosságú nyomkövetési üzenet legyen elküldve. Lekérdezheti az adatokat, és a súlyosság alapján konkrét műveleteket hajthat végre.

Most hozzon létre egy új összetevőt az alkalmazásban, amely visszajelzést gyűjt az egyes képernyőkön, és írja be Application Insights az eseményeket.

1. Jelentkezzen be a Power Apps rendszerbe.

2. Válassza az Alkalmazások lehetőséget a bal oldali navigációs panelen. Az alkalmazások listájából válassza ki a Kudos alkalmazást , majd válassza a Szerkesztés lehetőséget.

   Feljegyzés

   Létrehozhat egy új alkalmazást is , vagy szerkeszthet egy meglévő alkalmazást.

3. Válassza az Összetevők lehetőséget a fa nézetben :

   

4. Válassza az Új összetevő lehetőséget, majd méretezze át a szélességet 200-ra, a magasságot pedig 75-re:

   

5. Válassza a Beszúrás lehetőséget a menüből, majd válassza az Ikonok lehetőséget az Emoji - Homlokráncolás és Emoji - Mosoly hozzáadásához:

   

6. Válassza az Új egyéni tulajdonság lehetőséget egyéni tulajdonság létrehozásához:

   

7. Adja meg a tulajdonság nevét és a megjelenítendő nevet , például FeedbackSceen .

8. Adja meg a tulajdonság leírását.

9. Válassza ki a tulajdonság típusát bemenetként és az adattípust képernyőként :

   

   Feljegyzés

   A Bemenet tulajdonság lehetővé teszi, hogy rögzítse a képernyő nevét és összetevőjét, így naplózhatja ezeket az adatokat Application Insights-szolgáltatásba.

10. Válassza ki az összetevőt a fanézetben, válassza a További műveletek ( ...) lehetőséget, majd válassza az Átnevezés lehetőséget az összetevő értelmes névvel, például FeedbackComponent átnevezéséhez.

    

11. Jelölje ki az ikonokat, válassza a További műveletek(...) lehetőséget , majd válassza az Átnevezés lehetőségetaz ikonok értelmes nevekkel való átnevezéséhez, példáulFrownIcon és SmileIcon .

12. Válassza a FrownIcon lehetőséget, válassza ki az OnSelect tulajdonságot , majd írja be a következő kifejezést a szerkesztőlécen:

    Trace(
       "App Feedback",
       TraceSeverity.Information,
           {
             UserName: User().FullName,
             UserEmail: User().Email,
             Screen: FeedbackComponent.FeedbackScreen.Name,
             FeedbackValue: "-1"
           }
         );
    Notify("Thanks for your feedback!");
    

    

    Feljegyzés

    A képletkifejezés elküldi a UserName,UserEmail,Screen és a Feedback (érték-1 ) a következőnek Application Insights: .

13. Válassza a SmileIcon lehetőséget, válassza ki az OnSelect tulajdonságot , majd írja be a következő kifejezést a szerkesztőlécen:

    Trace(
       "App Feedback",
       TraceSeverity.Information,
           {
             UserName: User().FullName,
             UserEmail: User().Email,
             Screen: FeedbackComponent.FeedbackScreen.Name,
             FeebackValue: "1"
           }
         );
    Notify("Thanks for your feedback!");
    

14. Adja hozzá az összetevőt az alkalmazás egyik képernyőjéhez:

    

15. Válassza a Mentés, majd a Közzététel lehetőséget az alkalmazás mentéséhez és közzétételéhez.

16. Használja a közzétett alkalmazást, és küldjön egy mosoly és egy komor visszajelzést a képernyőkön.

    Fontos

    Használni a kell a közzétett alkalmazást, hogy elküldjön eseményeket az Application Insights-szolgáltatásba. A rendszer nem küldi el az eseményeket az Application Insights-szolgáltatásba, amikor megtekinti az alkalmazást a előnézetét a Power Apps Studio-szolgáltatásban.

    

Adatok elemzése az Application Insights-szolgáltatásba

Most már elkezdheti elemezni az alkalmazásból a Trace Application Insightsfüggvénnyel küldött adatokat.

1. Jelentkezzen be a Azure Portal , és nyissa meg a korábban Application Insights létrehozott erőforrást:

   

2. Válassza a Naplók lehetőséget a bal oldali navigációs panel Figyelés területén :

   

3. Írja be a következő lekérdezést, és válassza a Futtatás lehetőséget az alkalmazástól kapott visszajelzések megtekintéséhez:

   traces
   | where message == "App Feedback"
   | order by timestamp
   

   

4. Jelöljön ki egy sort az eredmények között, és bontsa ki a customDimensions mezőt .

   A rendszer rögzítette a Screen,UserName,UserEmail ésFeedbackValue értékeket az összetevő mosoly vagy homlokránc ikonjának OnSelect eseményéhez. A rendszer minden egyes elküldött Application Insights eseményhez is rögzíti az értékeket, például az appId,appName és azappSessionId.

   

5. A következő példalekérdezéssel kibővítheti a JSON egyéni dimenziók tulajdonságait, és projektálhatja az oszlopokat az eredmények nézetében.

   traces
       | extend customdims = parse_json(customDimensions)
       | where message == "App Feedback"
       | project timestamp
           , message
           , AppName = customdims.['ms-appName']
           , AppId = customdims.['ms-appId']
           , FeedbackFrom = customdims.UserEmail
           , Screen = customdims.Screen
           , FeedbackValue = customdims.FeedbackValue
       | order by timestamp desc
   

   

   Tipp.

   A naplólekérdezések rendkívül hatékonyak. Segítségükkel több táblát egyesíthet, nagy mennyiségű adatot vonhat összes, és összetett műveleteket hajthat végre. További információ a naplólekérdezésekről.

Nem kezelt hibák nyomon követése (kísérleti)

[Ez a témakör kiadás előtti dokumentációt tartalmaz és változhat.]

Nem mindig lehet előre látni és megtervezni az alkalmazás futása közben esetlegesen előforduló hibákat. A kezeletlen Power Fx képlethibákat a rendszer szalagüzenetként jelenti a felhasználóknak. Jelentheti Application Insights is őket, hogy segítsen megérteni gyakoriságukat és súlyosságukat anélkül, hogy az alkalmazás felhasználóira hagyatkozna a problémák jelentésében. Valós idejű riasztásokat is beállíthat futásidejű hibák esetén a proaktívabb megközelítés érdekében.

Engedélyezze a hibák átadását a következőnek: Application Insights

Engedélyeznie kell azt a beállítást, amely lehetővé teszi Power Apps a nem kezelt futásidejű hibák Azure-ba Application Insights való átadását.

A hibaátadás engedélyezéséhez lépjen a Beállítások > Közelgő funkciók > Kísérleti > hibák átadása az Azure-nak Application Insights , miközben a vászonalapú alkalmazás szerkesztésre nyitva marad. Mentse és tegye közzé az alkalmazást.

Hibaesemények megtekintése a Application Insightsban

A felhasználók által az alkalmazás futtatókörnyezetében tapasztalt nem kezelt Power Fx hibákat a rendszer a nyomkövetési táblába jelenti. A nem kezelt hibákat a "Nem kezelt hiba" eseményüzenet azonosíthatja és megkülönböztetheti a többi hibaeseménytől. Ezen események "severityLevel" dimenziója 3 (TraceSeverity.Error).

A részletes hibaüzenetek a customDimension tulajdonság "errors" dimenziójában találhatók. Olyan helyzetekben, amikor ugyanazon művelet során több hiba történt, a hibák egyetlen nyomkövetési esemény "hibák" dimenziójában vannak összesítve. A hibaüzenetek megegyeznek a Monitor ben jelentettekkel az élő hibakeresési munkamenet során.

A következő példalekérdezés azonosítja a kezeletlen hibákat, és kibővíti a nyomkövetési eseményben szereplő összes hibaüzenetet:

traces
    | where message == "Unhandled error"
    | extend customdims = parse_json(customDimensions)
    | extend errors = parse_json(tostring(customdims.['errors']))
    | mv-expand errors
    | project timestamp
        , itemId //unique identifier for the trace event
        , AppName = customdims.['ms-appName']
        , AppId = customdims.['ms-appId']
        , errors = errors.['Message']
    | order by timestamp desc

Korrelációs nyomkövetés (kísérleti)

[Ez a témakör kiadás előtti dokumentációt tartalmaz és változhat.]

A külső adatokkal és szolgáltatásokkal való kapcsolat a legtöbb alkalmazás számára alapvető fontosságú. A korrelációs nyomkövetés kontextusinformációkat generál és terjeszt, hogy összekapcsolja a rendszer által generált naplókat egy vászonalkalmazáson és annak kapcsolatain keresztül, bizonyos korlátozások mellett. Előfordulhat például, hogy az alkalmazás egy egyéni összekötőt hív meg, amely viszont meghív egy Azure-függvényt vagy más REST API-t. A korrelációs nyomkövetés lehetővé teszi az alkalmazásban végrehajtott műveletek és az alapul szolgáló API-hívások összekapcsolását a szinteken keresztül. Ez hasznos lehet a hibaelhárítás során.

A vászonalkalmazás-korrelációs nyomkövetés a kontextuskövetés megvalósítása, és a W3C specifikációt követi.

Korrelációs nyomkövetés engedélyezése

A korrelációs nyomkövetési funkció engedélyezéséhez lépjen a Beállítások > Közelgő funkciók > Kísérleti oldalra > Az Azure Application Insights korrelációkövetés engedélyezése a vászon szerkesztése közben tartsa nyitva. Mentse és tegye közzé az alkalmazást.

Korlátozások

• A korrelációkövetés csak egyéni csatlakozók esetén érhető el. Más csatlakozási típusok nem támogatottak.
• A HTTP-kéréseket a rendszer csak akkor rögzíti a Application Insights ben, ha a csatlakoztatott szolgáltatás a Application Insights-hoz is kapcsolódik.

Korrelációs nyomkövetés használata

Ha engedélyezve van, a korrelációs nyomkövetés egy új rendszer által generált naplóeseményt ad hozzá a vászonalkalmazás példányának függőségek táblázatához. Application Insights Ez az esemény akkor kerül rögzítésre, amikor egy hálózati hívásra érkezik válasz. A függőségi események rögzítik a hálózati hívás részleteit, beleértve a kérés- és válaszfejléceket, a válasz állapotkódját és a hívás időtartamát.

Ha a csatlakoztatott szolgáltatás a(z) Application Insights-hoz is csatlakozik, egy további rendszer által generált, a kérést rögzítő naplóesemény generálódik a szolgáltatás példányának requests Application Insights táblázatában. Egyes Azure-szolgáltatások, például az Azure Functions, kódolás nélkül csatlakoztathatók az Azure Portalról. Mind a vászonalkalmazás, mind több alkalmazás és összekapcsolt szolgáltatások csatlakoztathatók ugyanahhoz a Application Insights példányhoz.

A támogatott összekötők hálózati hívásai más rendszer által generált naplókkal is összekapcsolhatók az "operation_Id" dimenzióban. A következő példalekérdezés egy hálózati hívást mutat be az alkalmazásmunka során kibocsátott nyomkövetési események mellett.

traces | union dependencies | union requests | union pageViews | union customEvents
| project timestamp
    , itemType
    , name
    , operation_Name
    , message
    , severityLevel
    , customDimensions
    , operation_Id
    , operation_ParentId
| where operation_Id == "0a7729e3e83c4e4d93cb4f51149f73b9" //placeholder operation_Id, replace
| order by timestamp asc

Adatok exportálása: Power BI

Az Application Insights-adatok és a lekérdezés eredményei az elemzéshez és az adatok megjelenítéséhez is exportálhatók a Power BI-szolgáltatásba.

1. Jelentkezzen be a Azure Portal , és nyissa meg a korábban Application Insights létrehozott erőforrást:

2. Válassza a Naplók lehetőséget a bal oldali navigációs panel Figyelés területén :

3. A naplóelemzési lekérdezési ablakban válassza az Exportálás menüt.

4. Válassza az Exportálás ide: Power BI (M lekérdezés) lehetőséget a Power BI lekérdezési fájl letöltéséhez:

   

5. Nyissa meg a letöltött fájlt egy szövegszerkesztőben, és másolja a lekérdezést a vágólapra.

6. Power BI megnyitása

7. Válassza az Adatok lekérése menüt a Kezdőlap szalagon, majd válassza az Üres lekérdezés lehetőséget:

   

8. A lekérdező ablakban válassza a Speciális szerkesztő lehetőséget. Illessze be a lekérdezést az ablakba, válassza a Kész, majd a Bezárás és amp; Jelentkezés:

   

Diagramokat és képi megjelenítéseket is létrehozhat az Power BI-szolgáltatásban az alkalmazásban kapott visszajelzések megjelenítésére, valamint az adatokon alapuló döntések és műveletek elvégzésére.

Alapértelmezett nyomkövetési esemény környezete és dimenziói

Az alapértelmezett dimenziók egy készlete is hozzáadódik a customDimensions tulajdonsághoz minden nyomkövetési eseménynél. Ezekkel a dimenziókkal azonosíthatók az alkalmazások és alkalmazás-munkamenetek, amelyekben az események megtörténtek. Ha további egyéni adatokat naplóz a Nyomkövetés funkcióval, akkor azok az egyéni dimenziókban is megjelennek.

Nem támogatott esetek

Az Application Insights nem támogatja a következő eseteket.

• Az offline játékos eseményeket nem rögzíti.
• A mobilalkalmazások ( iOS és Android) eseményeit a rendszer nem rögzíti az alkalmazás felfüggesztésekor.