В этой статье описывается, как выставлять JMX MBeans в JIRA для мониторинга с помощью JMX-клиента.
Что такое JMX?
JMX (Java Management Extensions) - это технология мониторинга и управления приложениями Java. JMX использует объекты, называемые MBeans (Managed Beans), чтобы выставлять данные и ресурсы из вашего приложения. Для больших экземпляров JIRA Server или JIRA Data Center включение JMX позволяет вам более легко контролировать потребление ресурсов приложений. Это позволяет вам принимать более эффективные решения о том, как поддерживать и оптимизировать ресурсы машины.
Метрики, собранные JIRA
В следующей таблице перечислены показатели (MBeans), которые собираются JIRA. Все они сгруппированы в собственность com.atlassian.jira.
|
Метрика |
Описание |
Сброс после перезапуска JIRA |
|
dashboard.view.count |
Количество просмотров всех панелей управления пользователями. |
Да |
|
entity.attachments.total |
Количество вложений. |
|
|
entity.components.total |
Количество компонент. |
|
|
entity.customfields.total |
Количество пользовательских полей. |
|
|
entity.filters.total |
Количество фильтров |
|
|
entity.groups.total |
Количество групп пользователей. |
|
|
entity.issues.total |
Количество задач. |
|
|
entity.users.total |
Количество пользователей. |
|
|
entity.versions.total |
Количество созданных версий. |
|
|
issue.assigned.count |
Количество раз назначения или переназначения задач пользователям (подсчитывает каждое действие). |
Да |
|
issue.created.count |
Количество задач, возникших после запуска экземпляра JIRA. |
Да |
|
issue.link.count |
Количество ссылок на задачу, созданных после запуска экземпляра JIRA. |
Да |
|
issue.search.count |
Количество раз, поиска вами задачи. |
|
|
issue.updated.count |
Количество повторных обновлений задач (каждое обновление после добавления или изменения некоторой информации). |
Да |
|
issue.worklogged.count |
Количество раз регистрирования работы по задаче. |
Да |
|
jira.license |
Типы лицензий, которые вы имеете, количество активных пользователей и максимальное количество пользователей, доступных для каждого типа лицензии |
|
|
quicksearch.concurrent.search |
Количество одновременных поисков, выполняемых в режиме реального времени с помощью быстрого поиска. Вы можете использовать его, чтобы определить, достаточен ли лимит, установленный для одновременных поисков, или должен быть увеличен. |
Да |
|
web.requests |
Количество запросов (requests) (invocation.count) и общее время отклика (total.elapsed.time). |
Да |
Мониторинг JIRA
Прежде чем вы сможете контролировать JIRA, вам необходимо включить мониторинг JMX, а затем использовать JMX-клиент для просмотра показателей.
Хорошо знать
Просмотр показателей всегда будет иметь некоторое влияние на производительность JIRA. Мы рекомендуем вам не обновлять их более одного раза в секунду.
Включение мониторинга JMX в JIRA
Все показатели собираются по умолчанию, но вам нужно включить мониторинг JMX, чтобы выставить их. Вы можете сделать это JIRA, но вам нужно быть администратором JIRA, чтобы туда добраться.
- В JIRA перейдите в шестеренка> System> JMX monitoring.
- Включите мониторинг JMX.
Мониторинг с помощью JConsole
После включения JMX-мониторинга вы можете использовать любой JMX-клиент для просмотра показателей. Чтобы сделать это быстро и просто, мы описали, как их просматривать, используя JConsole. Вы можете мониторировать свой экземпляр JIRA либо локально, либо удаленно:
- Мониторинг JIRA локально хорош, если вы устраняете неполадку в какой-либо конкретной задаче, или вам нужно просто контролировать JIRA на короткое время. Локальный мониторинг может оказывать влияние на ваш сервер, поэтому он не рекомендуется для долгосрочного мониторинга вашей производственной системы.
Чтобы мониторировать локально:
- Запустите JConsole (вы найдете его в каталоге bin каталога установки JDK).
- Выберите Локальный процесс.
- Выберите процесс JIRA. Он будет называться чем-то вроде org.apache.catalina.startup.Bootstrap start
- После подключения расширьте свойство com.atlassian.jira, которое группирует все показатели.
Дополнительную информацию о локальном мониторинге см. В разделе Использование JConsole.
- Мониторинг JIRA удаленно рекомендуется для производственных систем, так как он не потребляет ресурсы на вашем сервере JIRA.
Для удаленного мониторинга:
- Добавьте в свой файл setenv.sh / setenv.bat следующие свойства. Порт может быть любым портом, который не используется.
set CATALINA_OPTS=-Dcom.sun.management.jmxremote %CATALINA_OPTS% set CATALINA_OPTS=-Dcom.sun.management.jmxremote.port=8099 %CATALINA_OPTS%
- Решите, как вы будете защищать свое удаленное соединение. Дополнительную информацию см. В разделе «Удаленный мониторинг и управление».
Хотя можно отключить аутентификацию, мы не рекомендуем делать это в производственной системе.
- Запустите JConsole (вы найдете его в каталоге bin каталога установки JDK).
- Выберите «Удаленный процесс».
- Введите имя хоста и порт (это порт, который вы указали ранее, а не порт JIRA).
- Нажмите Connect.
- После подключения расширьте свойство com.atlassian.jira, которое группирует все показатели.
Дополнительную информацию о дистанционном мониторинге см. в разделе Использование JConsole.