• Uso de la vista del analizador de IDM
• Uso de la vista de instantáneas
• Uso de las opciones de menú emergente
• Búsqueda en una instantánea
• Guardar una instantánea
Especificación de las opciones del analizador
El cuadro de diálogo Profiler Options contiene las fichas: • Mode
• IDM Object Filters
• Java Filters
• Misceláneo
Use las opciones de estas fichas para indicar qué objetos se analizan y qué elementos aparecen en el análisis.
Tras especificar las opciones del analizador, haga clic en OK para iniciarlo. Según la configuración del proyecto, el analizador realiza uno de estos dos procesos:
• Si utiliza un proyecto normal de Identity Manager con una instancia incrustada de Identity Manager, el analizador efectúa una compilación completa, la implementa en el servidor de aplicaciones de NetBean e inicia el analizador.
• Si utiliza un proyecto normal de Identity Manager con una instancia externa de Identity Manager o el proyecto remoto de Identity Manager, el analizador se conecta a la instancia de Identity Manager configurada para el proyecto.
Mode La ficha Mode ofrece las siguientes opciones:
• IDM Objects Only: Seleccione esta opción para analizar objetos de formulario, regla, flujo de trabajo y XPRESS. Excluye los objetos de Java del análisis.
• Java and IDM Objects: Seleccione esta opción para analizar objetos de formulario, Java, regla, flujo de trabajo y XPRESS.
NOTA Puede seleccionar IdM > Set Identity Manager Instance para controlar la acción de la instancia de Identity Manager para el proyecto.
NOTAS • La opción Java and IDM Objects no está disponible cuando se utiliza un proyecto normal de Identity Manager con una instancia externa de Identity Manager o si se utiliza un proyecto remoto de Identity Manager.
• No es posible cambiar la opción Mode mientras se ejecuta el analizador. Para ello debe detener el analizador.
IDM Object Filters La ficha IDM Object Filters ofrece las siguientes opciones: • Show IDM Object details:
❍ Marque esta casilla para incluir en la instantánea cada elemento ejecutado de
formulario, flujo de trabajo y XPRESS.
❍ Desactive esta casilla para incluir en la instantánea sólo los siguientes elementos: ◗ <invoke> ◗ <new> ◗ <Regla> ◗ <Formulario> ◗ <WFProcess> ◗ <ExScript> ◗ <ExDefun> ◗ <FieldRef>
◗ <Action> (para llamadas de aplicación de flujo de trabajo) • Include Anonymous Sources:
❍ Marque esta casilla para incluir orígenes anónimos en la instantánea. ❍ Desactive esta casilla para excluir los orígenes anónimos de la instantánea.
Java Filters Seleccione la ficha Java Filters para: • Incluir o excluir filtros de Java
• Crear filtros nuevos • Borrar filtros existentes
• Restaurar los filtros predeterminados
Los filtros de Java se suministran en patrones de métodos y se expresan mediante patrones que incluyen o excluyen aplicando un nombre de método canónico. Un nombre de método canónico es: NOTA Anonymous sources (orígenes anónimos) son formularios (o partes de ellos) que
se generan sobre la marcha (como los formularios de conexión y de campos ausentes) y no corresponden a un formulario persistente situado en el repositorio de Identity Manager.
fully-qualified-class-name.method-name(parameter-type-1, parameter-type-2, ...)
He aquí algunos ejemplos:
• Para excluir todos los constructores, active la casilla Exclude y añada el filtro siguiente: *.<init>(*)
• Para excluir todos los constructores con un solo parámetro org.w3c.dom.Element, active la casilla Exclude y añada el filtro siguiente:
*.<init>(org.w3c.dom.Element)
• Para excluir todas las clases de Identity Manager, active la casilla Exclude y añada los filtros siguientes:
"com.waveset.*" "com.sun.idm.*"
• Para instrumentar sólo el código personalizado, desactive la casilla Exclude, suprima el filtro * include inicial y añada luego el filtro siguiente:
"com.yourcompany.*"
Si es preciso, puede instrumentar otros jar modificando como interese las líneas siguientes en build.xml. Por ejemplo:
NOTA Para los constructores, method-name es <init>.
NOTA Los dos últimos ejemplos son equivalentes porque los filtros se aplican sólo a las clases personalizadas y a las de Identity Manager.
<instrument todir="${lighthouse-dir-profiler}/WEB-INF" verbose="${instrumentor.verbose}" includeMethods="${profiler.includes}" excludeMethods="${profiler.excludes}"> <fileset dir="${lighthouse-dir}/WEB-INF"> <include name="lib/idm*.jar"/> <include name="classes/**/*.class"/> </fileset> </instrument>
De forma predeterminada, la configuración incluye todas las clases personalizadas y la mayoría de las clases de Identity Manager. Se excluyen forzosamente diversas clases de Identity Manager, ya que su habilitación interrumpiría el analizador.
Por ejemplo, se excluyen las clases de los motores de flujo de trabajo, formularios y XPRESS, porque de lo contrario el analizador generaría una instantánea ininteligible al analizar objetos de Java e Identity Manager.
Los filtros de Java ofrecen mucha más granularidad de filtrado que los de objeto de IDM. La instrumentación de Java sobrecarga significativamente el tiempo de ejecución, lo que puede sesgar radicalmente los resultados del análisis. Como los objetos de Identity Manager se interpretan en lugar de compilarse, apenas hay sobrecarga de instrumentación. De ahí que, por ejemplo, no haya razones básicas para excluir el flujo de trabajo A e incluir el flujo de trabajo B, etc.
Misceláneo La ficha Miscellaneous ofrece las siguientes opciones: • Prune snapshot nodes where execution time is 0:
❍ Desactive esta opción (valor predeterminado) si quiere que la instantánea incluya
información de invocación para todas las entidades ejecutadas, incluso aquellas cuyo tiempo de ejecución es cero.
El número de invocaciones puede resultar útil, incluso para los nodos sin tiempo de ejecución.
❍ Active esta opción para suprimir dichos nodos, lo que le permitirá centrarse en los
datos más relevantes del análisis. Además, al activar esta opción se puede reducir drásticamente el tamaño de la instantánea del analizador.
• Automatically Open Browser Upon Profiler Start:
❍ Active esta opción (valor predeterminado) cuando ejecute el analizador para abrir
automáticamente un navegador que señale a la instancia de Identity Manager analizada.
❍ Desactive esta opción si no quiere abrir un navegador.
NOTA No es posible modificar los filtros de Java mientras se ejecuta el analizador. Antes debe detener el analizador.
• Include Java Sources in Snapshot:
❍ Active esta opción (valor predeterminado) para incluir orígenes Java con todos los
métodos Java referenciados por los datos del análisis en la instantánea. Siempre debe aplicarse esta opción a las instantáneas del campo. El código Java personalizado es relativamente pequeño y muy valioso por su utilidad.
❍ Desactive esta opción si va a analizar Identity Manager y tiene disponible el origen
completo de Identity Manager.
En tales circunstancias, no interesa incluir el origen de Identity Manager, ya que puede generar instantáneas gigantescas. (Para obtener más información, consulte “Búsqueda y gestión del orígenes en el analizador” en la página 150.)