Järjestelmän luomien lokien analysointi Application Insightsin avulla

Pohjaan perustuvat sovellukset voidaan yhdistää Application Insightsiin, joka on Azure Monitorin ominaisuus. Application Insights sisältää tehokkaita analytiikkatyökaluja, joiden avulla voi diagnosoida ongelmia ja hahmottaa, mitä käyttäjät sovelluksilla tekevät. Kerättyjen tietojen avulla voidaan tehdä parempia päätöksiä liiketoiminnassa ja parantaa sovellusten laatua.

Tässä pika-aloituksessa perehdytään järjestelmän pohjaan perustuvissa sovelluksissa luomien lokeihin käsitteisiin Kudos-nimisen pohjaan perustuvan sovelluksen avulla sekä käytetään näitä käsitteitä sovelluksissa. Kudos-mallisovellus on osa työntekijöiden aktivointia lisäävää ohjelmistopakettia, jonka voi ladata Employee Experience Starter Kit -sivulta.

edellytykset

• Sinulla on oltava pääsy Azure-portaaliin.
• Sinulla on oltava oikeudet luoda Azure-resursseja.

Huomautus

Vuokraajan järjestelmänvalvojan on otettava pohjaan perustuvan sovelluksen tiedot käyttöön, jotta hän voi tarkastella telemetriatietoja. Kirjaudu järjestelmänvalvojana Power Platform -hallintakeskuksessa. Siirry kohtaan Asetukset > vuokraajanasetukset > pohjaan perustuvan sovelluksen tiedot. Määritä pohjaan perustuvan sovelluksen tiedot -ruudussa valinnaksi Käytössä ja tallenna muutokset. Lue lisätietoja kohdasta Vuokraajan asetukset.

Valinnainen

• Kudos-sovellus ladataan ja asennetaan Employee Experience Starter Kit -sivulta. Voit käyttää sen sijaan myös aiemmin luotua sovellusta.

Application Insights -resurssin luominen

Ennen kuin sovelluksesta voidaan lähettää järjestelmän luomia lokeja, tapahtumien tallentamista varten on luotava Application Insights -resurssi.

1. Kirjaudu  Azure-portaaliin.

2. Tee haku Application Insights.

   

3. Luo Application Insights -resurssi:

   

4. Kirjoita tarvittavat arvot ja valitse sitten Tarkista + luo.

   Lisätietoja on aiheessa Application Insights -resurssin luominen.

   

5. Kun Application Insights -esiintymä on luotu, kopioi Instrumentointiavain-esiintymän yleiskatsauksessa, sillä sitä käytetään myöhemmässä vaiheessa.

   

Sovelluksen yhdistäminen Application Insightsiin

Huomautus

• Kun määrität instrumentointiavaimen, huomaa, että tiedot voidaan lähettää eri vuokraajille. Seurantatapahtumat lähetetään App Insights -resurssiin, joka vastaa sovelluksessa määritettyä instrumentointiavainta, vaikka App Insights -esiintymä olisikin eri vuokraajassa kuin sovellus.
• Ole varovainen, kun tuot aiemmin luotuja .msapp-tiedostoja, koska App Insightsin instrumentointiavaimia voi olla olemassa. Avaa sovellus tuonnin jälkeen manuaalisesti sen tarkistamiseksi, että käytössä on oikea App Insights -instrumentointiavain.

1. Kirjaudu Power Appsiin.

2. Valitse vasemmassa siirtymisruudussa Sovellukset. Valitse sovellusluettelosta Kudos-sovellus ja valitse sitten Muokkaa:

   

   Huomautus

   Voit myös luoda uuden sovelluksen tai muokata aiemmin luotua sovellusta.

3. Valitse Sovellus-objekti vasemmasta siirtymisen puunäkymästä ja liitä Instrumentointiavain:

   

4. Tallenna ja Julkaise sovelluksesi.

5. Toista julkaistu sovellus ja selaile näyttöjä.

Kun sovelluksen näyttöjä selataan, tapahtumat kirjataan automaattisesti Application Insightsiin. Esimerkiksi seuraavat käyttötiedot kirjataan:

• Sovelluksen käyttöpaikka
• Käytettävät laitteet
• Käytetyt selaintyypit

Tärkeä

Sinun täytyy toistaa julkaistu sovellus, jotta voit lähettää tapahtumia Application Insightsiin. Tapahtumia ei lähetetä Application Insightsiin, kun esikatselet sovellusta Power Apps Studiossa.

Tapahtumien tarkastelu Application Insightsissa

1. Kirjaudu  Azure-portaaliin ja avaa aiemmin luomasi Application Insights -resurssi.

2. Vieritä vasemmanpuoleisessa siirtymisruutua alaspäin ja valitse Käyttäjät Käyttö-osassa.

   Huomautus

   Käyttäjät-näkymässä on esimerkiksi seuraavat sovelluksen käyttötiedot:

   • Sovellusta tarkastelleiden käyttäjien määrä
   • Käyttäjäistuntojen määrä
   • Kirjattujen tapahtumien määrä
   • Käyttäjien käyttöjärjestelmän ja selaimen versiotiedot
   • Käyttäjien alue ja sijainti

   Lisätietoja Application Insightsin käyttäjistä, istunnoista ja tapahtuma-analyyseista.

3. Voit porautua tiettyihin tietoihin valitsemalla jonkin käyttäjäistunnoista. Voit nähdä tietoja, kuten istunnon pituuden ja avatut näytöt:

   

4. Valitse vasemman siirtymisruudun Käyttö-osassa Tapahtumat-näkymä. Näet yhteenvedon kaikista eri sovellusistunnoissa tarkastelluista näkymistä:

   

Vihje

Myös muita Application Insights -ominaisuuksia on käytettävissä:

• Suppilot
• Kohortit
• Vaikutusanalyysi
• Säilytysanalyysi
• Käyttövirrat

Mukautettujen jäljitystapahtumien luominen

Voit kirjoittaa mukautettuja jäljityksiä suoraan Application Insightsiin ja alkaa analysoida tilannettasi koskevia tietoja. Jäljitä-toiminnon avulla voi kerätä seuraavia tietoja:

• Yksityiskohtaiset käyttötiedot näyttöjen ohjausobjektien käytöstä
• Käyttäjät, jotka käyttävät sovellusta
• Esiintyvät virheet

Jäljitys voi myös auttaa ongelmien diagnosoinnissa, koska voit lähettää tietojäljen, kun käyttäjät selaavat sovellustasi ja suorittavat eri toimintoja. Application Insightsiin lähettävillä jäljityssanomilla on kolme vakavuusastetta:

• Tietoja
• Varoitus
• Error

Skenaarion mukaan voit lähettää jäljitysviestin asianmukaisella vakavuusasteella. Voit tehdä kyselyjä tiedoista ja suorittaa tiettyjä toimintoja vakavuusasteen perusteella.

Huomautus

Jos lokiin kirjataan henkilökohtaisia tietoja, tietosuojalainsäädäntöön ja -määräyksiin pidettävät velvoitteet on otettava huomioon. Lisätietoja on Microsoftin luottamuskeskuksessa ja Service Trust Portalissa.

Seuraavaksi sovelluksessa luodaan uusi osa, jolla kerätään palautetta kussakin näytössä ja jolla tapahtumat kirjoitetaan Application Insightsiin.

1. Kirjaudu Power Appsiin.

2. Valitse vasemmassa siirtymisruudussa Sovellukset. Valitse sovellusluettelosta Kudos-sovellus ja valitse sitten Muokkaa.

   Huomautus

   Myös uusi sovellus voidaan luoda tai aiemmin luotua sovellusta voidaan muokata.

3. Valitse Komponentit kohdasta Puunäkymä:

   

4. Valitse Uusi komponentti ja muuta leveydeksi 200 ja korkeudeksi 75:

   

5. Valitse valikosta Lisää ja valitse sitten Kuvakkeet, jotta voit lisätä emojit Emoji – otsan rypistys ja Emoji – hymy:

   

6. Luo mukautettu ominaisuus valitsemalla Uusi mukautettu ominaisuus:

   

7. Anna ominaisuudelle Name ja Näyttönimi, kuten FeedbackSceen.

8. Anna ominaisuudelle Kuvaus.

9. Valitse Ominaisuustyyppi-kohdan arvoksi Syöte ja Tietotyyppi-kohdan arvoksi Screen:

   

   Huomautus

   Syöteominaisuuden avulla voit siepata näyttönimen ja sen komponentin, jotta voit kirjata nämä tiedot Application Insightsiin.

10. Anna komponentille merkityksellinen nimi, kuten FeedbackComponent, valitsemalla ensin osa puunäkymässä, sitten Lisää toimintoja (…) ja lopuksi Nimeä uudelleen.

    

11. Anna kuvakkeille merkityksellisiä nimiä, kuten FrownIcon ja SmileIcon valitsemalla ensin kuvakkeet, sitten Lisää toimintoja (…) ja lopuksi Nimeä uudelleen.

12. Valitse FrownIcon, sitten OnSelect-ominaisuus ja syötä sitten kaavariville seuraava lauseke:

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

    

    Huomautus

    Kaavan lauseke lähettää arvot UserName, UserEmail, Screen ja Palaute (arvolla -1) Application Insightsiin.

13. Valitse SmileIcon, sitten OnSelect-ominaisuus ja syötä sitten kaavariville seuraava lauseke:

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

14. Lisää komponentti johonkin sovelluksesi näytöistä:

    

15. Tallenna ja julkaise sovelluksesi valitsemalla Tallenna ja sitten Julkaise.

16. Repeat julkaistu sovellus ja lähetä hymy- ja otsanrypistyspalaute näytöiltäsi.

    Tärkeä

    Sinun täytyy toistaa julkaistu sovellus, jotta voit lähettää tapahtumia Application Insightsiin. Tapahtumia ei lähetetä Application Insightsiin, kun esikatselet sovellusta Power Apps Studiossa.

    

Tietojen analysointi Application Insightsissa

Nyt voit alkaa analysoida lähettämiäsi tietoja käyttämällä sovelluksesi Jäljitä-toimintoa Application Insightsissa.

1. Kirjaudu Azure-portaaliin ja avaa aiemmin luomasi Application Insights -resurssi:

   

2. Valitse vasemman siirtymisruudun Seuranta-kohdassa Lokit:

   

3. Syötä seuraava kysely ja tarkastele sovelluksesta saatavaa palautetta valitsemalla Suorita:

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

   

4. Valitse tulosrivi ja laajenna customDimensions-kenttää.

   Komponenttisi hymy- tai ryppyotsakuvakkeen OnSelect-tapahtuman arvot Screen, UserName, UserEmail ja FeedbackValue on tallennettu. Kunkin Application Insightsiin lähetettävän tapahtuman osalta kirjataan myös arvot, kuten appId, appName ja appSessionId.

   

5. Seuraavassa esimerkkikyselyssä voit laajentaa mukautettujen JSON-dimensioiden ominaisuuksia ja projisoida sarakkeet tulosnäkymään.

   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
   

   

   Vihje

   Lokikyselytovat erittäin tehokkaita. Niiden avulla voit liittää yhteen useita taulukoita, koota suuria tietomääriä ja suorittaa monimutkaisia toimintoja. Lisätietoja lokikyselyistä.

Käsittelemättömien virheiden valvonta (kokeellinen)

[Tämä osio sisältää julkaisua edeltävää materiaalia ja voi muuttua.]

Tärkeä

• Tämä on kokeellinen ominaisuus.
• Kokeiluversion ominaisuuksia ei ole tarkoitettu tuotantokäyttöön, ja niiden toiminnallisuus voi olla rajoitettu. Nämä toiminnot ovat käytettävissä ennen virallista julkaisua, jotta asiakkaat voivat käyttää niiden ennakkojulkaisua ja antaa palautetta.

Aina ei ole mahdollista ennakoida kaikkia sovelluksen suorituksen aikana esiintymiä virheitä, joten niihin ei voi myöskään varautua. Käsittelemättömät Power Fx -kaavavirheet ilmoitetaan käyttäjillä ilmoituspalkin sanomina. Ne voidaan raportoida myös Application Insightsiin, mikä auttaa hahmottamaan niiden toistuvuuden ja vakavuusasteen ilman, että olisi nojauduttava käyttäjien ilmoittamiin ongelmiin. Lisäksi voidaan määrittää reaaliaikaiset ilmoitukset suorituksen aikana tapahtuvista virheistä, mikä mahdollistaa ennakoivamman toiminnan.

Virheiden välittämisen Application Insightsiin ottaminen käyttöön

Asetus, joka antaa Power Appsille mahdollisuuden siirtää käsittelemättömät suorituksenaikaiset virheet Azure Application Insightsiin, on otettava käyttöön.

Varoitus

Tämän asetuksen ottaminen käyttöön voi aiheuttaa Application Insights -lokien säilyttämiseen liittyviä lisäkustannuksia.

Jos haluat ottaa virheiden välittämisen käyttöön, siirry kohtaan Asetukset > Tulevat ominaisuudet > Kokeellinen > Siirrä virheet Azure Application Insightsiin samalla, kun pidät pohjaan perustuvan sovelluksen avoinna muokkaamista varten. Tallenna ja julkaise sovelluksesi.

Virhetapahtumat Application Insightsissa

Käyttäjien suorituksen aikana havaitsemat käsittelemättömät Power Fx -virheet raportoidaan jäljitykset-taulukkoon. Käsittelemättömät virheet voidaan tunnistaa ja erottaa muista virhetapahtumista Käsittelemätön virhe -tapahtumasanoman avulla. Näiden tapahtumien severityLevel-dimensio on 3 (TraceSeverity.Error).

Yksityiskohtaiset virhesanomat sisältyvät customDimension-ominaisuuden "errors"-dimensioon. Tilanteissa, joissa samassa toiminnossa esiintyy useita virheitä, tapahtumat konsolidoidaan yhden jäljitystapahtuman errors-dimensioon. Virhesanomat ovat samat kuin Monitorissa live-virheenkorjausistunnon aikana ilmoitetut virhesanomat.

Seuraava esimerkkikysely tunnistaa käsittelemättömät virheet ja laajentaa kaikki jäljitystapahtumaan sisällytetyt virhesanomat:

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

Korrelointiseuranta (kokeellinen)

[Tämä osio sisältää julkaisua edeltävää materiaalia ja voi muuttua.]

Tärkeä

• Tämä on kokeellinen ominaisuus.
• Kokeiluversion ominaisuuksia ei ole tarkoitettu tuotantokäyttöön, ja niiden toiminnallisuus voi olla rajoitettu. Nämä toiminnot ovat käytettävissä ennen virallista julkaisua, jotta asiakkaat voivat käyttää niiden ennakkojulkaisua ja antaa palautetta.

Yhteydet ulkoisiin tietoihin ja palveluihin ovat välttämättömiä useimmille sovelluksille. Korrelointiseuranta luo ja levittää kontekstitiedot järjestelmän luomiin pohjaan perustuvan sovelluksen ja sen yhteyksien lokeihin liitettäväksi. Tässä on kuitenkin tiettyjä rajoituksia. Sovelluksesi voi esimerkiksi kutsua mukautettua yhdistintä, joka puolestaan kutsuu Azure-funktiota tai REST API -ohjelmointirajapintaa. Korrelaatioseuranta mahdollistaa niiden toimintojen korreloinnin, jotka on otettu sovelluksessa ja sen taustalla olevan ohjelmointirajapinnan kaikkien tasojen kutsuista. Tämä voi olla hyödyksi vianmäärityksessä.

Pohjaan perustuvan sovelluksen korrelaatioseuranta toteutetaan kontekstiseurantana ja noudattaa W3C-määrityksiä.

Korrelointiseurannan ottaminen käyttöön

Varoitus

Tämän asetuksen ottaminen käyttöön voi aiheuttaa Application Insights -lokien säilyttämiseen liittyviä lisäkustannuksia.

Voit ottaa korrelointiseurannan ominaisuuden käyttöön valitsemalla Asetukset > Tulevat ominaisuudet > Kokeellinen > Ota Azure Application Insights -korrelointiseuranta käyttöön samalla, kun pidät pohjaan perustuvan sovelluksesi avoinna muokkaamista varten. Tallenna ja julkaise sovelluksesi.

Rajoitukset

• Korrelointiseuranta on käytettävissä vain mukautetuissa yhdistimissä. Muita yhdistintyyppejä ei tueta.
• HTTP-pyynnöt siepataan Application Insightsiin vain, jos yhdistetty palvelu on yhdistetty myös Application Insightsiin.

Korrelointiseurannan käyttäminen

Käyttöönotettuna korrelaatioseuranta lisää uuden järjestelmän luoman lokitapahtuman pohjaan perustuvan sovelluksen Application Insights -esiintymän dependencies-taulukkoon. Tämä tapahtuma kirjataan sillä hetkellä, kun verkkokutsun vastaus vastaanotetaan. Riippuvuustapahtumat sieppaavat verkkokutsun tiedot, kuten pyynnön ja vastauksen otsikot, vastauksen tilakoodin ja kutsun keston.

Jos yhdistetty palvelu on yhdistetty myös Application Insightsiin, pyynnön sieppaava järjestelmän luoma lisälokitapahtuma luodaan palvelun Application Insights -esiintymään requests-taulukossa. Jotkin Azure-palvelut, kuten Azure-funktiot, voidaan yhdistää ilman Azure-portaalin koodausta. Sekä pohjaan perustuva sovellus tai useat sovellukset että yhdistetyt palvelut voidaan yhdistää samaan Application Insights -esiintymään.

Tuettujen yhdistimien verkkokutsut voidaan liittää muihin järjestelmän luomiin lokeihin operation_Id-dimensiossa. Seuraavassa esimerkkikyselyssä on verkkokutsu, joka tehdään sovellusistunnon aikana lähetettyjen jäljitystapahtumien ohella.

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

Tietojen vieminen Power BI:hin

Voit viedä Application Insights -tietosi ja kyselytuloksesi Power BI:hin analysointia ja tietojen esittämistä varten.

1. Kirjaudu Azure-portaaliin ja avaa aiemmin luomasi Application Insights -resurssi:

2. Valitse vasemman siirtymisruudun Seuranta-kohdassa Lokit:

3. Valitse analytiikan kyselyikkunasta Vie-valikko.

4. Lataa Power BI -kyselytiedosto valitsemalla Vie Power BI:hin (M-kysely) -vaihtoehto:

   

5. Avaa ladattu tiedosto Tekstinmuokkausohjelmassa ja kopioi kysely leikepöydälle.

6. Avaa Power BI.

7. Valitse Koti-valintanauhasta Hae tietoja -valikko ja valitse sitten Tyhjä kysely:

   

8. Valitse kyselyikkunassa Laajennettu editori. Liitä kysely ikkunaan, valitse Valmis ja valitse sitten Sulje ja käytä:

   

Voit myös luoda kaavioita ja visualisointeja Power BI:ssä edustamaan sovelluksessasi saatua palautetta tai tehdä tietoihin perustuvia päätöksiä ja toimenpiteitä.

Oletusjäljitystapahtuman kontekst ja dimensiot

Kunkin Jäljitä-tapahtuman customDimensions-ominaisuuteen liitetään myös joukko oletusdimensioita. Näiden dimensioiden avulla voidaan määrittää se sovellus ja sovelluksen istunnot, jossa tapahtumat tapahtuivat. Jos ylimääräisiä mukautettuja tietoja kirjataan lokiin jäljitystoiminnon avulla, ne tulevat näkyviin myös mukautetuissa dimensioissa.

Dimension nimi	Edustaa
ms-appId	Tapahtuman lähettäneen sovelluksen sovellustunnus.
ms-appname	Tapahtuman lähettäneen sovelluksen nimi.
ms-appSessionId	Sovelluksen istuntotunnus. Tätä arvoa ei ehkä voi täyttää joissakin skenaarioissa. Kun tämä arvo on käytettävissä, se korvaa Application Insightsin sessionID-vakiodimension.
ms-tenantID	Sen vuokraajan yksilöllinen tunniste, jossa sovellus julkaistaan.
ms-environmentId	Sen ympäristön nimi, jossa sovellus julkaistaan.
userId	Istuntoon liitetyn käyttäjän yksilöivä tunniste.
ms-duration	Laskennallinen arvo, joka mittaa käyttäjän siirtymisaikaa näytöstä toiseen. Tämä arvo korvaa Application Insightsin vakiomuotoisen PageView-kestodimension.
sessionId	Istuntotunnus, jonka avulla voidaan korreloida kaikki yksittäiseen sovellusistuntoon liittyvät tapahtumat. Tämä arvo on aina olemassa, ja sitä suositellaan yksilöivän istuntomäärän hahmottamiseen. Tämä arvo otetaan pelaajan istuntotunnuksesta, ja se näkyy, kun tarkastelet istunnon tietoja sovellusta toistettaessa. Istunnon tunnus voi joskus saada oletusarvoisen, satunnaisen ja yksilöllisen Application Insightsilla luodun arvon. Tämä oletusarvo ei ole luotettava eikä se korreloi sovelluskohtaisien parametrien kanssa.
Kesto	Laskennallinen arvo, joka mittaa käyttäjän siirtymisaikaa näytöstä toiseen. Tämä arvo on sama kuin ms-kestodimension ilmoittama kesto.
ms-isTest	Osoittaa, liittyykö istunto Test Studio -testisuoritukseen.
ms-currentScreenName	Sen sivun nimi, josta käyttäjä on siirtymässä (esillä sivusiirtymistapahtumissa).
ms-targetScreenName	Sen sivun nimi, johon käyttäjä on siirtymässä (esillä sivusiirtymistapahtumissa).

Skenaariot, joita ei tueta

Application Insights ei tue seuraavia skenaarioita.

• Offline-pelaajien tapahtumia ei tallenneta
• Mobiilisovelluksen (sekä iOS että Android) tapahtumia ei tallenneta, kun sovellus on keskeytetty.
• GCC:tä ja muita kuin julkisia pilviä ei tueta.

Huomautus

Voitko kertoa meille dokumentaatiota koskevan kielimäärityksesi? Vastaa lyhyeen kyselyyn. (Huomaa, että tämä kysely on englanninkielinen.)

Kyselyyn vastaaminen kestää noin seitsemän minuuttia. Henkilökohtaisia tietoja ei kerätä (tietosuojatiedot).