Sistēmas ģenerēto žurnālu analīze, izmantojot Application Insights

Varat savienot savas audekla programmas ar Application Insights Azure Monitor līdzekli. Application Insights Iekļauti efektīvi analīzes rīki, kas palīdz diagnosticēt problēmas un izprast, ko lietotāji patiesībā dara ar jūsu lietotnēm. Varat apkopot informāciju, lai palīdzētu jums pieņemt labākus biznesa lēmumus un uzlabot lietotņu kvalitāti.

Priekšnoteikumi

• Jums ir jābūt piekļuvei Azure portālam.
• Lai izveidotu Azure resursus , jums ir jābūt atļaujām.

Application Insights resursa izveidošana

Lai varētu nosūtīt sistēmas ģenerētus žurnālus no programmas, ir jāizveido resurss Application Insights notikumu glabāšanai.

Izveidojiet darbvietas resursu Application Insights Azure portālā.

Izveidojiet jūsu programmas savienojumu ar Application Insights

1. Pierakstieties programmatūrā Power Apps.

2. Atveriet programmu rediģēšanai.

3. Kreisajā navigācijas koka skatā atlasiet programmas objektu un ielīmējiet savienojuma virkni no sava Application Insights resursa:

   

4. Saglabājiet un publicējiet savu lietotni.

5. Atskaņojiet publicēto lietotni un pārlūkojiet dažādus ekrānus.

Pārlūkojot lietotņu ekrānus, notikumi tiek automātiski reģistrēti Application Insights, tostarp lietošanas informācija, piemēram:

• Kur lietotnei var piekļūt no
• Kuras ierīces tiek izmantotas
• Izmantotie pārlūkprogrammu veidi

Notikumu skatīšana Application Insights

1. Pierakstieties Azure portālā un atveriet Application Insights iepriekš izveidoto resursu.

2. Ritiniet uz leju kreisajā navigācijas rūtī un sadaļā Lietojums atlasiet Lietotāji.

   Piezīmes

   Skatā Lietotāji tiek rādīta detalizēta informācija par lietotnes lietojumu, piemēram:

   • To lietotāju skaits, kuri skatījās lietotni
   • Lietotāju sesiju skaits
   • Reģistrēto notikumu skaits
   • Lietotāju operētājsistēmas un pārlūkprogrammas versijas informācija
   • Lietotāju reģions un atrašanās vieta

   Papildinformāciju par lietotājiem, sesijām un notikumu analīzi skatiet šeit Application Insights.

3. Atlasiet vienu no lietotāja sesijām, lai skatītu detalizētu informāciju. Varat redzēt tādu informāciju kā seansa ilgums un apmeklētie ekrāni.

   

4. Atlasiet skatu Notikumi kreisajā navigācijas rūtī sadaļā Lietojums . Varat skatīt visu programmas sesijās skatīto ekrānu kopsavilkumu:

   

Pielāgotu izsekošanas notikumu izveidošana

Varat rakstīt pielāgotas izsekošanas tieši Application Insights un sākt analizēt jūsu gadījumam specifisku informāciju. Izsekošanas funkcija ļauj apkopot:

• Detalizēta lietošanas informācija vadīklām ekrānos
• Kuri konkrētie lietotāji piekļūst jūsu lietotnei
• Kādas kļūdas rodas

Izsekošana var palīdzēt arī diagnosticēt problēmas, jo varat nosūtīt informācijas izsekošanu, kamēr lietotāji pārlūko jūsu programmu un veic dažādas darbības. Izsekot nosūtītajiem ziņojumiem, kuriem Application Insights ir viena no trim nopietnajām pakāpēm:

• Informācija
• Brīdinājums.
• Kļūda

Atkarībā no jūsu gadījuma varat izvēlēties, vai nosūtīt izsekošanas ziņojumu ar atbilstošu smaguma pakāpi. Varat vaicāt datus un veikt konkrētas darbības, pamatojoties uz to nopietnību.

Tagad izveidojiet jaunu komponentu savā lietotnē, lai apkopotu atsauksmes katrā ekrānā, un rakstiet notikumus uz Application Insights.

1. Pierakstieties programmatūrā Power Apps.

2. Kreisajā navigācijas rūtī atlasiet Lietojumprogrammas . Lietotņu sarakstā atlasiet lietotni Kudos un pēc tam atlasiet Rediģēt.

   Piezīmes

   Varat arī izveidot jaunu programmu vai rediģēt esošu lietojumprogrammu.

3. Koka skatā atlasiet opciju Komponenti:

   

4. Atlasiet Jauns komponents un pēc tam mainiet platuma lielumu uz 200 un augstumu uz 75:

   

5. Izvēlnē atlasiet Ievietot un pēc tam atlasiet Ikonas , lai pievienotu Emoji - Frown un Emoji - Smile:

   

6. Atlasiet Jauns pielāgots rekvizīts , lai izveidotu pielāgotu rekvizītu:

   

7. Ievadiet rekvizītu Nosaukums un parādāmais vārds , piemēram, FeedbackSceen.

8. Ievadiet rekvizītu Apraksts.

9. Atlasiet Rekvizīta tips kā ievade un datu tips kā ekrāns:

   

   Piezīmes

   Ievades rekvizīts ļauj tvert ekrāna nosaukumu un tā komponentu, lai jūs varētu reģistrēt šo informāciju Application Insights.

10. Koka skatā atlasiet komponentu, atlasiet Citas darbības (...) un pēc tam atlasiet Pārdēvēt , lai pārdēvētu komponentu ar jēgpilnu nosaukumu, piemēram, FeedbackComponent.

    

11. Atlasiet ikonas, atlasiet Citas darbības (...) un pēc tam atlasiet Pārdēvēt , lai pārdēvētu ikonas ar jēgpilniem nosaukumiem, piemēram , FrownIcon un SmileIcon.

12. Atlasiet FrownIcon, atlasiet rekvizītu OnSelect un pēc tam formulu joslā ievadiet šādu izteiksmi:

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

    

    Piezīmes

    Formulas izteiksme sūta lietotājvārdu,lietotāje-pastu,ekrānu un atsauksmi (ar vērtību-1 ) uz. Application Insights

13. Atlasiet SmileIcon, atlasiet rekvizītu OnSelect un pēc tam formulu joslā ievadiet šādu izteiksmi:

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

14. Pievienojiet komponentu vienam no jūsu programmas ekrāniem.

    

15. Atlasiet Saglabāt un pēc tam atlasiet Publicēt , lai saglabātu un publicētu savu lietotni.

16. Atskaņojiet publicēto programmu un no saviem ekrāniem nosūtiet sarauktas pieres un smaida atsauksmi.

    Svarīgi

    Jums jāatskaņo publicētā programma, lai nosūtītu notikumus uz Application Insights. Notikumi netiek nosūtīti uz Application Insights, ja priekšskatāt programmu Power Apps Studio.

    

Datu analīze Application Insights

Tagad varat sākt analizēt datus, ko nosūtījāt, izmantojot izsekošanas funkciju no savas lietotnes Application Insights.

1. Pierakstieties Azure portālā un atveriet iepriekš Application Insights izveidotoresursu:

   

2. Kreisajā navigācijas rūtī sadaļā Pārraudzība atlasiet Žurnāli:

   

3. Ievadiet tālāk norādīto vaicājumu un atlasiet Palaist , lai skatītu no programmas saņemtās atsauksmes.

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

   

4. Rezultātos atlasiet rindu un izvērsiet lauku customDimensions .

   Ekrāna , Lietotājvārda , UserEmail unFeedbackValue vērtības notikumam OnSelect jūsu komponentā ir smaida vai saraušanās ikona. Vērtības tiek ierakstītas arī katram notikumam, uz kuru Application Insights tiek nosūtīts , piemēram, appId, appName un appSessionId.

   

5. Izmantojot norādīto vaicājuma piemēru, varat paplašināt JSON pielāgoto dimensiju rekvizītus un projicēt kolonnas rezultātu skatā.

   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
   

   

   Padoms

   Žurnāla vaicājumi ir ārkārtīgi spēcīgi. Varat tos izmantot, lai apvienotu vairākas tabulas, apkopotu lielus datu apjomus un veiktu sarežģītas operācijas. Uzziniet vairāk par žurnāla vaicājumiem.

Nepārlaboto kļūdu pārraudzība (izmēģinājuma)

[Šī sadaļa satur pirmsizlaides dokumentāciju, un tā var tikt mainīta.]

Ne vienmēr varat paredzēt un plānot visas kļūdas, kas var rasties lietotnes darbības laikā. Neapstrādātas Power Fx formulas kļūdas lietotājiem tiek ziņotas kā reklāmkaroga ziņojumi. Par tiem var ziņot arī, lai Application Insights palīdzētu jums izprast to biežumu un nopietnību, nepaļaujoties uz to, ka lietotnes lietotāji ziņos par problēmām. Varat arī iestatīt reāllaika brīdinājumus , kad rodas izpildlaika kļūdas, lai izmantotu proaktīvāku pieeju.

Kļūdas iespējošana, ko nodot Application Insights

Jums ir jāiespējo iestatījums, kas ļauj Power Apps nodot neapstrādātas izpildlaika kļūdas pakalpojumā Azure Application Insights.

Lai iespējotu kļūdu nodošanu, dodieties uz Iestatījumi > Gaidāmie līdzekļi > Eksperimentāla > kļūdu nodošana pakalpojumam Azure, Application Insights vienlaikus saglabājot audekla programmu atvērtu rediģēšanai. Saglabājiet un publicējiet savu lietotni.

Kļūdu skatīšana Application Insights

Neapstrādātās Power Fx kļūdas, ar kurām lietotāji saskārušies lietotnes izpildlaikā, tiek ziņotas izsekošanas tabulā. Neapstrādātas kļūdas var identificēt un atšķirt no citiem kļūdu notikumiem ar notikuma ziņojumu "Neapstrādāta kļūda". Šo notikumu "severityLevel" dimensija ir 3 (TraceSeverity.Error).

Detalizēti kļūdu ziņojumi tiek sniegti pielāgotā rekvizīta "kļūdas" dimensijā. Situācijās, kad vienas un tās pašas operācijas laikā radās vairākas kļūdas, kļūdas tiek konsolidētas viena izsekošanas notikuma dimensijā "kļūdas". Kļūdu ziņojumi ir tādi paši, kā ziņots monitorā tiešraides atkļūdošanas sesijas laikā.

Tālāk sniegtajā piemērā vaicājums identificē neapstrādātas kļūdas un izvērš visus izsekošanas notikumā iekļautos kļūdu ziņojumus:

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

Korelācijas sekošana (izmēģinājuma)

[Šī sadaļa satur pirmsizlaides dokumentāciju, un tā var tikt mainīta.]

Savienojumi ar ārējiem datiem un pakalpojumiem ir pamatā lielākajai daļai programmu. Korelācijas izsekošana ģenerē un izplata konteksta informāciju, lai pievienotos sistēmas ģenerētiem žurnāliem audekla programmā un tās savienojumos, ievērojot noteiktus ierobežojumus. Piemēram, jūsu programma var ziņot par pielāgotu savienotāju, kas savukārt izsauc Azure funkciju vai citus REST API. Korelācijas izsekošana ļauj korelēt lietotnē veiktās darbības ar pamatā esošajiem API izsaukumiem dažādos līmeņos. Tas var būt noderīgi traucējummeklēšanā.

Kanvas lietotnes korelācijas izsekošana ir konteksta izsekošanas ieviešana un atbilst W3C specifikācijai.

Iespējot korelācijas izsekošanu

Lai iespējotu korelācijas izsekošanas līdzekli, dodieties uz Iestatījumi > Gaidāmie līdzekļi > Eksperimentāli > iespējojiet Azure Application Insights korelācijas izsekošanu , vienlaikus saglabājot audekla programmu atvērtu rediģēšanai. Saglabājiet un publicējiet savu lietotni.

Ierobežojumi

• Korelācijas izsekošana ir pieejama tikai pielāgotiem savienotājiem. Citi savienotāju tipi netiek atbalstīti.
• HTTP pieprasījumi tiek tverti Application Insights tikai tad, ja ir izveidots savienojums arī ar saistīto pakalpojumu Application Insights.

Korelācijas izsekošanas lietošana

Ja korelācijas izsekošana ir iespējota, tā pievieno jaunu sistēmas ģenerētu žurnāla notikumu audekla programmas instances atkarību Application Insights tabulā. Šis notikums tiek ierakstīts brīdī, kad tiek saņemta atbilde no tīkla zvana. Atkarības notikumi tver detalizētu informāciju par tīkla ziņojumu, tostarp pieprasījumu un atbilžu virsrakstiem, atbildes statusa kodu un ziņojuma ilgumu.

Ja arī pievienotais pakalpojums ir savienots Application Insights, pakalpojuma instances pieprasījumu tabulā tiek ģenerēts papildu sistēmas ģenerēts žurnāla notikums, kas tver pieprasījumu. Application Insights Dažus Azure pakalpojumus, piemēram, Azure funkcijas, var savienot bez kodēšanas no Azure portāla. Gan pamatnes programmu, gan vairākas programmas un saistītos pakalpojumus var savienot ar vienu un to pašu Application Insights instanci.

Tīkla zvanus atbalstītajiem savienotājiem var savienot ar citiem sistēmas ģenerētiem žurnāliem dimensijā "operation_Id". Tālāk sniegtajā vaicājuma piemērā ir redzams, ka tīkla zvans tiek veikts līdzās izsekošanas notikumiem, kas tiek emitēti programmas sesijas laikā.

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

Datu eksportēšana uz Power BI

Varat eksportēt savus Application Insights datus un vaicājumu rezultātus uz Power BI, lai veiktu analīzi un datu prezentāciju.

1. Pierakstieties Azure portālā un atveriet iepriekš Application Insights izveidotoresursu:

2. Kreisajā navigācijas rūtī sadaļā Pārraudzība atlasiet Žurnāli:

3. Žurnālu analīzes vaicājuma logā atlasiet izvēlni Eksportēt .

4. Atlasiet opciju Eksportēt uz Power BI (M vaicājums) , lai lejupielādētu vaicājuma Power BI failu:

   

5. Atveriet lejupielādēto failu teksta redaktorā un iekopējiet vaicājumu starpliktuvē.

6. Atvērtie: Power BI.

7. Sākuma lentē atlasiet izvēlni Iegūt datus un pēc tam atlasiet Tukšs vaicājums :

   

8. Vaicājuma logā atlasiet Papildu redaktors. Ielīmējiet vaicājumu logā, atlasiet Gatavs un pēc tam atlasiet Aizvērt un lietot:

   

Varat arī izveidot diagrammas un vizualizācijas Power BI, lai parādītu jūsu programmā saņemtās atsauksmes, kā arī pieņemtu uz datiem balstītus lēmumus un veiktu attiecīgas darbības.

Noklusējuma izsekošanas notikuma konteksts un dimensijas

Noklusējuma dimensiju kopa tiek pievienota arī rekvizītam customDimensions katrā izsekošanas notikumā. Šīs dimensijas var izmantot, lai identificētu programmu un programmas sesijas, kurās ir noticis šis notikums. Ja reģistrējat papildu pielāgotus datus, izmantojot izsekošanas funkciju, tie tiek rādīti arī pielāgotajās kategorijās.

Neatbalstīti scenāriji

Application Insights neatbalsta tālāk norādītos scenārijus.

• Bezsaistes atskaņotāja notikumi netiek tverti.
• Mobilās lietotnes (gan iOS Android un) notikumi netiek fiksēti, ja lietotnes darbība ir apturēta.