Analysera telemetrin för en arbetsyteappar med Application Insights

Du kan ansluta din app med Application Insights, en funktion i Azure Monitor. Application Insights innehåller kraftfulla verktyg för analys som hjälper dig att diagnostisera problem och för att förstå vad användarna faktiskt ska göra med din app.

När appen är ansluten till appinsikter kan du samla in information som hjälper dig att öka affärs besluten och förbättra kvaliteten på dina appar.

I den här snabbstarten ändrar du en arbetsyteapp som heter Kudos. På så sätt kan du utforska, upptäcka telemetridata och tillämpa dem på dina egna arbetsyteappar. Exempelappen Kudos ingår i en appsvit med medarbetarappar som kan laddas ned från Employee Experience Starter Kit.

Förutsättningar

Valfri

Skapa en Application Insights-resurs

Innan du kan skicka telemetri för en app måste du skapa en Application Insights-resurs för att lagra händelserna.

  1. Logga in på Azure-portal.

  2. Sök efter Application Insights:

    Application Insights.

  3. Skapa en Application Insights-resurs:

    Lägga till en Application Insights resurs.

  4. Ange lämpliga värden och välj Granska + skapa. Om du vill ha mer information kan du läsa skapa en Application Insights-resurs.

    Skapa en resurs.

  5. När Application Insights-instansen har skapats visas instansöversikten. Kopiera instrumentationsnyckel. Du behöver den här nyckeln för att konfigurera appen.

    Kopiera instrumentationsnyckel.

Anslut till din app till Application Insights

  1. Logga in på Power Apps.

  2. Välj Appar i det vänstra navigeringen. Från listan med appar, välj appen Kudos och välj sedan Redigera:

    Redigera Kudos-app.

    Anteckning

    Du kan också skapa en ny app eller redigera en befintlig app i stället.

  3. Välj App objektet från vänster navigeringsträd och klistra in instrumentationsnyckel:

    Lägg till instrumentationsnyckel.

  4. Spara och Publicera din app.

  5. Spela upp den publicerade appen och bläddra mellan olika skärmar.

När du bläddrar igenom olika skärmar loggas händelser automatiskt till Application Insights, inklusive information om användning, t.ex.:

  • Varifrån appen öppnas.
  • Vilka enheter som används.
  • De webbläsartyper som används.

Viktigt

Du måste spela upp den publicerade appen för att kunna skicka händelser till Application Insights. Händelser skickas inte till Application Insights när du förhandsgranskar appen i Power Apps Studio.

Visa händelser i Application Insights

  1. Logga in på Azure-portalen och öppna Application Insights-resursen du skapade tidigare.

  2. Bläddra nedåt i den vänstra navigeringsrutan och välj användare under avsnittet användning.

    Anteckning

    Vyn Användare visar användningsinformation om appen, t.ex.:

    • Antalet användare som visade appen.
    • Antal sessioner av användarna för appen.
    • Antal händelser som har loggats för appen.
    • Operativsystem och webbläsarens versionsdetaljer för användarna.
    • Användarens region och plats.

    Mer information finns Användare, sessioner och händelseanalyser i Application Insights.

  3. Välj en av användarsessionerna om du vill visa detaljerad information. Du kan visa information om t.ex. sessionens längd och vilka skärmar som besöks:

    Användningsinformation för användare.

  4. Välj vyn Händelser i den vänstra navigeringsrutan under avsnittet Användning. Du kan visa en översikt över alla skärmar som visas för alla programsessioner:

    Händelseinformation för appen.

Tips

Nedan beskrivs några ytterligare Application Insights-funktioner som du kan använda:

Skapa anpassade spårningshändelser

Du kan skriva anpassade spårningar direkt till Application Insights och starta för att analysera information som är specifik för ditt scenario. Spårning-funktionen kan du samla in:

  • Detaljerad användningsinformation för kontroller på bildskärmarna.
  • Vilka specifika användare som har åtkomst till din app.
  • Vilka fel som inträffar.

Spårningen kan också hjälpa dig att diagnosticera problem eftersom du kan skicka ett informationsmeddelande när användarna bläddrar igenom appen och utför olika åtgärder.

Det finns tre olika allvarlighetsgrader för spårningsmeddelanden när anpassad spårningsinformation skickas till Application Insights från appen:

  • Information
  • Varning!
  • Fel

Beroende på ditt scenario kan du välja att skicka ett spårningsmeddelande med rätt allvarlighetsgrad. Du kan fråga på data och utföra specifika åtgärder utifrån meddelandets allvarlighetsgrad.

Anteckning

Om du loggar någon personalinformation måste du fundera över alla uppgifter som krävs för att uppfylla kraven, t.ex. GDPR, som du kanske också behöver implementera.

Nu uppdaterar du appen och skapar en ny komponent för att inhämta feedback på varje skärm i appen. Du ska skriva händelserna till Application Insights.

  1. Logga in på Power Apps.

  2. Välj Appar i det vänstra navigeringen. Från listan med appar, välj appen Kudos och välj sedan Redigera.

    Anteckning

    Du kan också skapa en ny app eller redigera en befintlig app i stället.

  3. Markera alternativet Komponenter i trädvyn:

    Komponenter.

  4. Välj ny komponent och ändra sedan bredden till 200 och höjd till 75:

    Höjd och bredd.

  5. Välj Infoga på menyn och välj sedan ikoner för att lägga till Emoji - bister och Emoji - glad:

    Lägga till ikoner.

  6. Välj ny anpassad egenskap för att skapa en anpassad egenskap:

    Skapa anpassad egenskap.

  7. Ange Namn och Visningsnamn för egenskap, t.ex. FeedbackSceen.

  8. Ange egenskapen Beskrivning.

  9. Välj Egenskapstyp som Indata och Dattyp som Skärm:

    Anpassad egenskap.

    Anteckning

    Med inmatningsegenskap kan du samla in skärmnamnet och dess komponent så att du kan logga informationen på Application Insights.

  10. Markera komponenten i Trädvyn, välj Fler åtgärder (...) och sedan välja Byt namn om du vill byta namn på komponenten med ett beskrivande namn som FeedbackComponent.

    Byta namn på komponenter och ikoner.

  11. Markera ikonerna, välj Fler åtgärder (...) och välj sedan Byt namn om du vill byta namn på ikonerna med meningsfulla namn som FrownIcon och SmileIcon.

  12. Välj FrownIcon, välj egenskapen OnSelect och ange sedan följande uttryck i formelfältet:

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

    Bister ikonformel.

    Anteckning

    Formeluttrycket skickar UserName, UserEmail, Skärm och Feedback (med värdet -1) till Application Insights.

  13. Välj SmileIcon, välj egenskapen OnSelect och ange sedan följande uttryck i formelfältet:

    Trace(
       "App Feedback",
       TraceSeverity.Information,
           {
             UserName: User().FullName,
             UserEmail: User().Email,
             Screen: FeedbackComponent.FeedbackScreen.Name,
             FeebackValue: "1"
           }
         );
    Notify("Thanks for you feedback!");
    
  14. Lägg till komponenten till en av bildskärmarna i appen:

    Lägg till feedbackkomponent.

  15. Välj Spara och välj sedan Publicera för att spara och publicera appen.

  16. Spela upp den publicerade appen och skicka ett leende och en bister feedback från bildskärmarna.

    Viktigt

    Du måste spela upp den publicerade appen för att kunna skicka händelser till Application Insights. Händelser skickas inte till Application Insights när du förhandsgranskar appen i Power Apps Studio.

    Spela upp publicerad app.

Analysera data i Application Insights

Du kan nu börja analysera data som du har skickat med funktionen spåra från appen i Application Insights.

  1. Logga in på Azure-portalen och öppna Application Insights-resursen du skapade tidigare:

    Markera Application Insights.

  2. Välj loggar under övervakning från den vänstra navigeringsrutan:

    Välj loggar.

  3. Ange följande fråga och välj Kör. Den feedback som togs emot från appen returneras:

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

    Visa appfeedback.

  4. Markera en rad i resultatet och expandera fältet customDimensions.

    Värdena för Skärm, UserName, UserEmail och FeedbackValue för händelsen OnSelect av leende eller bistra ikonen i komponenten har registrerats.
    Det finns också några ytterligare värden som registreras för varje händelse som skickas till Application Insights, t.ex. appId, appName och appSessionId.

    Visa anpassade dimensioner.

  5. Med följande exempel fråga kan du utöka egenskaperna för de anpassade JSON-dimensionerna och projicera kolumnerna i resultatvyn.

    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
    

    Utöka customDimensions-fråga.

    Tips

    Loggfrågor är mycket kraftfulla. Du kan använda dem för att koppla ihop flera tabeller, samla stora mängder data och utföra komplicerade åtgärder. Mer information finns i Loggfrågor.

Exportera data till Power BI

Du kan exportera Application Insights-data och frågeresultat till Power BI för analys och datapresentation.

  1. Logga in på Azure-portalen och öppna Application Insights-resursen du skapade tidigare:

  2. Välj loggar under övervakning från den vänstra navigeringsrutan:

  3. Från frågefönstret logganalys, välj listrutan Exportera.

  4. Markera alternativet Exportera till Power BI (M fråga). Då hämtas en Power BI frågefil till datorn:

    Exportera Power BI fråga.

  5. Öppna den hämtade filen i en textredigerare och kopiera frågan till urklipp.

  6. Öppna Power BI.

  7. Välj listrutan Skaffa data i menyfliksområdet Start och välj sedan Tom fråga:

    Power BI tom fråga.

  8. Välj i frågefönstret Avancerad redigerare. Klistra in frågan från steg 5 i fönstret, välj klart och välj sedan Stäng och tillämpa:

    Power BI avancerad fråga.

  9. Du kan även skapa diagram och visualiseringar i Power BI för att representera feedback som tas emot i appen och att fatta databaserade beslut och åtgärder.

    Diagram och visualiseringar.

Standardkontext och dimensioner för spårningshändelser

En uppsättning standarddimensioner läggs också till i egenskapen customDimensions för varje spårningshändelse. De här dimensionerna kan användas för att identifiera appen och appsessionerna som händelserna inträffade i. Om du loggar ytterligare anpassade data med hjälp av funktionen spårningsvisas även de i de anpassade dimensionerna.

Dimensionsnamn Representerar
ms-appId App-ID för appen som skickade händelsen.
ms-appName Appnamn för namn för appen som skickade händelsen.
ms-appSessionId Appversionen-ID.

Scenarier som inte stöds

App Insights stöder inte följande scenarier.

  • Offline- och mobilappar/spelarhändelser (både Android och iOS) fångas inte in.
  • Nätverksförfrågningar och fel fångas inte in.
  • GCC- och icke-offentliga moln stöds inte.