Registro personalizado con seguimiento
Además de la telemetría que envía automáticamente el runtime de Power Apps a Application Insights, puede usar la función Trace() de Power Fx para enviar eventos personalizados. Al equipar su aplicación con llamadas de seguimiento, puede capturar eventos importantes y datos asociados.
Estos son algunos ejemplos de cuándo puede agregar llamadas a la función Trace():
Utilizando OnStart para registrar los parámetros que se pasan a su aplicación cuando se inició
Cuando los usuarios habilitan o deshabilitan opciones en su aplicación
Cuando se selecciona un botón para realizar una acción
Cuando el usuario cancela una acción
Cuando ocurre un error, como cuando alguien envía errores en un formulario o el origen de datos
Registrando errores de validación
Registrando criterios de búsqueda para que pueda determinar las búsquedas populares
Registrando comentarios basados en lo que le gusta o no le gusta a un usuario en una aplicación
Cualquier cosa que quiera consultar más tarde
Además de registrar los datos para Application Insights, los datos de seguimiento también son visibles en la herramienta Monitor y en los resultados de Power Apps Test Studio.
La sintaxis de la función es la siguiente:
Trace(message, trace_severity, custom_record )
El parámetro del mensaje es obligatorio y debe usarlo para identificar por qué llamó a trace, por ejemplo: Trace("Error en la validación de la hoja de horas").
Opcionalmente, puede pasar un nivel de gravedad de información, advertencia, error o crítica. Cuando se usa para categorizar consistentemente sus seguimientos, la gravedad puede ser útil para consultar los datos. Por ejemplo, puede recibir un correo electrónico diario con una lista de todos los errores capturados.
La función Trace() también le permite pasar un registro de datos con información de contexto. Este registro puede tener uno o más campos de datos que serían útiles para analizar los datos del evento de seguimiento más adelante. Además, puede utilizar estos datos en las consultas de registro para reducir el conjunto de registros de seguimiento que revisa. Puede crear el registro en línea usando llaves ({}) que contengan valores de campo con nombre. Por ejemplo, puede mejorar su validación anterior pasando más información de contexto:
Trace(“Timesheet Validation Failed”,Warning, { hoursWorked:ThisItem.HoursWorked”)
Al crear llamadas a la función Trace(), asegúrese de tener en cuenta los siguientes parámetros:
Evite que se registren datos confidenciales en Application Insights que puedan causar problemas de cumplimiento, como el nombre y la dirección de correo electrónico de un cliente.
Esté alerta a los datos incorrectos o una fórmula que pueda causar resultados inesperados.
Evite enviar demasiados datos; envíe solo lo que necesita para analizar o consultar los datos.
Utilice nombres de campo coherentes para facilitar las consultas en las llamadas de seguimiento relacionadas.
Consultar los seguimientos
Puede consultar y ver los datos capturados por cada llamada a la función Trace() consultando el registro y utilizando seguimientos como nombre de tabla.
En los resultados, cada línea tendrá un itemType de trace. En cada fila, se mostrará el mensaje y el nivel de severidad. Si expande la fila, se mostrará una propiedad customDimensions, que puede expandir aún más para mostrar los campos que registró como datos de contexto cuando invocó la función Trace ().
En la imagen anterior, Identificación del trabajo y Nombre del trabajo eran datos de contexto. Todos los campos ms- se agregan automáticamente a cada traza. Puede utilizar estos datos para crear una consulta similar al ejemplo siguiente, que consulta todos los registros de seguimiento de un JobId.
Puede usar ms-appId para encontrar todos los seguimientos de una aplicación específica y ms-appSessionId para encontrar todos los seguimientos de un usuario para esa sesión de ejecución de la aplicación. Cada aplicación que registra datos tendrá un valor de ms-appId único.
Agregar seguimientos a su aplicación puede proporcionarle un recurso valioso para seguir los problemas. Los seguimientos son especialmente valiosos porque puede usarlos para capturar datos para una aplicación que se está ejecutando en producción y no requiere que ejecute la aplicación en Power Apps Studio. Al agregar proactivamente llamadas a la función Trace() a su aplicación, estará listo cuando los usuarios informen sobre un problema complejo en producción.