Иногда JIRA может «зависнуть» во время выполнения операции. В течение этого времени полезно получить дамп потока - журнал, содержащий информацию о текущих выполняемых потоках и процессах в виртуальной машине Java. Взятие дампов потоков -является неразрушающим процессом, который можно запускать в живых системах. В этом документе описаны шаги, необходимые для получения дампа потока.
Шаги, необходимые для получения дампа потока, зависят от операционной системы JIRA, выполняемой в соответствии с приведенными ниже инструкциями.
Среда Windows
Запуск JIRA от startup.bat
- В окне командной консоли, где запущена JIRA, откройте диалоговое окно свойств, щелкнув правой кнопкой мыши на строке заголовка и выберите «Свойства».
- Выберите вкладку «Макет».
- В разделе «Размер буфера экрана» установите значение «Высота» на «3000».
- Нажмите «ОК».
- С той же командной консолью в фокусе нажмите CTRL-BREAK. Это выведет дамп потока в коммандную консоль.
- Выполните прокрутку назад в командной консоли, пока не достигнете строки, содержащей «Полный дамп потока».
- Щелкните правой кнопкой мыши строку заголовка и выберите «Редактировать» -> «Отметить». Выделите весь текст дампа потока.
- Щелкните правой кнопкой мыши строку заголовка и выберите «Правка» -> «Копировать». Затем дамп потока можно вставить в текстовый файл.
Запуск JIRA как службы Windows
Использование jstackJDK поставляется с инструментом jstack для создания дампов потоков.
- Определите процесс. Запустите диспетчер задач, нажав Ctrl + Shift + Esc и найдите идентификатор процесса Java (JIRA). Вам может понадобиться добавить столбец PID с помощью View -> Select Columns ...
- Запустите jstack <pid>, чтобы захватить одиночный дамп потока. Эта команда примет один дамп потока идентификатора процесса <pid>, в этом случае pid равен 22668:
C:\Users\Administrator>jstack.exe -l 22668 > threaddump.txt
Это выведет файл с именем threaddump.txt в ваш текущий каталог.
Общие проблемы с jstack:
- Вы должны запустить jstack как тот же пользователь, который запускает JIRA.
- Если вы получите сообщение об ошибке «Недостаточно памяти для обработки этой команды», загрузите здесь утилиту «psexec», а затем запустите следующую команду:psexec -s jstack <pid> >> threaddumps.txt
- Если исполняемый файл jstack не находится в вашем $ PATH, то, пожалуйста, найдите его в каталоге <JDK_HOME> / bin
- Если вы получаете java.lang.NoClassDefFoundError: sun / tools / jstack / JStack, проверьте, что tools.jar присутствует в вашем каталоге lib JDK. Если это не так, загрузите полную версию JDK.
Окружающая среда Linux / Unix / OS X
Командная строка Linux / Unix
- Определите java-процесс, в котором работает JIRA. Этого можно добиться, выполнив команду, аналогичную:
ps -ef | grep java
Процесс будет выглядеть следующим образом:
keithb 910 873 1 17:01 pts/3 00:00:18 /usr/java/jdk/bin/java -Xms128m -Xmx256m
-Xms128m -Xmx256m -Djava.awt.headless=true -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
-Djava.awt.headless=true -Djava.endorsed.dirs=/tmp/atlassian-jira-enterprise-3.6-standalone/common/endorsed
-classpath :
- Чтобы получить дамп потока, выполните команду
kill -3 <pid>
где pid - это идентификатор процесса - в этом случае 910.
- Дамп потока будет записан на вывод консоли Tomcat. Консольный вывод перенаправляется в файл logs / catalina.out, который можно найти в каталоге установки JIRA-приложения для JIRA Standalone / Installer.
Linux / Unix Alternative: создание дампов потоков с использованием jstack
Если у вас возникли проблемы с использованием kill -3 <pid> для получения дампа потока, попробуйте использовать jstack утилиту java, которая будет выводить трассировки стека потоков Java для данного процесса.
- Определите javaprocess, в котором работает JIRA. Этого можно добиться, выполнив команду, аналогичную:
ps -ef | grep java
- Процесс будет выглядеть следующим образом:
adam 22668 0.3 14.9 1691788 903928 ? Sl Jan27 9:36 /usr/lib/jvm/java-6-sun-1.6.0.14/bin/java -Djava.util.logging.config.file=/home/adam/Products/installs/atlassian-jira-enterprise-4.0.1-standalone/conf/logging.properties -XX:MaxPermSize=256m -Xms128m -Xmx1048m -Djava.awt.headless=true -Datlassian.standalone=JIRA -Dorg.apache.jasper.runtime.BodyContentImpl.LIMIT_BUFFER=true -Dmail.mime.decodeparameters=true -Datlassian.mail.senddisabled=false -Datlassian.mail.fetchdisabled=false -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Djava.endorsed.dirs=/home/adam/Products/installs/atlassian-jira-enterprise-4.0.1-standalone/common/endorsed -classpath /home/adam/Products/installs/atlassian-jira-enterprise-4.0.1-standalone/bin/bootstrap.jar -Dcatalina.base=/home/adam/Products/installs/atlassian-jira-enterprise-4.0.1-standalone -Dcatalina.home=/home/adam/Products/installs/atlassian-jira-enterprise-4.0.1-standalone -Djava.io.tmpdir=/home/adam/Products/installs/atlassian-jira-enterprise-4.0.1-standalone/temp org.apache.catalina.startup.Bootstrap start
- Запустите jstack <pid>, чтобы захватить одиночный дамп потока
Эта команда возьмет один дамп потока id процесса <pid>, в этом случае pid будет 22668 и выведет выход в файл JIRAthreaddump.txt
adam@jiratrack:~$ jstack 22668 > JIRAthreaddump.txt
- Возьмите несколько дампов потоков
Как правило, вы захотите взять несколько дампов на расстоянии около 10 секунд, и в этом случае вы можете создать несколько дампов и вывести трассировки стека в один файл следующим образом:
adam@jiratrack:~$ jstack 22668 >> JIRAthreaddump.txt
adam@jiratrack:~$ jstack 22668 >> JIRAthreaddump.txt
adam@jiratrack:~$ jstack 22668 >> JIRAthreaddump.txt
Если вы подключаетесь к серверу через RDP, jstack может завершиться сбоем со следующей ошибкой:
Not enough storage is available to process this command
Недостаточно памяти для обработки этой команды
Вам нужно будет открыть сеанс RDP в консольном режиме: mstsc / admin
Linux / Unix Alternative: создание дампов потоков с использованием сценариев
Вы также можете создать дамп потока, используя сценарии, подготовленные нашей службой поддержки. Это простой процесс, и скрипты сделают все для вас. В дополнение к созданию дампа потока скрипты также позволяют создавать кучи дампов, проверять скорость доступа к диску или соединение с Java SSL.
- (Необязательно) Установите плагин Thready, если он поддерживается вашей версией JIRA. Thready переименовывает потоки Tomcat для включения URL-адреса, который они обслуживают, что упростит анализ потоков.
- Загрузите и установите скрипты с https://bitbucket.org/atlassianlabs/atlassian-support/.
- Выполняйте сценарии, когда ваш экземпляр JIRA ведет себя медленно или не отвечает.
- (Необязательно) Сценарии также позволяют протестировать скорость доступа к диску. Это описано более подробно в разделе Тестирование скорости доступа к диску.
- Когда вас спросят, хотите ли вы захватить дампы потоков, введите Y.
- Когда вас спросят, хотите ли вы захватить кучи кучи, введите N.
- (Необязательно) Сценарии также позволяют проверять соединение Java SSL.
- После запуска скриптов дамп потока будет захвачен и сжат. Теперь вы можете открыть билет поддержки и прикрепить созданный пакет.
Инструменты анализа
Попробуйте TDA или Samurai проверить ваш дамп потока.
TDA
- Загрузите TDA.
- CD в каталог, в котором существует JAR.
- Запустите:
java -jar -Xmx512M ~/tda-bin-1.6/tda.jar
- Откройте файл catalina.out, содержащий дамп потока.
Ошибка обработки дампа обработки с помощью TDA (NumberFormatException)
Если вы получите сообщение об ошибке на консоли TDA, например:
Exception in thread "AWT-EventQueue-0" java.lang.NumberFormatException: For input string: "5 os_prio=0"
at java.lang.NumberFormatException.forInputString(NumberFormatException.java:65)
at java.lang.Long.parseLong(Long.java:441)
at java.lang.Long.(Long.java:702)
at com.pironet.tda.utils.ThreadsTableModel.getValueAt(ThreadsTableModel.java:80)
at com.pironet.tda.utils.TableSorter.getValueAt(TableSorter.java:285)
at javax.swing.JTable.getValueAt(JTable.java:2717)
at javax.swing.JTable.prepareRenderer(JTable.java:5719)
at javax.swing.plaf.basic.BasicTableUI.paintCell(BasicTableUI.java:2114)
at javax.swing.plaf.basic.BasicTableUI.paintCells(BasicTableUI.java:2016)
at javax.swing.plaf.basic.BasicTableUI.paint(BasicTableUI.java:1812)
at javax.swing.plaf.ComponentUI.update(ComponentUI.java:161)
at javax.swing.JComponent.paintComponent(JComponent.java:778)
at javax.swing.JComponent.paint(JComponent.java:1054)
at javax.swing.JComponent.paintChildren(JComponent.java:887)
at javax.swing.JComponent.paint(JComponent.java:1063)
at javax.swing.JViewport.paint(JViewport.java:731)
at javax.swing.JComponent.paintChildren(JComponent.java:887)
at javax.swing.JComponent.paint(JComponent.java:1063)
at javax.swing.JComponent.paintChildren(JComponent.java:887)
at javax.swing.JSplitPane.paintChildren(JSplitPane.java:1047)
at javax.swing.JComponent.paint(JComponent.java:1063)
at javax.swing.JComponent.paintToOffscreen(JComponent.java:5230)
at javax.swing.BufferStrategyPaintManager.paint(BufferStrategyPaintManager.java:295)
at javax.swing.RepaintManager.paint(RepaintManager.java:1249)
at javax.swing.JComponent._paintImmediately(JComponent.java:5178)
at javax.swing.JComponent.paintImmediately(JComponent.java:4989)
at javax.swing.RepaintManager$3.run(RepaintManager.java:808)
at javax.swing.RepaintManager$3.run(RepaintManager.java:796)
at java.security.AccessController.doPrivileged(Native Method)
at java.security.ProtectionDomain$1.doIntersectionPrivilege(ProtectionDomain.java:76)
at javax.swing.RepaintManager.paintDirtyRegions(RepaintManager.java:796)
at javax.swing.RepaintManager.paintDirtyRegions(RepaintManager.java:769)
at javax.swing.RepaintManager.prePaintDirtyRegions(RepaintManager.java:718)
at javax.swing.RepaintManager.access$1100(RepaintManager.java:62)
at javax.swing.RepaintManager$ProcessingRunnable.run(RepaintManager.java:1677)
at java.awt.event.InvocationEvent.dispatch(InvocationEvent.java:312)
at java.awt.EventQueue.dispatchEventImpl(EventQueue.java:733)
at java.awt.EventQueue.access$200(EventQueue.java:103)
at java.awt.EventQueue$3.run(EventQueue.java:694)
at java.awt.EventQueue$3.run(EventQueue.java:692)
at java.security.AccessController.doPrivileged(Native Method)
at java.security.ProtectionDomain$1.doIntersectionPrivilege(ProtectionDomain.java:76)
at java.awt.EventQueue.dispatchEvent(EventQueue.java:703)
at java.awt.EventDispatchThread.pumpOneEventForFilters(EventDispatchThread.java:242)
at java.awt.EventDispatchThread.pumpEventsForFilter(EventDispatchThread.java:161)
at java.awt.EventDispatchThread.pumpEventsForHierarchy(EventDispatchThread.java:150)
at java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:146)
at java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:138)
at java.awt.EventDispatchThread.run(EventDispatchThread.java:91)
Примените следующую команду в дампах потоков, чтобы исправить формат заголовка потока, чтобы сделать его обрабатываемым:
sed -i 's/prio=[0-9]\{1,2\} os_prio=[0-9]\{1,2\}/prio=5/g' <filename>
СВЕРНУТО:
sed -i '' 's/prio=[0-9]\{1,2\} os_prio=[0-9]\{1,2\}/prio=5/g' <filename>