Registrar Intervalos do APM como Eventos de JFR

O Agente do APM e o Rastreador do APM suportam a gravação de intervalos do APM como Eventos de JFR.

No momento, o JDK 11 ou mais recente são suportados.

Esta seção é aplicável ao Agente do APM e abrange o seguinte:

Para obter informações sobre como gravar intervalos do APM como eventos de JFR ao usar o Rastreador do APM, consulte Registrar Intervalos do APM como Eventos de JFR em Configurar Rastreador Java do APM.

Observação

O Java Flight Recorder (JFR) é uma ferramenta para coletar dados de diagnóstico e criação de perfil sobre um aplicativo Java em execução. Para obter informações sobre o Java Flight Recorder (JFR) e o Java Mission Control (JMC), consulte JDK Mission Control.

Capturar Eventos do APM em Gravações de JFR

Para capturar eventos do APM em gravações de JFR ao usar o Agente do APM, siga estas etapas:

  1. Verifique se o Agente do APM está funcionando corretamente.

    Abra o Trace Explorer e confirme se você pode exibir todos os rastreamentos. Para obter informações sobre como abrir e usar o Trace Explorer, consulte Monitorar Rastreamentos no Trace Explorer.

  2. Revise o arquivo de propriedades do Agente do APM.

    O arquivo AgentConfig.properties é o arquivo de propriedades do Agente do APM localizado no diretório oracle-apm-agent/config/<version>.

    A propriedade com.oracle.apm.agent.tracer.enable.jfr ativa ou desativa a adição de eventos do APM em gravações de JFR que são disponibilizadas.

    O valor padrão da propriedade com.oracle.apm.agent.tracer.enable.jfr é TRUE, que indica que os eventos do APM já estão ativados nas gravações de JFR.

    Para desativar eventos do APM em gravações de JFR, defina a propriedade com.oracle.apm.agent.tracer.enable.jfr como FALSE.

  3. Inicie uma gravação.

    Para testar se tudo está funcionando corretamente, você precisa iniciar uma gravação usando o seu método preferencial (Pode ser usando a interface de usuário do JDK Mission Control ou o utilitário de linha de comando JCMD).

    Para verificar se os eventos de rastreamento do APM foram adicionados corretamente às gravações de JFR, conecte-se ao JDK Mission Control e confirme se os rastreamentos do APM estão visíveis no Browser do Eventos: clique em OpenTracing do APM e confirme se os eventos de rastreamento do APM estão visíveis.