Azubarev: Новая страница: «= Мониторинг Apache ActiveMQ = Расширение предназначено для мониторинга брокеров Apache ActiveMQ Classic через JMX. Оно собирает показатели брокеров, очередей и топиков непосредственно из Java-процесса, контролируемого ЕдинымАгентом. Расширение предназначено для Apache Active...»

2026-09-25T19:43:35Z

Новая страница: «= Мониторинг Apache ActiveMQ = Расширение предназначено для мониторинга брокеров Apache ActiveMQ Classic через JMX. Оно собирает показатели брокеров, очередей и топиков непосредственно из Java-процесса, контролируемого ЕдинымАгентом. Расширение предназначено для Apache Active...»

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

= Мониторинг Apache ActiveMQ =

Расширение предназначено для мониторинга брокеров Apache ActiveMQ Classic через JMX. Оно собирает показатели брокеров, очередей и топиков непосредственно из Java-процесса, контролируемого ЕдинымАгентом.

Расширение предназначено для Apache ActiveMQ Classic. Apache ActiveMQ Artemis использует другую структуру MBean и данным расширением не поддерживается.

{| class="wikitable"
! Параметр
! Значение
|-
| Версия расширения
| <code>1.2.0</code>
|-
| Идентификатор
| <code>ru.ruscomtech.extension.jmx-activemq</code>
|-
| Минимальная версия Ключ-АСТРОМ
| <code>1.309.0</code>
|-
| Минимальная версия EEC
| <code>1.273.0</code>
|-
| Источник данных
| JMX
|}

== Возможности расширения ==

* Мониторинг брокеров Apache ActiveMQ Classic.
* Контроль очередей и топиков.
* Сбор количества поставленных, извлечённых, отправленных и просроченных сообщений.
* Контроль размера очередей и сообщений в обработке.
* Мониторинг подключений, производителей и потребителей.
* Контроль использования памяти, постоянного и временного хранилища.
* Получение состояния работоспособности брокера.
* Создание связанных сущностей брокеров, очередей и топиков.
* Связывание брокера с хостом и экземпляром Java-процесса.
* Готовые обзорные панели и страницы анализа сущностей.

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

Для работы расширения необходимы:

* ЕдиныйАгент на сервере, где запущен брокер ActiveMQ.
* Мониторинг Java-процесса брокера.
* Включённая функция <code>Java Metric Extensions 2.0 (JMX)</code>.
* Включённый JMX в конфигурации ActiveMQ.
* Ключ-АСТРОМ версии <code>1.309.0</code> или новее.

Для корректного изменения состояния метрики <code>activeMQ.BrokerHealthStatus</code> рекомендуется использовать ЕдиныйАгент версии <code>1.313</code> или новее. В более ранних версиях состояние этой метрики может не обновляться.

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

== Подготовка ActiveMQ ==

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

<pre>
<broker useJmx="true" brokerName="broker1">
<managementContext>
<managementContext createConnector="false"/>
</managementContext>
</broker>
</pre>

Параметр <code>brokerName</code> должен содержать уникальное имя брокера.

Значение <code>createConnector="false"</code> оставляет MBean в локальном сервере управления Java. Создавать удалённый JMX-коннектор для работы расширения не требуется.

После изменения конфигурации перезапустите брокер.

== Установка расширения ==

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

Перезапуск брокера после установки самого расширения обычно не требуется.

== Конфигурация ==

Расширение не содержит endpoint с адресом и портом. После установки необходимо выбрать наборы метрик, которые должны собираться из контролируемых процессов ActiveMQ.

{| class="wikitable"
! Набор
! Назначение
|-
| <code>usage-metrics</code>
| Показатели очередей и топиков: размер очереди, сообщения, потребители и время обработки.
|-
| <code>broker-connections</code>
| Подключения, производители и потребители брокера.
|-
| <code>broker-limits</code>
| Использование памяти, постоянного и временного хранилища.
|-
| <code>broker-health</code>
| Текущее состояние работоспособности брокера.
|}

Для полного мониторинга рекомендуется включить все четыре набора.

Расширение поддерживает как современный формат MBean:

<pre>
org.apache.activemq:type=Broker,brokerName=*
</pre>

так и формат, используемый старыми версиями ActiveMQ Classic 5:

<pre>
org.apache.activemq:Type=Broker,BrokerName=*
</pre>

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

=== Очереди и топики ===

{| class="wikitable"
! Метрика
! Описание
|-
| <code>activeMQ.QueueSize</code>
| Текущее количество сообщений в очереди.
|-
| <code>activeMQ.AverageEnqueueTime</code>
| Среднее время нахождения сообщения в очереди.
|-
| <code>activeMQ.AverageEnqueueTimeIncrease.count</code>
| Изменение среднего времени нахождения сообщения в очереди.
|-
| <code>activeMQ.EnqueueCount.count</code>
| Количество сообщений, добавленных в очередь или топик.
|-
| <code>activeMQ.DequeueCount.count</code>
| Количество извлечённых сообщений.
|-
| <code>activeMQ.DispatchCount.count</code>
| Количество сообщений, отправленных потребителям.
|-
| <code>activeMQ.ExpiredCount.count</code>
| Количество сообщений с истёкшим сроком действия.
|-
| <code>activeMQ.InFlightCount.count</code>
| Количество отправленных, но ещё не подтверждённых сообщений.
|-
| <code>activeMQ.ConsumerCount</code>
| Текущее количество потребителей очереди.
|}

=== Подключения брокера ===

{| class="wikitable"
! Метрика
! Описание
|-
| <code>activeMQ.CurrentConnectionsCount</code>
| Текущее количество активных подключений.
|-
| <code>activeMQ.TotalConnectionsCount</code>
| Общее количество подключений к брокеру.
|-
| <code>activeMQ.TotalProducerCount</code>
| Количество производителей сообщений.
|-
| <code>activeMQ.TotalConsumerCount</code>
| Количество потребителей сообщений.
|}

=== Использование ресурсов ===

{| class="wikitable"
! Метрика
! Описание
|-
| <code>activeMQ.MemoryPercentUsage</code>
| Процент использования памяти брокером.
|-
| <code>activeMQ.StorePercentUsage</code>
| Процент использования постоянного хранилища.
|-
| <code>activeMQ.TempPercentUsage</code>
| Процент использования временного хранилища.
|}

=== Состояние брокера ===

{| class="wikitable"
! Метрика
! Описание
|-
| <code>activeMQ.BrokerHealthStatus</code>
| Состояние работоспособности брокера. Значение метрики постоянно равно <code>1</code>, а фактическое состояние передаётся в измерении <code>status</code>.
|}

== Создаваемые сущности ==

{| class="wikitable"
! Тип
! Назначение
|-
| <code>activemq:broker</code>
| Брокер Apache ActiveMQ.
|-
| <code>activemq:queue</code>
| Очередь брокера.
|-
| <code>activemq:topic</code>
| Топик брокера.
|}

Очереди и топики связываются с родительским брокером. Брокер связывается с соответствующим хостом и экземпляром Java-процесса.

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

После активации расширения:

# Откройте контролируемый Java-процесс ActiveMQ.
# Проверьте состояние расширения JMX.
# Убедитесь, что доступны MBean домена <code>org.apache.activemq</code>.
# Откройте обзорную панель Apache ActiveMQ.
# Проверьте появление сущностей брокера, очередей и топиков.
# Убедитесь, что поступают метрики с префиксом <code>activeMQ.</code>.

== Устранение неполадок ==

{| class="wikitable"
! Проблема
! Решение
|-
| Брокер не обнаружен
| Проверьте установку ЕдиныйАгента и мониторинг Java-процесса брокера.
|-
| Метрики JMX отсутствуют
| Убедитесь, что включена функция <code>Java Metric Extensions 2.0 (JMX)</code>.
|-
| MBean ActiveMQ отсутствуют
| Проверьте параметр <code>useJmx="true"</code> и перезапустите брокер.
|-
| Собирается только часть метрик
| Проверьте, что в конфигурации включены необходимые наборы метрик.
|-
| Не создаются очереди или топики
| Проверьте наличие MBean с параметрами <code>destinationType</code> и <code>destinationName</code>.
|-
| Состояние брокера не изменяется
| Обновите ЕдиныйАгент до версии <code>1.313</code> или новее.
|-
| Не отображаются отдельные временные очереди
| Проверьте, что ActiveMQ не исключает их MBean с помощью параметра <code>suppressMBean</code>.
|}

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

{| class="wikitable"
! Версия
! Изменения
|-
|1.2.0
|
* Ключ-АСТРОМ <code>1.309.0+</code>.
* Добавлен атрибут контекста безопасности для создаваемых сущностей.
* Добавлена обзорная панель для приложения работы с панелями.
* Обновлены страницы анализа брокеров, очередей и топиков.
* Добавлена поддержка представления сущностей и метрик в новом интерфейсе платформы.
|}

Мониторинг Apache ActiveMQ - История изменений