Compartir a través de


Diagnosticar problemas y analizar el rendimiento mediante Trace parser

En este artículo se explica cómo puede utilizar la herramienta Trace Parser para consumir seguimientos y analizar el rendimiento en su implantación de la experiencia unificada del desarrollador. La herramienta puede visualizar la ejecución de métodos X++ y mostrar árboles de llamadas de ejecución, incluido el tiempo dedicado a cada método y el tiempo dedicado a cada operación de la base de datos.

Buscar Trace Parser

La herramienta Trace Parser es una aplicación de escritorio que se ejecuta en la máquina de desarrollo (cliente). Cuando descarga los metadatos, la base de datos de referencias cruzadas o más para una versión de aplicación particular, también se descarga un programa de instalación para Trace Parser (llamado TraceParser.msi). Utilice este archivo MSI para instalar la herramienta Trace Parser. Cuando la herramienta se inicia por primera vez, solicita un nombre para la base de datos que contiene los seguimientos. Proporcione un nombre que le permita distinguir la base de datos de seguimiento de otras bases de datos en su servidor (por ejemplo, "Seguimientos").

¿Cómo funciona?

Trace Parser captura eventos que ocurren al ejecutar el código de la aplicación, cuando se le indica que lo haga, como se describe aquí. Los eventos se almacenan en un archivo de registro de seguimiento de eventos (con una extensión de archivo .ETL) que se puede descargar al nivel del cliente.

Trace Parser necesita consultar los datos capturados en el archivo ETL de forma avanzada, por lo que la información del archivo ETL debe extraerse del archivo e inyectarse en una base de datos SQL en el lado del cliente. Este trabajo se realiza desde la herramienta, donde se puede cargar el archivo ETL y seleccionar la base de datos. Para este fin se puede utilizar cualquier base de datos SQL. Sugerimos utilizar la misma base de datos que se utiliza para los datos de referencia cruzada.

Advertencias

Los datos inyectados en la base de datos SQL, que están sujetos a consultas con Trace Parser, contienen consultas, declaraciones de acceso a datos y pilas de llamadas. Opcionalmente, el usuario puede incluir datos ampliados en los registros para facilitar el diagnóstico de problemas. Configurar la opción Incluir valores de parámetros SQL al recopilar el seguimiento puede filtrar información en la aplicación al seguimiento. La información registrada debe mantenerse tan segura como el propio entorno de producción. Se recomienda eliminar cualquiera de estas bases de datos tan pronto como termine de usarlas, no almacenar archivos ETL en lugares inseguros y eliminarlos después de su uso. Los seguimientos se pueden eliminar en la herramienta Trace Parser. Cuando se inicia la herramienta, muestra una descripción general de los seguimientos y los seguimientos individuales se pueden eliminar desde aquí.

Captura de un seguimiento

Cuando desee diagnosticar un problema en la aplicación en ejecución, inicie el seguimiento, realice los pasos de la aplicación que demuestran el problema y luego detenga el seguimiento. Luego, el rastro se analiza en Trace Parser. Puede proporcionar un nombre significativo al seguimiento cuando elija iniciarlo.

En esta sección explicamos cómo capturar un seguimiento desde la página web de la aplicación.

  1. En la barra de navegación del navegador, seleccione el signo de interrogación ? y luego seleccione Seguimiento.

  2. En el campo Nombre de seguimiento, introduzca un nombre para el seguimiento que está a punto de capturar. Es una buena práctica elegir un nombre que refleje el problema que desea investigar.

  3. Según sea necesario, establezca la opción Incluir valor de parámetro SQL en . Consulte las advertencias de la sección anterior.

  4. Seleccione el botón Iniciar seguimiento.

  5. Realice acciones que deban analizarse, como navegación a Cuentas por pagar>Proveedores>Todos los proveedores.

  6. Cuando termine, seleccione Detener seguimiento.

  7. Cuando se detenga el seguimiento, seleccione una de las siguientes opciones. Para este tutorial, seleccione la primera opción.

    • Descargar seguimiento – Almacena el seguimiento capturado en la máquina local. A continuación, puede analizar una traza descargada utilizando la versión de escritorio de Trace Parser.

      Nota

      Si descarga un seguimiento, no estará disponible para cargarlo más adelante.

    • Subir rastro – Almacene el rastro en la nube para descargarlo más tarde (por ejemplo, mediante Administrador). Los seguimientos cargados se eliminan automáticamente después de siete (7) días. También se puede eliminar manualmente desde la página Seguimientos capturados.

    • Regresar al menú principal – Regresa al menú principal de seguimiento para iniciar otro seguimiento.

Nota

Si su escenario tarda más de unos minutos, debería considerar dividirlo en varios seguimientos. Si un rastro es demasiado grande, no se puede analizar fácilmente.

Asignar derechos de seguimiento a un usuario

A cada cuenta de usuario del sistema que vaya a capturar y ver seguimientos se le debe asignar el rol "Usuario de seguimiento del sistema".

  1. Para otorgarle a un usuario derechos para capturar un seguimiento, vaya a Administración del sistema>Usuarios>Usuarios.
  2. Seleccione el usuario y asígnele el rol Usuario de seguimiento del sistema .

Asigne derechos de seguimiento a un usuario.

Nota

Para ayudar a evitar el seguimiento no deseado, elimine la función del usuario una vez que el usuario haya terminado el seguimiento.

Ver seguimientos

La pestaña Vista de escala de tiempo es la primera pestaña que ve después de importar un seguimiento al analizador de seguimiento. Esta pestaña se muestra en la siguiente ilustración.

Información mostrada en la pestaña de escala de tiempo.

La pestaña Escala de tiempo tiene los siguientes componentes principales:

  • El menú desplegable Seleccionar agrupación le permite agrupar según varias categorías, como Id. de cliente, nombre de usuario, nombre de sesión y más. Las agrupaciones muestran la marca de tiempo máxima y mínima de los eventos, el número total de eventos y el nivel de evento más bajo dentro de la agrupación.
  • Lista de todos los eventos en una vista con hilos o sin hilos.
  • Cuadrícula de propiedades mostrada para el evento seleccionado.
  • Gráfico de línea de tiempo para todos los eventos seleccionados.
  • Filtrado de eventos.
  • Notas de análisis de la sesión.

Se obtiene acceso a la Vista de árbol de llamadas seleccionando la pestaña Árbol de llamadas . Puede ver el árbol de llamadas para todos los métodos de X++.

Información mostrada en la pestaña de árbol de llamadas.

De manera similar, puede mostrar la pestaña X++ para ver una lista de todos los métodos de X++. Están ordenados por campos como duraciones inclusivas/exclusivas, RPC o llamadas a bases de datos. Estos métodos son similares a las pestañas correspondientes en Trace Parser y tienen el mismo comportamiento.

Consulte también

Referencia del lenguaje X++