Analysera systemgenererade loggar med Application Insights

Du kan ansluta din arbetsyteappar till 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 dina appar. Du kan samla in information som hjälper dig att fatta bättre affärsbeslut och förbättra kvaliteten på dina appar.

I den här snabbstarten använder vi appen Kudos för att utforska begreppen systemgenererade loggar i appar och tillämpa dem på dina appar. Exempelappen Kudos ingår i en appsvit med medarbetarappar som kan laddas ned från Employee Experience Starter Kit.

Förutsättningar

• Du måste ha åtkomst till Azure-portalen.
• Du måste ha behörighet för att skapa Azure-resurser.

Valfri

• Hämta och installera appen Kudos från Employee Experience Starter Kit. Du kan också använda en befintlig app istället.

Skapa en Application Insights-resurs

Innan du kan skicka systemgenererade loggar från 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:

   

3. Skapa 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.

   

5. När Application Insights instansen har skapats kopierar du instrumenteringsnyckeln i instansöversikten för användning i ett kommande steg.

   

Anslut till din app till Application Insights

1. Logga in på Power Apps.

2. Välj Appar i vänstra navigeringsfönstret. 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. Välj App objektet från vänster navigeringsträd och klistra in 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 appens skärmar loggas händelser automatiskt till Application Insights, inklusive information om användning, t.ex.:

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

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 användarsessioner
   • Antal loggade händelser
   • Användares operativsystem och webbläsarens versionsdetaljer
   • Användarens region och plats

   Läs mer om 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:

   

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:

   

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. Spårningsmeddelanden som skickas Application Insights med någon av tre allvarlighetsgrader:

• Information
• Varning
• Error

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 allvarlighetsgrad.

Skapa nu en ny komponent i appen för att inhämta feedback på varje skärm och skriva händelser till Application Insights.

1. Logga in på Power Apps.

2. Välj Appar i vänstra navigeringsfönstret. 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:

   

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

   

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

   

6. Välj ny anpassad egenskap för att skapa en 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:

   

   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.

    

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 your feedback!");
    

    

    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 your feedback!");
    

14. Lägg till komponenten till en av bildskärmarna i appen:

    

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.

    

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:

   

2. Välj loggar under övervakning i den vänstra navigeringsrutan:

   

3. Skriv följande fråga och välj Kör för att visa den feedback som fått från appen:

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

   

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. Värden registreras också för varje händelse som skickas till Application Insights, t.ex. appId, appName och appSessionId.

   

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
   

   

   Dricks

   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. Läs mer om loggfrågor.

Övervaka ohanterade fel (experimentellt)

[Det här avsnittet är en förhandsversion av dokumentationen och kan ändras.]

Du kan inte alltid förutse och planera för alla fel som kan inträffa när appen körs. Ohanterade Power Fx formelfel rapporteras till användare som banderollmeddelanden. De kan också rapporteras till Application Insights för att hjälpa dig att förstå hur ofta och hur de fungerar utan att appens användare behöver rapportera problem. Du kan också ställa in realtidsaviseringar när körningsfel inträffar för att agera mer proaktivt.

Aktivera felpassning till Application Insights

Du måste aktivera inställningen som tillåter att Power Apps skickar ohanterade körningsfel till Azure Application Insights.

För att aktivera skicka fel, gå till Inställningar > Kommande funktioner > Experimentella > Skicka fel till Azure Application Insightssamtidigt som du håller din arbetsyteapp öppen för redigering. Spara och publicera din app.

Felhändelser i Application Insights

Ohanterade Power Fx fel som användarna upplever vid appkörningen rapporteras till tabellen spårning . Ohanterade fel kan identifieras och särskiljas från andra felhändelser av händelsemeddelandet "Ohanterat fel". Dimensionen "severityLevel" av dessa händelser är 3 (TraceSeverity.Error).

Detaljerade felmeddelanden finns i dimensionen "fel" i egenskapen customDimension. I situationer där flera fel inträffade under samma åtgärd konsolideras felen i "fel" för en enskild spårningshändelse. Felmeddelandena är desamma som de som rapporterades i Övervaka under en live felsökningssession.

I följande exempelfråga identifieras ohanterade fel och alla felmeddelanden som ingår i spårningshändelsen visas:

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

Korrelationsspårning (experimentell)

[Det här avsnittet är en förhandsversion av dokumentationen och kan ändras.]

Anslutningar till externa data och tjänster är grundläggande för de flesta appar. Korrelationsspårning genererar och sprider kontextinformation för att ansluta systemgenererade loggar över en canvas-app och dess anslutningar, med förbehåll för vissa begränsningar. Som ett exempel kan appen anropa en anpassad anslutning som i sin tur anropar en Azure-funktion eller en annan REST-API. Med hjälp av korrelationsspårning kan du korrelera åtgärder som vidtas i appen med de underliggande API-anropen på olika nivåer. Detta kan vara användbart vid felsökning.

Korrelationsspårning i arbetsyteapp är en implementering av kontextspårning och följer W3C-specifikationen.

Aktivera korrelationsspårning

För att aktivera funktionen korrelationsspårning, gå till Inställningar > Kommande funktioner > Experimentell > Aktivera Azure Application Insights korrelationsspårning medan du håller din arbetsyteapp öppen för redigering. Spara och publicera din app.

Begränsningar

• Korrelationsspårning är endast tillgänglig för anpassade anslutningsprogram. Andra anslutningstyper stöds inte.
• HTTP-förfrågningar tas endast in i Application Insights om den anslutna tjänsten också är ansluten till Application Insights.

Använda korrelationsspårning

När funktionen är aktiverad läggs en ny systemgenererad logghändelse till i tabellen beroenden för arbetsyteappens Application Insights-instans. Händelsen registreras när ett svar från ett nätverkssamtal tas emot. Beroendehändelser samlar in information om nätverkssamtalet, inklusive begärans- och svarshuvuden, svarsstatuskod och varaktighet för samtalet.

Om den anslutna tjänsten också är ansluten till Application Insights skapas en ytterligare systemgenererad logghändelse som samlar in förfrågan i begäranstabellen i tjänstens Application Insights-instans. Vissa Azure-tjänster, som Azure Functions, kan anslutas utan programmering från Azure-portalen. Både arbetsyteappar och anslutna tjänster kan anslutas till samma Application Insights instans.

Nätverksanrop för anslutningar som stöds kan kopplas samman med andra systemgenererade loggar på dimensionen "operation_Id". Följande exempelfråga visar ett nätverkssamtal som görs tillsammans med spårningshändelser som spåras under en appsession.

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

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 i den vänstra navigeringsrutan:

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

4. Välj alternativet Exportera till Power BI (M-fråga) om du vill hämta en Power BI frågefil:

   

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

6. Öppna Power BI.

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

   

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

   

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.

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årning visas även de i de anpassade dimensionerna.

Scenarier som inte stöds

Application Insights stöder inte följande scenarier.

• Offline spelarhändelser registreras inte.
• Mobilapp händelser (både iOS och Android) registreras inte in när appen är pausad.
• GCC- och icke-offentliga moln stöds inte.