Analitzar els registres generats pel sistema mitjançant Application Insights

Podeu connectar les vostres aplicacions de llenç a Application Insights, una característica de l'Azure Monitor. Application Insights Inclou eines d'anàlisi potents per ajudar-vos a diagnosticar problemes i entendre què fan realment els usuaris amb les vostres aplicacions. Pots recopilar informació per ajudar-te a prendre millors decisions empresarials i millorar la qualitat de les teves aplicacions.

Requisits previs

• Heu de tenir accés al portal de l'Azure.
• Heu de tenir els permisos per crear recursos del'Azure.

Crear un recurs de l'Application Insights

Per poder enviar registres generats pel sistema des d'una aplicació, heu de crear un Application Insights recurs per emmagatzemar els esdeveniments.

Creeu un recurs basat en l'àrea de treball al Application Insights portal de l'Azure.

Connectar l'aplicació a l'Application Insights

1. Inicieu la sessió a Power Apps.

2. Obriu una aplicació per editar-la.

3. Seleccioneu l'objecte App a la visualització d'arbre de navegació esquerra i enganxeu la cadena de connexió del vostre Application Insights recurs:

   

4. Desa i publica l'aplicació.

5. Reprodueix l'app publicada i navega per les diferents pantalles.

A mesura que navegueu per les pantalles de l'aplicació, els esdeveniments es registren Application Insights automàticament, inclosos els detalls d'ús com ara:

• Des d'on s'accedeix a l'aplicació
• Quins dispositius s'utilitzen
• Els tipus de navegador utilitzats

Visualitzar esdeveniments a l'Application Insights

1. Inicieu la sessió al portal de l'Azure i obriu el recurs que heu Application Insights creat anteriorment .

2. Desplaceu-vos cap avall a la subfinestra de navegació esquerra i seleccioneu Usuaris a la secció Ús .

   Nota

   La visualització Usuaris mostra els detalls d'ús de l'aplicació, com ara:

   • Nombre d'usuaris que han vist l'aplicació
   • Nombre de sessions d'usuari
   • Nombre d'esdeveniments registrats
   • Sistemes operatius dels usuaris i detalls de la versió del navegador
   • Districte i ubicació dels usuaris

   Obteniu més informació sobre l'anàlisi d'usuaris, sessions i esdeveniments a Application Insights.

3. Seleccioneu una de les sessions d'usuarisi per desglossar els detalls específics. Podeu veure la informació, com ara la duració de la sessió i les pantalles visitades:

   

4. Seleccioneu la visualització Esdeveniments a la subfinestra de navegació esquerra a la secció Ús . Podeu veure un resum de totes les pantalles visualitzades a totes les sessions de l'aplicació:

   

Crear esdeveniments de traces personalitzats

Podeu escriure traces personalitzades directament a l'Application Insights i començar a analitzar la informació específica del vostre escenari. La funció Traça us permet recollir:

• Informació granular d'ús dels controls a les pantalles
• Quins usuaris concrets accedeixen a l'aplicació
• Quins errors es produeixen

Les traces també poden ajudar-vos a diagnosticar problemes perquè podeu enviar un rastre d'informació a mesura que els usuarisis naveguin per l'aplicació i facin diverses accions. Els missatges de seguiment enviats tenen Application Insights una d'aquestes tres gravetats:

• Informació
• Advertiment
• Error

En funció del vostre escenari, podeu triar entre enviar un missatge de traça amb la gravetat adient. Podeu consultar les dades i dur a terme accions específiques en funció de la gravetat.

Ara creeu un component nou a l'aplicació per recollir comentaris a cada pantalla i escriviu els esdeveniments Application Insights.

1. Inicieu la sessió a Power Apps.

2. Seleccioneu Aplicacions a la subfinestra de navegació esquerra. A la llista d'aplicacions, seleccioneu l'aplicació Kudos i, a continuació, seleccioneu Edita.

   Nota

   També podeu crear una aplicació nova o editar una aplicació existent.

3. Seleccioneu l'opció Components a la vista d'arbre:

   

4. Seleccioneu Component nou i, a continuació, canvieu la mida de l'amplada a 200 i l'alçada a 75:

   

5. Seleccioneu Insereix al menú i, a continuació, seleccioneu Icones per afegir Emoji - Arrufar les celles i Emoji - Somriure :

   

6. Seleccioneu Propietat personalitzada nova per crear una propietat personalitzada:

   

7. Introduïu el nom de la propietat i el nom de visualització , com ara FeedbackSceen.

8. Introduïu la descripció de la propietat.

9. Seleccioneu Tipus de propietat com a Entrada i Tipus de dades com a Pantalla:

   

   Nota

   La propietat d'entrada us permet capturar el nom de la pantalla i el seu component, de manera que pugueu registrar aquesta informació a l'Application Insights.

10. Seleccioneu el component a la visualització d'arbre , seleccioneuMés accions ( ...) i, a continuació, seleccioneuCanvia el nom per canviar el nom del component amb un nom significatiu, com ara FeedbackComponent .

    

11. Seleccioneu les icones, seleccioneu Més accions (...) i, a continuació, seleccioneu Canvia el nom per canviar el nom de les icones amb noms significatius, com ara FrownIcon i SmileIcon.

12. Seleccioneu FrownIcon, seleccioneu la propietat OnSelect i, a continuació, introduïu l'expressió següent a la barra de fórmules:

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

    

    Nota

    L'expressió de fórmula envia UserName,UserEmail,Screen i Feedback (amb el valor-1 ) a. Application Insights

13. Seleccioneu SmileIcon, seleccioneu la propietat OnSelect i, a continuació, introduïu l'expressió següent a la barra de fórmules:

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

14. Afegiu el component a una de les pantalles de l'aplicació:

    

15. Seleccioneu Desa i, a continuació, seleccioneu Publica per desar i publicar l'aplicació.

16. Reproduïu l'aplicació publicada i envieu un comentari de somriure i trist des de les vostres pantalles.

    Important

    Heu de reproduir l'aplicació publicada per enviar els esdeveniments a l'Application Insights. Els esdeveniments no s'envien a l'Application Insights quan utilitzeu la visualització prèvia de l'aplicació al Power Apps Studio.

    

Analitzar dades a l'Application Insights

Ara podeu començar a analitzar les dades que heu enviat mitjançant la funció Traça des de la vostra aplicació Application Insights.

1. Inicieu la sessió al portal de l'Azure i obriu el recurs que heu creat Application Insights anteriorment :

   

2. Seleccioneu Registres a Supervisió a la subfinestra de navegació esquerra:

   

3. Introduïu la consulta següent i seleccioneu Executa per veure els comentaris rebuts de l'aplicació:

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

   

4. Seleccioneu una fila als resultats i expandiu el camp customDimensions .

   S'han registrat els valors de Screen,UserName,UserEmail i FeedbackValue per a l'esdeveniment OnSelect de la icona de somriure o arrufar de les celles al component. També es registren valors per a cada esdeveniment enviat Application Insights, com ara appId,appName i appSessionId.

   

5. Amb la consulta d'exemple següent, podeu ampliar les propietats de les dimensions personalitzades del JSON i projectar les columnes de la visualització de resultats.

   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
   

   

   Propina

   Les consultes de registre són extremadament potents. Podeu utilitzar-les per unir diverses taules, agregar grans quantitats de dades i fer operacions complexes. Obteniu més informació sobre les consultes de registre.

Supervisar errors sense supervisar (experimental)

[Aquesta secció conté la documentació preliminar i està subjecta a canvis.]

No sempre pots anticipar i planificar tots els errors que es puguin produir mentre s'executa l'aplicació. Els errors de fórmules no gestionats Power Fx s'informen als usuaris com a missatges de bàner. També se'n poden informar Application Insights per ajudar-vos a entendre la seva freqüència i gravetat sense dependre dels usuaris de l'aplicació per informar de problemes. També podeu configurar alertes en temps real quan es produeixin errors en temps d'execució per adoptar un enfocament més proactiu.

Habilita l'error que passa a l'Application Insights

Heu d'habilitar la configuració que permet Power Apps passar errors d'execució no controlats a l'Azure Application Insights.

Per habilitar la transmissió d'errors, aneu a Configuració > Properes característiques > Experimental > Errors de pas a Azure Application Insights mentre manteniu l'aplicació de llenç oberta per editar-la. Deseu i publiqueu l'aplicació.

Error d'esdeveniments a l'Application Insights

Els errors no controlats Power Fx experimentats pels usuaris en temps d'execució de l'aplicació s'informen a la taula de traces . Els errors no gestionats es poden identificar i distingir d'altres esdeveniments d'error mitjançant el missatge d'esdeveniment "Error no gestionat". La dimensió "severityLevel" d'aquests esdeveniments és 3 (TraceSeverity.Error).

Els missatges d'error detallats es proporcionen a la dimensió "errors" de la propietat customDimension . En situacions en què s'han produït diversos errors durant la mateixa operació, els errors es consoliden en la dimensió "errors" d'un únic esdeveniment de traça. Els missatges d'error són els mateixos que s'han informat al Monitor durant una sessió de depuració en directe.

La consulta d'exemple següent identifica errors no controlats i amplia tots els missatges d'error inclosos a l'esdeveniment de traça:

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

Seguiment de la correlació (experimental)

[Aquesta secció conté la documentació preliminar i està subjecta a canvis.]

Les connexions a dades i serveis externs són insericions a la majoria d'aplicacions. El seguiment de correlació genera i propaga informació de context per unir registres generats pel sistema en una aplicació de llenç i les seves connexions, subjecte a certes limitacions. Per exemple, l'aplicació pot trucar a un connector personalitzat que, al seu torn, truca a una funció de l'Azure o una altra API de REST. El seguiment de correlació us permet correlacionar les accions realitzades a l'aplicació amb les trucades a l'API subjacents entre nivells. Pot ser útil a la resolució de problemes.

El seguiment de correlació d'aplicacions de llenç és una implementació del seguiment de context i segueix l'especificació del W3C.

Habilita el seguiment de correlació

Per habilitar la característica de seguiment de correlació, aneu a Configuració > Properes característiques > Experimental > Habiliteu el seguiment de Application Insights correlació de l'Azure mentre manteniu l'aplicació de llenç oberta per editar-la. Deseu i publiqueu l'aplicació.

Limitacions

• El seguiment de correlació només està disponible per a connectors personalitzats. No s'admeten altres tipus de connectors.
• Les sol·licituds HTTP només es capturen si Application Insights el servei connectat també està connectat Application Insights.

Utilitzar el seguiment de correlació

Quan s'habilita, el seguiment de correlació afegeix un nou esdeveniment de registre generat pel sistema a la taula de dependències de la instància de l'aplicació Application Insights de llenç. Aquest esdeveniment es registra en el moment en què es rep una resposta d'una trucada de xarxa. Les incidències de dependència capturen detalls de les trucades de xarxa, incloent-hi les capçaleres de sol·licitud i resposta, el codi d'estat de la resposta i la duració de la trucada.

Si el servei connectat també està connectat Application Insights, es genera un esdeveniment de registre generat pel sistema addicional que captura la sol·licitud a la taula de sol·licituds Application Insights de la instància del servei. Alguns serveis de l'Azure, com ara l'Azure Functions, es poden connectar sense cap codificació des del portal de l'Azure. Tant l'aplicació de llenç com diverses aplicacions i serveis connectats es poden connectar a la mateixa Application Insights instància.

Les trucades de xarxa per als connectors admesos es poden unir amb altres registres generats pel sistema a la dimensió "operation_Id". La consulta d'exemple següent mostra una trucada de xarxa que es fa juntament amb esdeveniments de traça emesos durant una sessió d'aplicació.

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

Exportar dades a l'Power BI

Podeu exportar les dades de l'Application Insights i consultar els resultats al Power BI per a l'anàlisi i la presentació de dades.

1. Inicieu la sessió al portal de l'Azure i obriu el recurs que heu creat Application Insights anteriorment :

2. Seleccioneu Registres a Supervisió a la subfinestra de navegació esquerra:

3. A la finestra de consulta de l'anàlisi de registres, seleccioneu el menú Exporta .

4. Seleccioneu l'opció Exporta a Power BI (M consulta) per descarregar un Power BI fitxer de consulta:

   

5. Obriu el fitxer baixat en un editor de text i copieu la consulta al porta-retalls.

6. Obre Power BI.

7. Seleccioneu el menú Obtén dades a la franja d'inici i, a continuació, seleccioneu Consulta en blanc:

   

8. A la finestra de consulta, seleccioneu Editor avançat. Enganxeu la consulta a la finestra, seleccioneu Fet i, a continuació, seleccioneu Tanca i aplica:

   

També podeu crear gràfics i visualitzacions al Power BI per representar els comentaris rebuts a l'aplicació, així com prendre decisions i accions basades en dades.

Context i dimensions de l'esdeveniment de traça per defecte

També s'afegeix un conjunt de dimensions per defecte a la propietat customDimensions a cada esdeveniment de traça. Aquestes dimensions es poden utilitzar per identificar les sessions de l'aplicació i de l'aplicació en què s'han produït els esdeveniments. Si registreu dades personalitzades addicionals amb la funció Trace, també es mostraran a les dimensions personalitzades.

Escenaris no admesos

Application Insights no admet els escenaris següents.

• Els esdeveniments de jugador fora de línia no es capturen.
• Els esdeveniments de l'aplicació mòbil (ambdós iOS i Android) no es capturen quan se suspèn l'aplicació.