Traçado de 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. Você pode definir o perfil do seu aplicativo no modo independente (ou seja, a partir da linha de comandos), sem ter as ferramentas Hyades instaladas. 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 traçado 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

Aumentando o parâmetro -XrunpiAgent você pode especificar vários modos diferentes para executar o agente de traçado 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 internos. 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
Esta 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 internos 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 do 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 Traçado de Perfil
Recursos de Traçado de Perfil

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