Documentação

Tirar despejos de thread de uma JVM

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Um despejo de thread é uma lista de todas as threads Java atualmente ativas em uma Java Virtual Machine (JVM). Este artigo discute as várias maneiras de obter despejos de thread de uma JVM no Adobe Experience Manager.

Descrição description

Ambiente

Adobe Experience Manager

Problema/Sintomas

Como obter despejos de thread de uma JVM no Linux, UNIX ou Windows?

Um despejo de thread é uma lista de todas as threads Java atualmente ativas em uma Java Virtual Machine (JVM).

Há várias maneiras de retirar despejos de thread de uma JVM. É altamente recomendável usar mais de 1 despejo de thread. Uma prática recomendada é realizar 10 despejos de thread em um intervalo regular (por exemplo, um despejo de thread a cada dez segundos).

Resolução resolution

Etapa 1: Obtenha o PID do seu processo Java

A primeira informação que você precisará para obter um despejo de thread é o PID do processo Java.

O JDK do Java vem com o comando jps, que lista todas as IDs do processo Java. Você pode executar esse comando da seguinte maneira:

jps -l 70660 sun.tools.jps.Jps 70305

Observação: no Linux e no UNIX, talvez seja necessário executar este comando como sudo -u user jps -l, onde "usuário" é o nome de usuário do usuário com o qual o processo Java está sendo executado.

Se isso não funcionar ou ainda não for possível encontrar o processo Java (caminho não definido, JDK não instalado ou versão mais antiga do Java), use

  • SO X UNIX, Linux e Mac: ps -el | grep java
  • Windows: pressione Ctrl+Shift+Esc para abrir o gerenciador de tarefas e localizar o PID do processo Java

Etapa 2: solicitar um despejo de thread da JVM

jstack

Se instalado/disponível, recomendamos usar a ferramenta jstack. Ele imprime despejos de thread no console da linha de comando.

Para obter um despejo de thread usando jstack, execute o seguinte comando:
jstack -l <pid>

Você pode enviar despejos de thread consecutivos para um arquivo usando a diretiva de redirecionamento/acréscimo de saída do console:
jstack -l <pid> >> threaddumps.log

Notas:

  • A ferramenta jstack está disponível desde o JDK 1.5 (para o JVM no Windows, ela está disponível somente em algumas versões do JDK 1.5 e JDK 1.6).

  • jstack funciona mesmo se o parâmetro jvm -Xrs estiver habilitado

  • Não é possível usar a ferramenta jstack do JDK 1.6 para remover threaddumps de um processo em execução no JDK 1.5.

  • No Linux e no UNIX, você precisa executar o comando como o usuário proprietário do processo java:
    sudo -u java-user jstack -l <pid>

    (< usuário Java> deve ser substituído pela ID do usuário com o qual o processo Java está sendo executado)

  • No Windows, se você executar o jstack e receber o erro "Não há armazenamento suficiente disponível para processar este comando", será necessário executar o jstack como o usuário SYSTEM do Windows ou o usuário proprietário do processo java. Você pode fazer isso usando psexec, que você pode baixar aqui. Para executar jstack como usuário SYSTEM, use um comando como este:

    psexec -s jstack <pid>   >> threaddumps.log

    Se não conseguir instalar o psexec no servidor, você poderá criar um arquivo .bat contendo o comando e executá-lo usando o agendador de tarefas do Windows (como um usuário diferente).

  • Se o processo java não estiver respondendo, às vezes pode ajudar a usar a opção -J-d64 (em sistemas de 64 bits), por exemplo:
    jstack -J-d64 -l   <pid>   >> threaddumps.log

  • Se o comando jstack (jstack -l <pid> >> threaddumps.log) lança o erro [ 1] abaixo, execute o comando como o usuário proprietário do processo java. Por exemplo:
    sudo -u sling jstack -l <pid> >> threaddumps.log

Error attaching to process: sun.jvm.hotspot.debugger.DebuggerException: Can't attach to the process: ptrace(PTRACE_ATTACH, ..) failed for 22893: Operation not permitted

sun.jvm.hotspot.debugger.DebuggerException: sun.jvm.hotspot.debugger.DebuggerException: Can't attach to the process: ptrace(PTRACE_ATTACH, ..) failed for 22893: Operation not permitted

...

Caused by: sun.jvm.hotspot.debugger.DebuggerException: Can't attach to the process: ptrace(PTRACE_ATTACH, ..) failed for 22893: Operation not permitted

...

sun.jvm.hotspot.debugger.linux.LinuxDebuggerLocal$LinuxDebuggerLocalWorkerThread.run(LinuxDebuggerLocal.java:138)

SCRIPT JSTACK

Este é um script (adaptado daquele em eclipse.org) que utiliza uma série de despejos de thread com o jstack. Ele também utiliza o uso da cpu em nível de thread usando o comando top.

Basta executá-lo assim:

sudo -u <user> jstackSeries.sh
<pid> <aemserveruser> <count> <delay>

Por exemplo: sudo -u aemuser jstackSeries.sh 1234 aemserveruser 10 3

  • 1234 é a pid do processo Java
  • cq5serveruser é o usuário Linux ou UNIX com o qual o processo Java é executado
  • 10 é a quantidade de despejos de encadeamento que devem ser executados
  • 3 é o atraso entre cada despejo

Observação: a saída superior tem a ID de thread nativa em formato decimal, enquanto a saída jstack tem a nid em hexadecimal. Você pode fazer a correspondência da thread de alta CPU da saída superior para a saída jstack convertendo a id da thread em hexadecimal.

Além do script acima, também temos um script semelhante do Windows Powershell e um script específico do Adobe AEM no github.

Maneiras alternativas de obter um despejo de encadeamento

Se a ferramenta jstack não estiver disponível para você, você poderá remover despejos de thread da seguinte maneira:

Observação: algumas ferramentas não poderão remover despejos de thread da JVM se o parâmetro de linha de comando -Xrs estiver habilitado. Se você tiver problemas ao fazer despejos de thread, verifique se essa opção está ativada.

UNIX, Mac OS X e Linux (JDK 1.4 ou versão anterior)

No UNIX, Mac OS X e Linux, você pode enviar um sinal QUIT para o processo Java para instruí-lo a produzir um dump de encadeamento para a saída padrão.

  1. Execute este comando para fazer isso:
    kill -QUIT <pid>

    Talvez seja necessário executar esse comando como sudo -u user kill -QUIT <pid>, onde "usuário" é o usuário com o qual o processo Java está sendo executado.

  2. Se você estiver iniciando o CQSE usando o script crx-quickstart/server/start, seus despejos de thread serão enviados para crx-quickstart/server/logs/startup.log. Se você estiver usando um servidor de aplicativos de terceiros, como JBoss, WebSphere, Tomcat ou outro, consulte a documentação do servidor para descobrir a qual arquivo a saída padrão é direcionada.

Windows:

JDK 1.X

  1. Baixar javadump.exe (anexado abaixo).
  2. Inicie a JVM com estes três argumentos (eles devem estar na ordem correta):
    -XX:+UnlockDiagnosticVMOptions -XX:+LogVMOutput -XX:LogFile= C:\temp\jvmoutput.log
  3. Pressione Ctrl+Shift+Esc para abrir o Gerenciador de tarefas.
  4. Localize o PID do processo Java.
  5. Na linha de comando, execute: javadump.exe   <pid>
  6. O despejo de thread aparecerá no arquivo jvmoutput.log mencionado na etapa 2.

JDK 1.6

Obtenha um despejo de thread da ferramenta jconsole usando um plug-in: [ 0]

Veja como solicitar um despejo de thread:

  1. Adicione o seguinte parâmetro ao Comunicado de execução do jvm:
    Dcom.sun.management.jmxremote
  2. Baixe e instale o JDK 1.6 (se ainda não tiver sido feito).
  3. Baixe e extraia o utilitário Analisador de Despejo de Thread. [ 1]
  4. Executar jconsole.exe do JDK 1.6:
    jconsole.exe -pluginpath /path/to/file/tda.jar
  5. Clique na guia Despejos de thread.
  6. Clique no link Solicitar Despejo de Thread.

Observação: se você estiver executando o AEM 6.x e quiser observar as threads em execução, poderá solicitar http://<host>:<port>/system/console/status-Threads a obtenção de uma lista de threads. No entanto, observe que esses despejos de thread não funcionarão com ferramentas de análise de despejo de thread, como samurai ou tda.

Aplica-se a:

Todos os produtos Adobe em execução em uma JVM

Ferramentas de análise de despejo de thread

[ 0] PsExec v2.42 em Sysinternals na documentação do Microsoft.

[ 1] TDA - Analisador de Despejo de Thread em irockel/tda em Github.com.

[ 2] Analisador de Despejo de Thread Java no FastThread.

[ 3] Analisador de thread e despejo de monitor do IBM para Java na Documentação do Assistente de Suporte da IBM.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f