Definindo o Perfil de um Aplicativo no Modo Autônomo

As Informações a Seguir Aplicam-se ao Windows. As Informações a Seguir Aplicam-se ao AIX. As Informações a Seguir Aplicam-se ao Linux. As Informações a Seguir Aplicam-se ao Solaris. É possível traçar o perfil de um aplicativo no modo independente (ou seja, a partir da linha de comandos), sem ter a Test and Performance Tools Platform instalada. Entretanto, é necessário ter o Agent Controller instalado na máquina em que o aplicativo a ter o perfil definido reside.

Você pode definir o perfil de um aplicativo no modo autônomo chamando o Java Profiling Agent, que é uma biblioteca que se conecta a uma JVM (Java Virtual Machine) para capturar e gravar o comportamento de seu aplicativo Java. A saída do agente está no formato de fragmentos XML.

Utilize a opção -Xrun de Java para chamar o Java Profiling Agent:

    -XrunpiAgent:agent_parm[,agent_parm]*

Por exemplo, para o perfil PerformanceExample.java, utilizando filtros definidos no arquivo myFilters.txt e direcionando os dados da sessão de definição de perfil para um arquivo denominado PEProfilingData, você digitaria o seguinte em uma linha de comandos:
    java -XrunpiAgent:server=standalone,filters=myFilters.txt,file=PEProfilingData.trcxml PerformanceExample

Nota: Se você deseja iniciar o WebSphere Application Server Versão 6 (WAS) no modo de traçado de perfil a partir da linha de comandos, será necessário executar as seguintes etapas:
  1. Vá para <profile root>/config/cells/<nodename>Cell/nodes/<nodename>/servers/server1
  2. Edite o elemento jvmEntries no arquivo server.xml. Nesse elemento, há um atributo denominado genericJvmArguments. Anexe -XrunpiAgent:server=enabled ao valor do atributo.
  3. Reinicie o WAS.
     
 
Aumentando o parâmetro -XrunpiAgent você pode especificar vários modos diferentes para executar o agente de definição de perfil. O parâmetro agent_parm pode assumir um dos seguintes valores:

Formato do Arquivo de Filtro de Classe

O arquivo de filtro deve especificar três campos, pacote/classe, método e modo no seguinte formato:
   pacote/classe método modo

em que:

pacote/classe
Este campo é usado para especificar um padrão para um pacote ou um nome de classe. O padrão deve ser especificado como uma cadeia sem espaços em branco incorporados. A cadeia pode conter um único asterisco (*) no início ou no final da cadeia, por exemplo, *.mypackage ou org.mycompany.*. O * corresponde a zero ou mais caracteres, tornando assim o modelo um prefixo genérico ou um sufixo padrão. Um único * também pode ser especificado para representar todas as cadeias.
método
Este campo é usado para especificar um padrão para o nome do método. O padrão deve ser especificado como uma cadeia sem espaços em branco incorporados e com as mesmas regras de especificação do campo classe.
mode
Este campo especifica se o pacote ou a classe correspondente ao padrão deve ser incluída ou excluída no traçado de perfil. O valor do modo é INCLUDE ou EXCLUDE.

Os modelos de filtro são processados na ordem especificada até que a primeira correspondência de modelo seja bem-sucedida.  Se o nome da classe não corresponde a nenhum dos padrões de filtros especificados, o padrão é INCLUDE a classe.

Controle do Java Profiling Agent

Quando o Java Profiling Agent é iniciado com o parâmetro server=enabled ou server=controlled, a comunicação com o agente é feita utilizando o workbench do cliente por meio do Agent Controller na máquina do host.

Notas

Conceitos Relacionados
Visão Geral da Ferramenta de Definição de Perfil
Recursos de Definição de Perfil

Tarefas Relacionadas
Definindo o Perfil de um Aplicativo no Modo Autônomo no AS/400
Iniciando ou Anexando um Processo Java
Utilizando a Visualização Monitor do Traçado de Perfil