Perfilar una aplicación en modalidad autónoma

La información siguiente atañe a Windows. La información siguiente atañe a AIX. La información siguiente atañe a Linux. La información siguiente atañe a Solaris. Puede perfilar una aplicación en modalidad autónoma (es decir, desde la línea de mandatos) sin tener las herramientas de Hyades instaladas. Sin embargo, necesita tener Agent Controller instalado en la máquina en la que reside la aplicación a perfilar. 

Para perfilar una aplicación en modalidad autónoma, se invoca el agente de perfilado Java, que es una biblioteca conectada a una máquina virtual Java (JVM) para capturar y anotar el comportamiento de la aplicación Java. Los datos de salida del agente tienen el formato de fragmentos XML.

Utilice la opción Java -Xrun para invocar el agente de perfilado Java:

    -XrunpiAgent:parámetro_agente[,parámetro_agente]*

Por ejemplo, para perfilar PerformanceExample.java utilizando los filtros definidos en el archivo myFilters.txt y dirigiendo los datos procedentes de la sesión de perfilado a un archivo que se llame PEProfilingData, escribiría lo siguiente en una línea de mandatos:
    java -XrunpiAgent:server=standalone,filters=myFilters.txt,file=PEProfilingData.trcxml PerformanceExample

Si aumenta el parámetro -XrunpiAgent, puede especificar varias modalidades distintas en las que ejecutar el agente de perfilado. El parámetro parámetro_agente puede tomar uno de los siguientes valores:

Formato del archivo de filtros de clases

El archivo de filtro debe especificar tres campos, paquete/clase, método y modalidad en el siguiente formato:
   paquete/clase método modalidad

Aquí,

paquete/clase
Este campo sirve para especificar un patrón para un nombre de paquete o de clase. El patrón se debe especificar como una serie de caracteres sin blancos intercalados. La serie de caracteres puede contener un asterisco (*) al principio o al final de la serie, por ejemplo *.mypackage o org.mycompany.*. El asterisco (*) hace las veces de varios caracteres o de ninguno, por lo que el patrón actúa a modo de prefijo o sufijo genérico. También se puede especificar solamente un asterisco (*) para representar todas las series posibles.
método
Este campo sirve para especificar un patrón para el nombre del método. El patrón se debe especificar como una serie de caracteres sin blancos intercalados y con las mismas reglas de especificación que el campo clase.
modalidad
Este campo especifica si el paquete o clase que coincida con el patrón se debe incluir en el perfil o se debe excluir del mismo. El valor de la modalidad puede ser INCLUIR o EXCLUIR.

Los patrones de filtrado se procesan en el orden en que se han especificado hasta que se logra la primera coincidencia con el patrón. Si el nombre de la clase no coincide con ninguno de los patrones de filtrado especificados, se toma por omisión la modalidad INCLUIR, que consiste en incluir la clase. 

Control del agente de perfilado Java

Cuando el agente de perfilado Java se inicia con el parámetro server=enabled o server=controlled, la comunicación con el agente se realiza con el entorno de trabajo del cliente por medio de Agent Controller en la máquina de sistema principal.

Notas

Conceptos relacionados
Visión general de la herramienta de perfilado
Recursos de perfilado

Tareas relacionadas
Perfilar una aplicación en modalidad autónoma en AS/400
Lanzar o conectar un proceso Java
Utilizar la vista Supervisor de perfilado