Analizar la telemetría de una aplicación de lienzo mediante Application Insights

Puede conectar su aplicación con Application Insights, una característica de Azure Monitor. Application Insights incluye potentes herramientas de análisis para ayudarlo a diagnosticar problemas y comprender qué hacen realmente los usuarios con su aplicación.

Con su aplicación conectada a Application Insights, puede recopilar información para ayudarlo a tomar mejores decisiones comerciales y mejorar la calidad de sus aplicaciones.

En esta guía de inicio rápido, creará una aplicación de lienzo denominada Kudos. Esto lo ayuda a explorar, descubrir conceptos de telemetría y aplicarlos a sus propias aplicaciones de lienzo. La aplicación Kudos de ejemplo forma parte de un conjunto de aplicaciones de participación de los empleados disponibles para su descarga desde el Kit de inicio de experiencia del empleado.

Requisitos previos

Opcionales

Crea un recurso de Application Insights

Antes de poder enviar telemetría para una aplicación, deberá crear un recurso de Application Insights para almacenar los eventos.

  1. Inicie sesión en el portal Azure.

  2. Buscar Application Insights:

    Application Insights.

  3. Crear un recurso de Application Insights:

    Agregar un recurso de Application Insights.

  4. Introduzca los valores apropiados y seleccione Revisar + crear. Para más detalles, lea Crear un recurso de Application Insights.

    Crear un recurso.

  5. Después de crear la instancia de Application Insights, verá la descripción general de la instancia. Copie la Clave de instrumentación. Necesitará esta clave para configurar su aplicación.

    Copiar clave de instrumentación.

Conectar su aplicación a Application Insights

  1. Inicie sesión en Power Apps.

  2. Seleccione Aplicaciones en el panel de navegación izquierdo. En la lista de aplicaciones, seleccione la aplicación Kudos y luego Editar:

    Editar aplicación Kudos.

    Nota

    También puede crear una nueva aplicación o editar cualquier aplicación existente en su lugar.

  3. Selecciona el objeto Aplicación de la vista de árbol de navegación izquierda y pegue la Clave de instrumentación:

    Agregar clave de instrumentación.

  4. Guarde y Publique su aplicación.

  5. Reproduzca la aplicación publicada y navegue a través de diferentes pantallas.

A medida que navega por diferentes pantallas, los eventos se registran automáticamente en Application Insights, incluidos los detalles de uso como:

  • Desde dónde se accede a la aplicación.
  • Qué dispositivos se utilizan.
  • Los tipos de navegador utilizados.

Importante

Debe reproducir la aplicación publicada para enviar eventos a Application Insights. Los eventos no se envían a Application Insights si previsualiza la aplicación en Power Apps Studio.

Ver eventos en Application Insights

  1. Inicie sesión en Azure Portal y abra el recurso de Application Insights que creó anteriormente.

  2. Desplácese hacia abajo en el panel de navegación izquierdo y seleccione Usuarios en la sección Utilización.

    Nota

    La vista de usuarios muestra detalles de uso de la aplicación, como:

    • Número de usuarios que vieron la aplicación.
    • Número de sesiones de los usuarios para la aplicación.
    • Número de eventos registrados para la aplicación.
    • Sistemas operativos y detalles de la versión del navegador de los usuarios.
    • Región y ubicación de los usuarios.

    Para más detalles, lea Análisis de usuarios, sesiones y eventos en Application Insights.

  3. Seleccione una de las sesiones de usuario para profundizar en detalles específicos. Puede ver información como la duración de la sesión y las pantallas visitadas:

    Detalles de utilización para usuarios.

  4. Seleccione la vista Eventos en el panel de navegación izquierdo y la sección Utilización. Puede ver un resumen de todas las pantallas vistas en todas las sesiones de la aplicación:

    Detalles del evento para la aplicación.

Sugerencia

Algunas de las características de Application Insights adicionales que puede utilizar son:

Crear eventos de seguimiento personalizados

Puede escribir seguimientos personalizados directamente en Application Insights y comenzar a analizar información específica de su escenario. La función Trace le permite recopilar:

  • Información de utilización granular para controles en las pantallas.
  • Qué usuarios específicos están accediendo a su aplicación.
  • Que errores ocurren.

El seguimiento también puede ayudar a diagnosticar problemas porque puede enviar un seguimiento de información a medida que sus usuarios navegan por su aplicación y realizan diferentes acciones.

Hay tres gravedades de los mensajes de seguimiento cuando se envía información de seguimiento personalizada a Application Insights desde su aplicación:

  • Información
  • Advertencia
  • Error

Dependiendo de su escenario, puede optar por enviar un mensaje de seguimiento con la gravedad adecuada. Puede consultar los datos y realizar acciones específicas en función de la gravedad del mensaje.

Nota

Si está registrando datos de personal, deberá tener en cuenta las obligaciones de cumplimiento de datos, como el RGPD, que también puede que tenga que implementar.

Ahora actualizará su aplicación y creará un nuevo componente para recopilar comentarios en cada pantalla de la aplicación. Escriba los eventos en Application Insights.

  1. Inicie sesión en Power Apps.

  2. Seleccione Aplicaciones en el panel de navegación izquierdo. En la lista de aplicaciones, seleccione la aplicación Kudos y luego Editar.

    Nota

    También puede crear una nueva aplicación o editar cualquier aplicación existente en su lugar.

  3. Seleccione la opción Componentes de la Vista de árbol:

    Componentes.

  4. Seleccione Nuevo componente y luego redimensione el ancho a 200 y la altura a 75:

    Alto y ancho.

  5. Seleccione Insertar desde el menú y luego seleccione Iconos para agregar el emoji de ceño fruncido y el emoji de sonrisa:

    Agregar iconos.

  6. Seleccione Nueva propiedad personalizada para crear una propiedad personalizada:

    Crear propiedad personalizada.

  7. Escriba la propiedad Name y Display name como FeedbackSceen.

  8. Introduzca la propiedad Description.

  9. Seleccione Tipo de propiedad como Entrada y Tipo de datos como Pantalla:

    Propiedad personalizada.

    Nota

    La propiedad de entrada le permite capturar el nombre de pantalla y su componente para que pueda registrar esta información en Application Insights.

  10. Seleccione el componente en la Vista de árbol, seleccione Mas acciones (...) y luego seleccione Cambiar nombre para cambiar el nombre del componente por un nombre significativo como FeedbackComponent.

    Cambiar nombre de componentes e iconos.

  11. Seleccione los iconos, seleccione Mas acciones (...) y luego seleccione Cambiar nombre para cambiar el nombre de los iconos por nombres significativos, como FrownIcon y SmileIcon.

  12. Seleccione FrownIcon, seleccione la propiedad OnSelect y luego escriba la siguiente expresión en la barra de fórmulas:

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

    Fórmula de icono de ceño fruncido.

    Nota

    La expresión de fórmula envía UserName, UserEmail, Screen y Feedback (con el valor -1) a Application Insights.

  13. Seleccione SmileIcon, seleccione la propiedad OnSelect y luego escriba la siguiente expresión en la barra de fórmulas:

    Trace(
       "App Feedback",
       TraceSeverity.Information,
           {
             UserName: User().FullName,
             UserEmail: User().Email,
             Screen: FeedbackComponent.FeedbackScreen.Name,
             FeebackValue: "1"
           }
         );
    Notify("Thanks for you feedback!");
    
  14. Agregue el componente a una de las pantallas en su aplicación:

    Agregar componente de comentarios.

  15. Seleccione Guardar y luego Publicar para guardar y publicar su aplicación.

  16. Reproduzca la aplicación publicada y envíe un comentario de sonrisa y de ceño fruncido desde tus pantallas.

    Importante

    Debe reproducir la aplicación publicada para enviar eventos a Application Insights. Los eventos no se envían a Application Insights si previsualiza la aplicación en Power Apps Studio.

    Reproducir aplicación publicada.

Analizar datos en Application Insights

Ahora puede comenzar a analizar los datos que envió utilizando la función Trace desde su aplicación en Application Insights.

  1. Inicie sesión en Azure Portal y abra el recurso de Application Insights que creó anteriormente:

    Seleccionar Application Insights.

  2. Seleccione Registros en Supervisión desde el panel de navegación izquierdo:

    Seleccionar registros.

  3. Escriba la siguiente consulta y seleccione Ejecutar. Se devuelven los comentarios recibidos de su aplicación:

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

    Ver comentarios de la aplicación.

  4. Seleccione una fila en los resultados y expanda el campo customDimensions.

    Se han registrado los valores para Screen, UserName, UserEmail y FeedbackValue para el evento OnSelect del icono de sonrisa o de ceño fruncido en su componente.
    También hay algunos valores adicionales registrados para cada evento enviado a Application Insights, tales como appId, appName, y appSessionId.

    Expandir dimensiones personalizadas.

  5. Con la siguiente consulta de ejemplo, puede ampliar las propiedades de las dimensiones personalizadas JSON y proyectar las columnas en la vista de resultados.

    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
    

    Extender la consulta customDimensions.

    Sugerencia

    Las consultas de registro son extremadamente útiles. Puede usarlas para unir varias tablas, agregar grandes cantidades de datos y realizar operaciones complejas. Para más información, lea Consultas de registro.

Exportar datos a Power BI

Puede exportar sus datos de Application Insights y consultar los resultados en Power BI para el análisis y la presentación de los datos.

  1. Inicie sesión en Azure Portal y abra el recurso de Application Insights que creó anteriormente:

  2. Seleccione Registros en Supervisión desde el panel de navegación izquierdo:

  3. Desde la ventana de consulta de análisis de registro, seleccione el menú desplegable Exportar.

  4. Seleccione la opción Exportar a Power BI (Consulta M). Se descargará un archivo de consulta Power BI a su máquina:

    Exportar consulta de Power BI.

  5. Abra el archivo descargado en un editor de texto y copie la consulta al portapapeles.

  6. Abierto Power BI.

  7. Seleccione el menú desplegable Obtener datos en la cinta de opciones Inicio y luego seleccione Consulta en blanco:

    Consulta en blanco de Power BI.

  8. Seleccione Editor avanzado en la ventana de consultas. Pegue la consulta del paso 5 en la ventana, seleccione Listo y luego seleccione Cerrar y aplicar:

    Consulta avanzada de Power BI.

  9. También puede crear gráficos y visualizaciones en Power BI para representar los comentarios recibidos en su aplicación, así como para tomar decisiones y acciones basadas en datos.

    Gráficos y visualizaciones.

Contexto y dimensiones del evento de seguimiento predeterminado

También se agrega un conjunto de dimensiones predeterminadas a la propiedad customDimensions en cada evento de seguimiento. Estas dimensiones se pueden usar para identificar la aplicación y las sesiones de aplicación en las que ocurrieron los eventos. Si registra datos personalizados adicionales con la función de seguimiento, también aparecerán en las dimensiones personalizadas.

Nombre de dimensión Representa
ms-appId El Id. de la aplicación que envió el evento.
ms-appName El nombre de la aplicación que envió el evento.
ms-appSessionId El id. de sesión de la aplicación.

Escenarios no admitidos

App Insights no admite los siguientes escenarios.

  • Los eventos de reproductor/aplicaciones móviles sin conexión (tanto Android como iOS) no se capturan.
  • Las solicitudes de red y los errores no se capturan.
  • No se admiten GCC ni nubes que no son públicas.