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  instalado Test and Performance Tools Platform.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

Nota: si desea iniciar WebSphere Application Server Versión 6 (WAS) en modalidad de perfilado desde la línea de mandatos, debe seguir estos pasos:
  1. Vaya a <raíz de perfilado>/config/cells/<nombre_de_nodo>Cell/nodes/<nombre_de_nodo>/servers/server1
  2. Edite el elemento jvmEntries en el archivo server.xml. En ese elemento, hay un atributo llamado genericJvmArguments. Añada -XrunpiAgent:server=enabled al valor del atributo.
  3. Reinicie WAS.
     
 
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 con el siguiente formato:
   paquete/clase método modalidad

Aquí,

paquete/clase
Este campo se utiliza con el fin de especificar un patrón para un nombre de paquete o clase. El patrón debe especificarse como una serie sin blancos intercalados. La serie puede contener un único 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 se utiliza con el fin de especificar un patrón para el nombre de método. El patrón debe especificarse como una serie sin blancos intercalados y debe seguir las mismas reglas que el campo class.
modalidad
Este campo especifica si el paquete o clase que coincide con el patrón debe incluirse o excluirse del perfilado. 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 del controlador de agentes en la máquina de host.

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