Azubarev: Новая страница: «= Tomcat JMX = Расширение предназначено для сбора показателей пулов подключений, пулов потоков и обработки веб-запросов Apache Tomcat через JMX. Идентификатор: `ru.ruscomtech.extension.jmx-tomcat-cp` == Возможности == Расширение выполняет: * мониторинг пулов подключений Tomcat; *...»

2026-09-29T00:29:14Z

Новая страница: «= Tomcat JMX = Расширение предназначено для сбора показателей пулов подключений, пулов потоков и обработки веб-запросов Apache Tomcat через JMX. Идентификатор: <code>ru.ruscomtech.extension.jmx-tomcat-cp</code> == Возможности == Расширение выполняет: * мониторинг пулов подключений Tomcat; *...»

Новая страница

= Tomcat JMX =

Расширение предназначено для сбора показателей пулов подключений, пулов потоков и обработки веб-запросов Apache Tomcat через JMX.

Идентификатор: <code>ru.ruscomtech.extension.jmx-tomcat-cp</code>

== Возможности ==

Расширение выполняет:

* мониторинг пулов подключений Tomcat;
* сбор статистики веб-запросов и ошибок;
* мониторинг загрузки пулов потоков;
* обнаружение зависших потоков;
* расчёт доступных подключений и текущей загрузки пула;
* создание отдельных сущностей для пулов подключений;
* связывание пулов подключений с процессами Tomcat;
* формирование готовых обзорных панелей.

== Требования ==

Перед настройкой расширения убедитесь, что:

* ЕдиныйАгент установлен на хосте с процессом Tomcat;
* активирована функция <code>Java Metric Extensions 2.0 (JMX)</code>;
* после первого включения функции процесс Tomcat перезапущен;
* необходимые MBeans зарегистрированы в домене <code>Catalina</code>;
* для сбора метрик пулов подключений используется стандартная реализация пула подключений Tomcat.

Расширение получает данные непосредственно из контролируемого Java-процесса. Отдельно настраивать удалённый адрес, порт или учётную запись JMX не требуется.

== Используемые MBeans ==

Для пулов подключений используются MBeans:

<pre>
Catalina:type=DataSource,name=*,class=*,context=*,host=*
Catalina:type=DataSource,name=*,class=*
</pre>

Вторая форма используется для глобальных источников данных, у которых отсутствуют свойства <code>context</code> и <code>host</code>.

Для пулов потоков:

<pre>
Catalina:type=ThreadPool,name=*,*
</pre>

Для статистики веб-запросов:

<pre>
Catalina:type=GlobalRequestProcessor,name=*,*
</pre>

Для зависших потоков:

<pre>
Catalina:type=Valve,name=StuckThreadDetectionValve,host=*,*
</pre>

Метрика зависших потоков доступна только при использовании <code>StuckThreadDetectionValve</code>.

== Установка и настройка ==

# Загрузите пакет расширения в Ключ-АСТРОМ.
# Убедитесь, что на хосте с Tomcat установлен и подключён ЕдиныйАгент.
# В настройках функций ЕдиногоАгента включите <code>Java Metric Extensions 2.0 (JMX)</code>.
# Перезапустите процесс Tomcat после первого включения функции.
# Создайте конфигурацию расширения.
# Выберите необходимые наборы метрик.
# Ограничьте область действия конфигурации нужными хостами или группами хостов.
# Сохраните и активируйте конфигурацию.

== Наборы метрик ==

{| class="wikitable"
! Набор
! Описание
|-
| <code>key-metrics</code>
| Основные показатели пула: активные, созданные, свободные и ожидающие подключения.
|-
| <code>limits</code>
| Настроенные ограничения пула подключений.
|-
| <code>additional-metrics</code>
| Количество полученных, возвращённых, освобождённых и повторно подключённых соединений.
|-
| <code>web-requests</code>
| Количество запросов, ошибок, переданных данных и время обработки.
|-
| <code>thread-pools</code>
| Текущее и максимальное количество потоков, а также количество занятых потоков.
|-
| <code>stuck-threads</code>
| Количество зависших потоков Tomcat.
|}

Рекомендуется сначала включить наборы <code>key-metrics</code>, <code>web-requests</code> и <code>thread-pools</code>. Остальные наборы можно подключить при необходимости.

== Основные метрики ==

{| class="wikitable"
! Группа
! Примеры метрик
! Описание
|-
| Пулы подключений
| <code>tomcat.connectionPool.activeConnections</code> <code>tomcat.connectionPool.idleConnections</code> <code>tomcat.connectionPool.numWaiters</code>
| Активные, свободные и ожидающие подключения.
|-
| Ограничения пула
| <code>tomcat.connectionPool.maxActive</code> <code>tomcat.connectionPool.maxTotal</code> <code>tomcat.connectionPool.maxWait</code>
| Максимальное количество подключений и время ожидания.
|-
| Веб-запросы
| <code>tomcat.requestCount.count</code> <code>tomcat.errorCount.count</code> <code>tomcat.processingTime.count</code>
| Количество запросов и ошибок, а также суммарное время обработки.
|-
| Передача данных
| <code>tomcat.bytesReceived.count</code> <code>tomcat.bytesSent.count</code>
| Количество полученных и отправленных байтов.
|-
| Пулы потоков
| <code>tomcat.threadPool.currentThreadCount</code> <code>tomcat.threadPool.currentThreadsBusy</code> <code>tomcat.threadPool.maxThreads</code>
| Текущее, занятое и максимально допустимое количество потоков.
|-
| Зависшие потоки
| <code>tomcat.stuckThreads</code>
| Количество потоков, определённых Tomcat как зависшие.
|}

== Расчётные метрики ==

Расширение содержит дополнительные расчётные показатели:

{| class="wikitable"
! Метрика
! Описание
|-
| <code>func:tomcat.processingTimePerRequest</code>
| Среднее время обработки одного запроса.
|-
| <code>func:tomcat.requestCountPerSecond</code>
| Количество запросов в секунду.
|-
| <code>func:tomcat.errorCountPerSecond</code>
| Количество ошибок в секунду.
|-
| <code>func:tomcat.bytesReceivedPerSecond</code>
| Количество полученных байтов в секунду.
|-
| <code>func:tomcat.bytesSentPerSecond</code>
| Количество отправленных байтов в секунду.
|-
| <code>func:tomcat.threadPool.utilization</code>
| Процент использования пула потоков.
|-
| <code>func:tomcat.connectionPool.availableConnections</code>
| Расчётное количество доступных подключений.
|-
| <code>func:tomcat.connectionPool.currentUsage</code>
| Текущая загрузка пула подключений в процентах.
|}

== Обнаруживаемые сущности ==

Для каждого обнаруженного пула подключений создаётся сущность <code>Tomcat Connection Pool</code>.

Имя сущности формируется из имени источника данных. Пул подключений автоматически связывается с соответствующим экземпляром процесса Tomcat.

== Обзорные панели ==

В состав расширения входят готовые обзорные панели, содержащие:

* список обнаруженных пулов подключений;
* количество активных и созданных подключений;
* загрузку пулов потоков;
* количество запросов и ошибок;
* среднее время обработки запросов.

== Проверка работы ==

После активации конфигурации убедитесь, что:

* процесс Tomcat отображается в Ключ-АСТРОМ;
* поступают метрики с префиксами <code>tomcat.connectionPool</code>, <code>tomcat.threadPool</code> или <code>tomcat.requestCount</code>;
* созданы сущности <code>Tomcat Connection Pool</code>;
* обзорная панель содержит данные контролируемого процесса.

Наличие необходимых MBeans можно проверить с помощью JConsole или другого клиента JMX.

== Устранение неисправностей ==

{| class="wikitable"
! Проблема
! Возможная причина и решение
|-
| Метрики Tomcat не поступают
| Проверьте, что функция <code>Java Metric Extensions 2.0 (JMX)</code> включена, а процесс Tomcat был перезапущен.
|-
| Отсутствуют метрики пула подключений
| Проверьте наличие MBeans <code>Catalina:type=DataSource</code>. Другие реализации пулов подключений могут использовать несовместимые MBeans.
|-
| Отсутствуют метрики веб-запросов
| Проверьте наличие MBeans <code>Catalina:type=GlobalRequestProcessor</code> и включение набора <code>web-requests</code>.
|-
| Отсутствуют метрики потоков
| Проверьте наличие MBeans <code>Catalina:type=ThreadPool</code> и включение набора <code>thread-pools</code>.
|-
| Метрика зависших потоков отсутствует
| Убедитесь, что в Tomcat настроен <code>StuckThreadDetectionValve</code> и включён набор <code>stuck-threads</code>.
|-
| Сущность пула не создаётся
| Проверьте поступление метрики <code>tomcat.connectionPool.activeConnections</code> и наличие измерения <code>name</code>.
|}

== История изменений ==

{| class="wikitable"
! Версия
! Изменения
|-
| 2.2.3
|Добавлены новые экраны и обзорные панели.
|-
| 2.2.1
|
* Расширение дополнено показателями сервера приложений.
* Добавлены наборы метрик пулов потоков и веб-запросов.
|-

|}

Tomcat JMX - История изменений