Analyzujte protokoly generované systémom pomocou Application Insights

Aplikácie na plátne môžete pripojiť k Application Insights, funkcii Azure Monitor. Application Insights obsahuje výkonné analytické nástroje, ktoré vám pomôžu diagnostikovať problémy a pochopiť, čo používatelia skutočne robia s vašimi aplikáciami. Môžete zhromažďovať informácie, ktoré vám pomôžu dosiahnuť lepšie obchodné rozhodnutia a zlepšiť kvalitu vašich aplikácií.

V tomto rýchlom štarte používame aplikáciu plátna s názvom Kudos na preskúmanie konceptov systémom generovaných protokolov v aplikáciách plátna a ich použitie vo vašich aplikáciách. Vzorová aplikácia Kudos je súčasťou sady aplikácií na zapojenie zamestnancov, ktoré sú k dispozícii na stiahnutie zo súpravy Employee Experience Starter Kit.

Požiadavky

• Musíte mať prístup k portálu Azure.
• Musíte mať povolenie vytvárať zdroje Azure.

Poznámka

Ak chcete zobraziť telemetrické informácie, váš správca nájomníka musí povoliť Štatistiky aplikácie Canvas. Prihláste sa ako správca v Power Platform centre správcov. Prejdite na Nastavenia > Nastavenia nájomníka > Štatistiky aplikácie Canvas. Na table Štatistiky aplikácie Canvas nastavte prepínač na Zapnuté a uložte zmeny. Ďalšie informácie nájdete v časti Nastavenia nájomníka.

Voliteľné

• Stiahnite si a nainštalujte si aplikáciu Kudos z Employee Experience Starter Kit. Namiesto toho môžete použiť aj existujúcu aplikáciu.

Vytvorenie zdroja Application Insights

Pred odoslaním systémových protokolov z aplikácie musíte vytvoriť Application Insights zdroj na ukladanie udalostí.

1. Prihláste sa do portálu Azurel.

2. Vyhľadajte položku Application Insights:

   

3. Vytvorenie zdroja Application Insights:

   

4. Zadajte príslušné hodnoty a vyberte položku Skontrolovať + vytvoriť.

   Ďalšie informácie nájdete v časti Vytvorenie zdroja Application Insights.

   

5. Po vytvorení Application Insights inštancie skopírujte Kľúč nástroja v prehľade inštancie na použitie v nadchádzajúcom krok.

   

Pripojte svoju aplikáciu k Application Insights

Poznámka

• Pri zadávaní kľúča prístrojového vybavenia si uvedomte, že údaje možno odosielať medzi nájomníkmi. Udalosti sledovania sa odosielajú do prostriedku App Insights, ktorý zodpovedá kľúču inštrumentácie, ktorý ste nastavili pre svoju aplikáciu, aj keď je cieľová inštancia App Insights v inom nájomníkovi ako aplikácia.
• Pri importovaní existujúcich súborov .msapp buďte opatrní, pretože môžu byť prítomné kľúče nástrojov pre App Insights. Po importe manuálne otvorte aplikáciu, aby ste si overili, či sa používa správny kľúč nástrojov App Insights.

1. Prihláste sa do služby Power Apps.

2. Na ľavej navigačnej table vyberte možnosť Aplikácie. Zo zoznamu aplikácií vyberte aplikáciu Kudos a potom vyberte Upraviť:

   

   Poznámka

   Môžete tiež vytvoriť novú aplikáciu alebo upraviť namiesto toho akúkoľvek existujúcu aplikáciu.

3. Vyberte objekt Aplikácia v ľavom navigačnom strome a prilepte Kľúč nástroja:

   

4. Uložte a publikujte svoju aplikáciu.

5. Hrajte zverejnenú aplikáciu a prehliadajte rôzne obrazovky.

Počas prehliadania obrazoviek aplikácie sa udalosti automaticky zaznamenávajú do Application Insights vrátane podrobností o používaní, ako napríklad:

• Odkiaľ sa k aplikácii pristupuje
• Ktoré zariadenia sa používajú
• Použité typy prehliadačov

Dôležité

Ak chcete poslať udalosti, musíte spustiť zverejnenú aplikáciu Application Insights. Udalosti sa neodosielajú do Application Insights pri zobrazení ukážky aplikácie v Power Apps Studio.

Zobrazenie udalostí v Application Insights

1. Prihláste sa na portál Azure a otvorte zdroj Application Insights, ktorý ste vytvorili skôr.

2. V ľavej navigačnej table prejdite nadol a vyberte položku Používatelia pod sekciou Používanie.

   Poznámka

   V zobrazení Používatelia sa zobrazujú podrobnosti o používaní aplikácie, ako napríklad:

   • Počet používateľov, ktorí si zobrazili aplikáciu
   • Počet používateľských relácií
   • Počet zaznamenaných udalostí
   • Podrobnosti o operačných systémoch používateľov a verzii prehliadača
   • Región a poloha používateľov

   Ďalšie informácie o používateľoch, reláciách a analýze udalostí nájdete v Application Insights.

3. Vyberte jednu z používateľských relácií, ktoré chcete podrobne preveriť. Môžete vidieť informácie, ako je dĺžka relácie a navštívené obrazovky:

   

4. Vyberte zobrazenie Udalosti v ľavom navigačnom paneli v časti Použitie . Môžete vidieť súhrn všetkých obrazoviek zobrazených vo všetkých reláciách aplikácií:

   

Tip

K dispozícii sú ďalšie Application Insights funkcie, ako napríklad:

• Lieviky
• Kohorty
• Analýza vplyvu
• Retenčná analýza
• Postupy používania

Vytvorenie vlastných sledovacích udalostí

Vlastné sledovania môžete písať priamo do Application Insights a začať analyzovať informácie špecifické pre váš scenár. Funkcia Sledovať vám umožňuje zhromažďovať:

• Podrobné informácie o používaní pre ovládacie prvky na obrazovkách
• Ktorí konkrétni používatelia pristupujú k vašej aplikácii
• Aké chyby sa vyskytujú

Sledovanie môže tiež pomôcť diagnostikovať problémy, pretože môžete poslať stopu informácií, keď vaši používatelia prehliadajú vašu aplikáciu a vykonávajú rôzne akcie. Správy sledovania odoslané na Application Insights majú jednu z troch závažnosti:

• Informácie
• Upozornenie
• Chyba

V závislosti od vášho scenára si môžete zvoliť odoslanie správy sledovania s primeranou závažnosťou. Môžete sa dotazovať na údaje a vykonávať špecifické akcie na základe závažnosti.

Poznámka

Ak zaznamenávate akékoľvek osobné údaje, uvedomte si svoje povinnosti v súvislosti s rôznymi zákonmi a nariadeniami o ochrane súkromia. Ďalšie informácie nájdete v Centre dôveryhodnosti spoločnosti Microsoft a Portál dôveryhodnosti služieb .

Teraz vytvorte vo svojej aplikácii nový komponent na zhromažďovanie spätnej väzby na každej obrazovke a zapíšte udalosti do Application Insights.

1. Prihláste sa do služby Power Apps.

2. Na ľavej navigačnej table vyberte možnosť Aplikácie. Zo zoznamu aplikácií vyberte aplikáciu Kudos a potom vyberte Upraviť.

   Poznámka

   Môžete tiež vytvoriť novú aplikáciu alebo upraviť existujúcu aplikáciu.

3. Vyberte možnosť Súčasti v Stromovej štruktúre:

   

4. Vyberte Nový komponent a potom zmeňte šírku na 200 a výšku na 75:

   

5. Vyberte Vložiť z ponuky a potom vyberte položku Ikony na pridanie Emoji – zamračený a Emoji – usmiaty:

   

6. Vyberte Nová vlastná vlastnosť na vytvorenie vlastnej vlastnosti:

   

7. Zadajte Názov a Zobrazovaný názov vlastnosti, ako napr. FeedbackSceen.

8. Zadajte Opis vlastnosti.

9. Vyberte Typ vlastnosti ako Vstup a Dátový typ ako Obrazovka:

   

   Poznámka

   Vlastnosť Vstup umožňuje zachytiť zobrazované meno a jeho súčasť, aby ste mohli tieto informácie zaznamenať do Application Insights.

10. Vyberte komponent v Stromovom zobrazení, vyberte Ďalšie akcie (…) a potom vyberte Premenovať pre premenovanie komponentu na zmysluplný názov, ako napríklad FeedbackComponent.

    

11. Vyberte ikony, vyberte Ďalšie akcie (…) a potom vyberte Premenovať na premenujte ikony zmysluplnými názvami, ako napríklad FrownIcon a SmileIcon.

12. Vyberte FrownIcon, vyberte vlastnosť OnSelect a do panela vzorcov zadajte nasledujúci výraz:

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

    

    Poznámka

    Výraz so vzorcom odošle UserName, UserEmail, Screen a Feedback (s hodnotou -1) do Application Insights.

13. Vyberte SmileIcon, vyberte vlastnosť OnSelect a do panela vzorcov zadajte nasledujúci výraz:

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

14. Pridajte súčasť na jednu z obrazoviek v aplikácii:

    

15. Vyberte Uložiť a potom vyberte Publikovať na uloženie a zverejnenie aplikácie.

16. Prehrajte zverejnenú aplikáciu a zo svojich obrazoviek pošlite usmiatu a zamračenú odozvu.

    Dôležité

    Ak chcete poslať udalosti, musíte spustiť zverejnenú aplikáciu Application Insights. Udalosti sa neodosielajú do Application Insights pri zobrazení ukážky aplikácie v Power Apps Studio.

    

Analýza údajov v Application Insights

Teraz môžete začať analyzovať údaje, ktoré ste odoslali pomocou funkcie Sledovať z vašej aplikácie v Application Insights.

1. Prihláste sa na portál Azure a otvorte zdroj Application Insights, ktorý ste vytvorili skôr:

   

2. Vyberte Denníky v časti Monitorovanie v ľavom navigačnom paneli:

   

3. Zadajte nasledujúci dopyt a výberom možnosti Spustiť zobrazte spätnú väzbu prijatú z vašej aplikácie:

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

   

4. Vyberte riadok vo výsledkoch a rozbaľte pole customDimensions.

   Hodnoty pre Screen, UserName, UserEmail a FeedbackValue pre udalosť OnSelect ikony úsmevu alebo zamračenia vo vašej súčasti boli zaznamenané. Hodnoty sa zaznamenávajú aj pre každú udalosť odoslanú na Application Insights, ako napríklad appId, názov aplikácie a appSessionId.

   

5. Pomocou nasledujúceho príkladu dotazu môžete rozšíriť vlastnosti vlastných dimenzií JSON a premietnuť stĺpce do zobrazenia výsledkov.

   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
   

   

   Tip

   Dotazy denníka sú mimoriadne účinné. Môžete ich použiť na spojenie viacerých tabuliek, agregáciu veľkého množstva údajov a vykonávanie zložitých operácií. Prečítajte si viac o dotazoch na denník.

Monitorovanie nespracovaných chýb (experimentálne)

[Táto sekcia obsahuje predbežnú dokumentáciu a môže sa zmeniť.]

Dôležité

• Toto je experimentálna funkcia.
• Experimentálne funkcie nie sú určené na produkčné účely a môžu mať obmedzenú funkčnosť. Tieto funkcie sú k dispozícii pred oficiálnym vydaním, aby k nim mohli zákazníci získať rýchly prístup a poskytnúť odozvu.

Nemôžete vždy predvídať a plánovať všetky chyby, ktoré sa môžu vyskytnúť, keď je vaša aplikácia spustená. Neošetrené Power Fx chyby vzorcov sú hlásené používateľom ako bannerové správy. Môžete ich tiež nahlásiť Application Insights , aby ste pochopili ich frekvenciu a závažnosť bez toho, aby ste sa museli spoliehať na to, že problémy nahlásia používatelia vašej aplikácie. Môžete tiež nastaviť upozornenia v reálnom čase , keď sa vyskytnú chyby pri spustení, aby ste zaujali proaktívnejší prístup.

Povoliť preposielanie chýb do Application Insights

Musíte povoliť nastavenie, ktoré umožňuje Power Apps prenášať neošetrené chyby spustenia do Azure Application Insights.

Upozornenie

Povolenie tohto nastavenia môže spôsobiť dodatočné náklady súvisiace s ukladaním protokolov Application Insights.

Ak chcete povoliť odovzdávanie chýb, prejdite na Nastavenia > Nadchádzajúce funkcie > Experimentálne > Preniesť chyby do Azure Application Insights a zároveň ponechajte svoju aplikáciu na plátne otvorenú na úpravy. Uložte a zverejnite svoju aplikáciu.

Chybové udalostí v Application Insights

Neošetrené Power Fx chyby, ktoré zaznamenali používatelia pri spustení aplikácie, sa nahlásia do tabuľky sledovania . Neošetrené chyby je možné identifikovať a odlíšiť od iných chybových udalostí podľa správy udalosti „Nespracovaná chyba“. Dimenzia „úroveň závažnosti“ týchto udalostí je 3 (TraceSeverity.Error).

Podrobné chybové hlásenia sú uvedené v dimenzii „chyby” v rámci vlastnosti customDimension. V situáciách, keď sa počas tej istej operácie vyskytlo viacero chýb, sú chyby konsolidované v dimenzii "chyby" jednej udalosti sledovania. Chybové hlásenia sú rovnaké ako hlásenia v Monitor počas relácie ladenia naživo.

Nasledujúci príklad dotazu identifikuje neošetrené chyby a rozširuje všetky chybové správy zahrnuté v udalosti sledovania:

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

Korelačné sledovanie (experimentálne)

[Táto sekcia obsahuje predbežnú dokumentáciu a môže sa zmeniť.]

Dôležité

• Toto je experimentálna funkcia.
• Experimentálne funkcie nie sú určené na produkčné účely a môžu mať obmedzenú funkčnosť. Tieto funkcie sú k dispozícii pred oficiálnym vydaním, aby k nim mohli zákazníci získať rýchly prístup a poskytnúť odozvu.

Pripojenie k externým údajom a službám je základom väčšiny aplikácií. Sledovanie korelácie generuje a šíri informácie o kontexte, aby sa pripojili k denníkom generovaným systémom v rámci aplikácie canvas a jej pripojení, s výhradou určitých obmedzení. Vaša aplikácia môže napríklad vyvolať vlastný konektor, ktorý zase vyvolá funkciu Azure alebo inú REST API. Sledovanie korelácie vám umožňuje korelovať akcie vykonané v aplikácii so základnými volaniami rozhrania API naprieč vrstvami. Môže to byť užitočné pri riešení problémov.

Sledovanie korelácie aplikácie Canvas je implementáciou sledovania kontextu a riadi sa špecifikáciou W3C.

Povoliť koreláciu sledovania

Upozornenie

Povolenie tohto nastavenia môže spôsobiť dodatočné náklady súvisiace s ukladaním protokolov Application Insights.

Ak chcete povoliť funkciu sledovania korelácie, prejdite na stránku Nastavenia > Nadchádzajúce funkcie > Experimentálne > Povoliť sledovanie korelácie Azure Application Insights a zároveň ponechajte svoju aplikáciu na plátne otvorenú na úpravy. Uložte a zverejnite svoju aplikáciu.

Obmedzenia

• Sledovanie korelácií je dostupné len pre vlastné konektory. Iné typy konektorov nie sú podporované.
• HTTP požiadavky sa zachytávajú v Application Insights iba ak je pripojená služba pripojená aj k Application Insights.

Používanie sledovania korelácie

Keď je povolené, sledovanie korelácií pridá novú udalosť denníka vygenerovanú systémom do tabuľky závislostí inštancie Application Insights aplikácie na plátne. Táto udalosť sa zaznamená v čase prijatia odpoveď zo sieťového hovoru. Udalosti závislosti zachytávajú podrobnosti o sieťovom hovore vrátane hlavičiek požiadavky a odpovede, kódu stavu odpovede a trvania hovoru.

Ak je pripojená služba pripojená aj k Application Insights, v tabuľke požiadaviek v službe Application Insights sa vygeneruje dodatočná udalosť denníka generovaná systémom zachytávajúca požiadavku. Application Insights inštancia. Niektoré služby Azure, ako napríklad funkcie Azure, je možné pripojiť bez akéhokoľvek kódovania z portálu Azure. K rovnakej Application Insights inštancii je možné pripojiť aplikáciu plátna alebo viacero aplikácií a pripojených služieb.

Sieťové volania pre podporované konektory je možné spojiť s inými systémami generovanými protokolmi v dimenzii „operation_Id“. Nasledujúci príklad dotazu ukazuje uskutočnenie sieťového volania popri udalostiach sledovania vygenerovaných počas relácie aplikácie.

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

Export údajov do Power BI

Môžete exportovať svoje údaje Application Insights a výsledky dotazov do Power BI na analýzu a prezentáciu údajov.

1. Prihláste sa na portál Azure a otvorte zdroj Application Insights, ktorý ste vytvorili skôr:

2. Vyberte Denníky v časti Monitorovanie v ľavom navigačnom paneli:

3. V okne dotazu analýzy denníka vyberte ponuku Exportovať .

4. Vyberte možnosť Exportovať do Power BI (M dotaz) na stiahnutie súboru Power BI dopytu:

   

5. Otvorte stiahnutý súbor v textovom editore a skopírujte dotaz do schránky.

6. Otvorí položku Power BI.

7. Vyberte ponuku Získať údaje v páse Domov a potom vyberte Prázdny dopyt:

   

8. V okne dotazov vyberte Pokročilý editor. Prilepte dotaz do okna, vyberte Hotovo a potom vyberte Zavrieť & Použiť:

   

Grafy a vizualizácie môžete vytvárať aj v Power BI na prezentáciu odozvy vo vašich aplikáciách, ako aj prijímanie rozhodnutí a akcií založených na údajoch.

Predvolený kontext a dimenzie udalosti Sledovať

Do vlastnosti customDimensions každej udalosti Sledovať sa pridá aj súbor predvolených dimenzií. Tieto dimenzie sa môžu použiť na identifikáciu relácií aplikácií, v ktorých sa udalosti vyskytli. Ak zaznamenáte ďalšie vlastné údaje pomocou funkcie sledovania, zobrazia sa aj vo vlastných dimenziách.

Názov dimenzie	Predstavuje
ms-appId	ID aplikácie, ktorá poslala udalosť.
ms-appname	Názov aplikácie, ktorá poslala udalosť.
ms-appSessionId	ID relácie aplikácie. V niektorých scenároch nemusí byť táto hodnota vyplnená. Ak je k dispozícii, táto hodnota prepíše štandardnú dimenziu Application Insights sessionID.
ms-tenantID	Jedinečný identifikátor nájomcu, kde je aplikácia zverejnená.
ms-environmentId	Názov prostredia, kde je aplikácia zverejnená.
userId	Jedinečný identifikátor používateľa spojeného s reláciou.
ms-duration	Vložená hodnota merajúca čas, ktorý potrebuje používateľ na prechod z jednej obrazovky na druhú. Táto hodnota má prednosť pred štandardnou dimenziou trvania Application Insights PageView.
sessionId	ID relácie, ktoré možno použiť na koreláciu všetkých udalostí spojených s jednou reláciou aplikácie. Táto hodnota je vždy prítomná a odporúča sa na pochopenie počtu jedinečných relácií. Táto hodnota je prevzatá z ID relácie prehrávača a zobrazuje sa pri prezeraní podrobností relácie počas prehrávania aplikácie. ID relácie môže byť niekedy predvolené, náhodné a môže mať aj jedinečne generovanú hodnotu Application Insights. Táto predvolená hodnota nie je spoľahlivá a nekoreluje so žiadnymi parametrami špecifickými pre aplikáciu.
Duration	Vložená hodnota merajúca čas, ktorý potrebuje používateľ na prechod z jednej obrazovky na druhú. Táto hodnota je rovnaká ako trvanie uvedené v dimenzii ms-duration.
ms-isTest	Označuje, či je relácia priradená k testovaciemu programu Test Studio.
ms-currentScreenName	Názov stránky, z ktorej používateľ prechádza (zobrazuje sa pri udalostiach navigácie na stránke).
ms-targetScreenName	Názov stránky, na ktorú používateľ prechádza (zobrazuje sa pri udalostiach navigácie na stránke).

Nepodporované scenáre

Application Insights nepodporuje nasledujúce scenáre.

• Udalosti prehrávača offline sa nezachytávajú.
• Udalosti mobilnej aplikácie (iOS aj Android) sa pri pozastavení aplikácie nezaznamenávajú.
• GCC a neverejné cloudy nie sú podporované.

Poznámka

Môžete nás informovať o svojich voľbách jazyka pre dokumentáciu? Absolvujte krátky prieskum. (upozorňujeme, že tento prieskum je v angličtine)

Prieskum bude trvať približne sedem minút. Nezhromažďujú sa žiadne osobné údaje (vyhlásenie o používaní osobných údajov).