Lumberyard
Guía del usuario (Version 1.20)

Tutorial sobre el generador de perfiles

El generador de perfiles está en versión preliminar y sujeto a cambios.

Puede registrar una aplicación en GridHub y usar el generador de perfiles para capturar, inspeccionar, reproducir y exportar los datos que recopile.

Registro de la aplicación

Para permitir al generador de perfiles capturar información de la aplicación, primero debe registrar la aplicación en GridHub. Para ello, añada AzFramework::TargetManagementComponent al componente SystemComponent de la aplicación.

Nota: Las aplicaciones integradas de Lumberyard ya cuentan con la adición de este componente de forma predeterminada.

Lanzamiento del generador de perfiles

A diferencia de muchas utilidades de Lumberyard, lanza el generador de perfiles desde su propio archivo ejecutable.

Para lanzar el generador de perfiles

  • En el directorio dev\Bin64\ de Lumberyard ejecute Profiler.exe.

    
              Ventana inicial del generador de perfiles

Captura de datos

El generador de perfiles tiene dos modos principales de uso: modo de captura y modo de inspección.

Para usar el modo de captura, siga estos pasos.

Para capturar datos

  1. Haga clic en Target (Objetivo).

    
                Botón Target (Objetivo)

    El generador de perfiles muestra las aplicaciones que están disponibles para la generación de perfiles:

    
                Aplicaciones disponibles para la generación de perfiles
  2. Seleccione una aplicación de destino.

    Una vez que haya seleccionado un destino, el selector de destino muestra el estado de la conexión con el destino. La próxima vez que lance el generador de perfiles, seleccionará el destino automáticamente, en caso de que esté disponible.

    
                Aplicación seleccionada para la captura de datos

    La ventana se divide horizontalmente en canales que tienen asociadas instancias del generador de perfiles. Un canal es una colección de instancias del generador de perfiles relacionadas con un sistema específico.

  3. Cada una de las instancias del generador de perfiles de un canal tiene un color único. Una instancia del generador de perfiles está activa cuando su color es sólido:

    
                Instancias del generador de perfiles activas

    Haga clic en el color situado junto a una instancia del generador de perfiles. El color ya no es sólido, lo que significa que la instancia del generador de perfiles está inactiva:

    
                Instancias del generador de perfiles inactivas

    Haga clic en el color de nuevo para activar la pantalla y activar la instancia otra vez.

  4. Una vez que haya seleccionado un destino y que haya elegido las instancias del generador de perfiles que desea ver, haga clic en Capture (Capturar).

    
                Botón Capture (Capturar)

    Cuando empiece la captura, los datos comenzarán a rellanar los canales.

    
                Comienzo de la captura
  5. Para detener la captura de datos, haga clic en Stop Capture (Detener captura).

    
                Botón Stop Capture (Detener captura)
  6. Cuando se le solicite, guarde los datos capturados en el disco. El generador de perfiles guarda los datos en un archivo con formato binario con una extensión .drl, vuelve a cargar los datos desde el disco y cambia al modo de inspección.

    nota

    Si no guarda los datos, estos se descartarán.

Inspección de datos

Puede usar el generador de perfiles para examinar los datos que ha capturado.

Para inspeccionar los datos capturados

  1. En el generador de perfiles, haga clic en File (Archivo), Open Data (Abrir datos) o presione Ctrl+O:

    
                Abrir datos
  2. Vaya al archivo .drl que contiene los datos guardados y ábralo.

    En la pantalla principal del generador de perfiles se proporciona información general de los canales de información del sistema. En este ejemplo se usa un archivo que tiene 1162 fotogramas de datos:

    
                Pantalla principal del generador de perfiles

    Puede usar esta vista principal para detectar anomalías en los canales o para examinar determinadas áreas de interés en general.

    Al abrir la ventana principal, el cuadro de desplazamiento de la parte inferior está a la derecha porque la reproducción se detuvo al final de los datos capturados.

    Observe la línea vertical roja situada a la derecha.

  3. Haga clic en el área de canales de la ventana.

    
                Hacer clic en la ventana

    La línea vertical roja se mueve al lugar donde ha hecho clic. El indicador de fotograma muestra la nueva posición de la línea roja. Puede colocar la línea roja, llamada el cepillo, en cualquier fotograma que desee examinar con detalle. Para un control más exhaustivo sobre la posición del cepillo, puede escribir un número en el indicador Frame (Fotograma).

    
                Indicador Frame (Fotograma)

    El cepillo se mueve en consecuencia.

  4. Para ver información detallada acerca de un fotograma en el que recae el cepillo, haga clic en el icono Detailed Profiling Information (Información de perfiles detallada) situado junto a la instancia del generador de perfiles cuyos datos desea ver:

    
                Información de perfiles detallada

    La información de la instancia del generador de perfiles aparece en una ventana de detalles.

    
                Ventana de detalles

    Los generadores de perfiles individuales presentan detalles de diversas formas, por lo que sus ventanas de detalles pueden tener un aspecto diferente. Para obtener información acerca de las ventanas de detalles específicas del sistema del generador de perfiles, consulte Uso del generador de perfiles para redes, Uso del generador de perfiles para el uso de CPU y Uso del generador de perfiles para VRAM.

  5. Para volver a pasar del modo de inspección al modo de captura, haga clic en la pestaña LIVE (DIRECTO).

    
                Hacer clic en LIVE (DIRECTO) para volver al modo de captura

Reproducción de datos

Puede marcar y reproducir un subconjunto de los datos capturados.

Tenga en cuenta que después de mover el cepillo la primera vez, apareció una línea vertical amarilla a la derecha al final de los datos:


          Marcador amarillo al final

Este marcador amarillo se puede mover y marca el fin del rango de reproducción deseado. De forma predeterminada, se encuentra al final de los datos capturados, pero el cepillo rojo puede hacer que quede casi oculto.

  1. Desplace la ventana hasta el extremo izquierdo, al principio del rango de captura.

    
                Marcador amarillo al principio

    Ahora también aparece un marcador amarillo al principio de los datos. Puede usar estos dos marcadores amarillos, que de forma predeterminada se encuentran al principio y al final del rango de captura, para restringir el rango de reproducción a un área de datos que le interese. Los usará en breve.

    Si tiene muchos fotogramas de datos (como en este ejemplo), la vista inicial no muestra todos los fotogramas de forma predeterminada.

  2. Para ver todos los fotogramas a la vez, haga clic en Frame Count Selector (Selector de recuento de fotogramas), que determina el número de fotogramas visibles, y elija All frames (Todos los fotogramas):

    
                Elegir All frames (Todos los fotogramas)

    Ahora puede ver todo el rango de datos capturados, con los marcadores amarillos al principio y al final:

    
                All frames (Todos los fotogramas)
  3. Arrastre los dos marcadores amarillos a un área de datos que desee reproducir. Puede hacer caso omiso de la posición del cepillo por el momento.

    
                Rango restringido marcado para la reproducción
  4. Haga clic en Play (Reproducir) para comenzar la reproducción:

    
                Reproducción de datos grabados

    A medida que se reproducen los datos, el cepillo se mueve del primer marcador amarillo al segundo. A continuación, regresa en bucle al primero.

    Estos son algunos consejos a tener en cuenta:

    • Si la velocidad de reproducción es demasiado alta (la predeterminada es 60), use la opción Playback Speed (Velocidad de reproducción) para ajustarla de 1 a 60.

    • Si hace clic en una ubicación de la ventana de reproducción mientras tiene lugar esta, se detendrá y moverá el cepillo a la ubicación en la que ha hecho clic.

    • Puede colocar el cepillo en un fotograma que le interese y hacer clic en el botón de detalles para que una instancia del generador de perfiles vea la ventana de detalles del fotograma.

    • Para una comodidad y visibilidad mayores, deje abierta la ventana de detalles de la instancia del generador de perfiles para ver el cambio de datos en la ventana de detalles a medida que el cepillo se mueve en bucle entre los marcadores.

    
                Ventana de detalles y ventana principal abiertas
  5. Haga clic en Stop (Detener) para detener la reproducción.

Exportación de datos

Algunas instancias del generador de perfiles tienen una opción de exportación que puede usar para guardar datos en un archivo .csv.

Para exportar datos de una instancia del generador de perfiles a un archivo .csv

  1. Haga clic en el icono Save to CSV (Guardar en CSV) de la instancia del generador de perfiles cuyos datos desee guardar:

    
              Hacer clic en Save to CSV (Guardar en CSV)

    nota

    No todos los generadores de perfiles tienen la opción de exportación de datos.

  2. Para elegir los campos que desea exportar, haga clic en Customize (Personalizar) en el cuadro de diálogo de exportación.

    
              Personalización de campos de exportación