Azubarev: Новая страница: «= RabbitMQ = Расширение предназначено для мониторинга кластеров RabbitMQ через Management HTTP API. Собираются показатели кластера, отдельных узлов, виртуальных хостов и очередей. Расширение также создаёт связанные сущности RabbitMQ и добавляет готовую обзорную панель....»

2026-09-29T00:03:55Z

Новая страница: «= RabbitMQ = Расширение предназначено для мониторинга кластеров RabbitMQ через Management HTTP API. Собираются показатели кластера, отдельных узлов, виртуальных хостов и очередей. Расширение также создаёт связанные сущности RabbitMQ и добавляет готовую обзорную панель....»

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

= RabbitMQ =

Расширение предназначено для мониторинга кластеров RabbitMQ через Management HTTP API.

Собираются показатели кластера, отдельных узлов, виртуальных хостов и очередей. Расширение также создаёт связанные сущности RabbitMQ и добавляет готовую обзорную панель.

'''Идентификатор расширения:''' <code>ru.ruscomtech.rabbitmq</code>

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

* мониторинг кластера RabbitMQ;
* мониторинг состояния узлов;
* контроль количества и состояния сообщений;
* мониторинг очередей и потребителей;
* сбор статистики публикации, доставки и повторной доставки сообщений;
* контроль памяти, дискового пространства, файловых дескрипторов и сокетов;
* мониторинг виртуальных хостов;
* фильтрация собираемых очередей по регулярным выражениям;
* резервный список адресов RabbitMQ Management API;
* использование Credential Vault;
* локальный или удалённый сбор данных.

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

* На RabbitMQ должен быть включён плагин <code>rabbitmq_management</code>.
* HTTP API должен быть доступен с сервера EEC или с хоста, на котором выполняется локальный сбор.
* Пользователь должен иметь тег <code>monitoring</code> и доступ к необходимым виртуальным хостам.
* Для аутентификации используется имя пользователя и пароль.
* Если RabbitMQ использует HTTPS, сертификат должен быть доверенным либо необходимо указать файл внутреннего центра сертификации.

Расширение использует следующие методы Management API:

* <code>/api/overview</code>;
* <code>/api/queues</code>;
* <code>/api/nodes</code>;
* <code>/api/vhosts</code>.

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

Включите Management Plugin:

<pre>
rabbitmq-plugins enable rabbitmq_management
</pre>

По умолчанию Management API использует следующие порты:

* <code>15672</code> — HTTP;
* <code>15671</code> — HTTPS, если настроен TLS.

=== Создание пользователя мониторинга ===

Пример создания отдельного пользователя:

<pre>
rabbitmqctl add_user monitoring <password>
rabbitmqctl set_user_tags monitoring monitoring
rabbitmqctl set_permissions --vhost / monitoring "^$" "^$" "^$"
</pre>

Для мониторинга нескольких виртуальных хостов выполните команду <code>set_permissions</code> для каждого из них.

Проверьте доступ к Management API:

<pre>
curl -u monitoring http://rabbitmq-01.example.local:15672/api/overview
</pre>

Команда запросит пароль пользователя и должна вернуть описание кластера в формате JSON.

'''Важно:''' расширение использует Basic-аутентификацию. Если в RabbitMQ установлено <code>management.disable_basic_auth = true</code>, созданная конфигурация не сможет подключиться.

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

# Скачайте пакет расширения.
# В интерфейсе Ключ-АСТРОМ откройте раздел управления расширениями.
# Загрузите архив расширения.
# Откройте расширение <code>ru.ruscomtech.rabbitmq</code>.
# Добавьте конфигурацию мониторинга.
# Выберите локальный или удалённый режим выполнения.
# Для удалённого режима выберите группу EEC.
# Заполните параметры подключения.
# Выберите необходимые наборы функций.
# Сохраните и активируйте конфигурацию.

== Настройка подключения ==

{| class="wikitable"
! Параметр
! Описание
|-
| Cluster name
| Понятное уникальное имя кластера. Оно используется в измерениях метрик и идентификаторах сущностей.
|-
| Nodes
| Один или несколько базовых URL RabbitMQ Management API. Путь <code>/api</code> добавлять не нужно.
|-
| Use Credential Vault
| Включите, если имя пользователя и пароль должны храниться в Credential Vault.
|-
| Select vault credentials
| Учётная запись типа username/password с областью Extension authentication.
|-
| Username
| Пользователь RabbitMQ с тегом <code>monitoring</code>. Заполняется, если Credential Vault не используется.
|-
| Password
| Пароль пользователя RabbitMQ. Заполняется, если Credential Vault не используется.
|-
| Queues to monitor
| Список регулярных выражений для выбора очередей.
|-
| Verify Server Certificate
| Проверка TLS-сертификата RabbitMQ.
|-
| CA Certificate Location
| Путь к файлу сертификата внутреннего центра сертификации.
|}

Пример списка узлов:

<pre>
https://rabbitmq-01.example.local:15671
https://rabbitmq-02.example.local:15671
https://rabbitmq-03.example.local:15671
</pre>

Расширение проверяет адреса по порядку и подключается к первому доступному. Для кластера можно также указать один адрес балансировщика нагрузки.

Файл, заданный в поле «CA Certificate Location», должен существовать на сервере, где выполняется расширение.

== Фильтрация очередей ==

По умолчанию используется выражение:

<pre>
.*
</pre>

Оно включает все доступные очереди.

Пример мониторинга только очередей с префиксом <code>orders.</code>:

<pre>
^orders\.
</pre>

Пример выбора нескольких отдельных очередей:

<pre>
^orders\.created$
^orders\.processed$
^payments$
</pre>

При большом количестве очередей рекомендуется ограничивать список: каждая очередь создаёт отдельную сущность и набор временных рядов.

== Наборы функций ==

{| class="wikitable"
! Набор
! Назначение
|-
| Cluster
| Общие показатели кластера: сообщения, соединения, каналы, очереди, обменники, потребители и скорость обработки сообщений.
|-
| Node
| Ресурсы узлов: память, диск, файловые дескрипторы, сокеты, сетевые разделения, время работы и сборка мусора.
|-
| Queue
| Размер и состояние очередей, память, потребители, публикация, доставка, повторная доставка и сообщения без маршрута.
|-
| Virtual Host
| Сообщения и сетевой трафик виртуальных хостов.
|}

Для базового контроля рекомендуется включить <code>Cluster</code> и <code>Node</code>. Набор <code>Queue</code> следует включать с учётом количества очередей.

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

{| class="wikitable"
! Группа
! Метрики
! Назначение
|-
| Кластер
| <code>rabbitmq.cluster.messages</code> 
<code>rabbitmq.cluster.messages_ready</code> 
<code>rabbitmq.cluster.messages_unacknowledged</code> 
<code>rabbitmq.cluster.connections</code> 
<code>rabbitmq.cluster.consumers</code> 
<code>rabbitmq.cluster.publish.count</code> 
<code>rabbitmq.cluster.deliver_get.count</code>
| Состояние очередей и общий поток сообщений в кластере.
|-
| Узлы
| <code>rabbitmq.node.mem_used</code> 
<code>rabbitmq.node.mem_limit</code> 
<code>rabbitmq.node.disk_free</code> 
<code>rabbitmq.node.fd_used</code> 
<code>rabbitmq.node.sockets_used</code> 
<code>rabbitmq.node.partitions</code> 
<code>rabbitmq.node.uptime</code>
| Использование ресурсов и состояние отдельных узлов.
|-
| Очереди
| <code>rabbitmq.queue.messages</code> 
<code>rabbitmq.queue.messages_ready</code> 
<code>rabbitmq.queue.messages_unacknowledged</code> 
<code>rabbitmq.queue.consumers</code> 
<code>rabbitmq.queue.publish.count</code> 
<code>rabbitmq.queue.redeliver.count</code> 
<code>rabbitmq.queue.drop_unroutable.count</code>
| Размер очередей, потребители и движение сообщений.
|-
| Виртуальные хосты
| <code>rabbitmq.vhost.messages</code> 
<code>rabbitmq.vhost.messages_ready</code> 
<code>rabbitmq.vhost.messages_unacknowledged</code> 
<code>rabbitmq.vhost.recv_oct.count</code> 
<code>rabbitmq.vhost.send_oct.count</code>
| Количество сообщений и сетевой трафик виртуальных хостов.
|}

== Сущности и топология ==

Расширение создаёт следующие сущности:

* '''Cluster''' — кластер RabbitMQ;
* '''Node''' — узел кластера;
* '''Virtual Host''' — виртуальный хост;
* '''Queue''' — очередь RabbitMQ.

Между сущностями создаются связи:

* Node работает в Cluster;
* Virtual Host относится к Cluster;
* Queue работает на Node;
* Queue относится к Virtual Host.

При наличии подходящего IP-адреса узел RabbitMQ связывается с соответствующим хостом Ключ-АСТРОМ.

== Обзорная панель ==

В состав расширения входит готовая обзорная панель RabbitMQ. Она отображает:

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

Расширение также добавляет страницы сущностей для кластеров, узлов, виртуальных хостов и очередей.

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

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

* проверка подключения завершается успешно;
* выбранный адрес Management API доступен с EEC или контролируемого хоста;
* пользователь получает ответы от <code>/api/overview</code>, <code>/api/nodes</code>, <code>/api/vhosts</code> и <code>/api/queues</code>;
* появляются метрики <code>rabbitmq.cluster.*</code>;
* создаётся сущность RabbitMQ Cluster;
* при включённых наборах появляются Node, Virtual Host и Queue;
* данные отображаются на обзорной панели.

Если кластерные метрики поступают, но очереди отсутствуют, проверьте права пользователя на виртуальные хосты и выражения в поле «Queues to monitor».

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

{| class="wikitable"
! Версия
! Изменения
|-
| 2.1.5
|
* Добавлен сбор данных через RabbitMQ Management HTTP API.
* Добавлены наборы Cluster, Node, Queue и Virtual Host.
* Добавлены резервные адреса узлов и поддержка Credential Vault.
* Добавлены сущности RabbitMQ и связи между ними.
* Добавлена готовая обзорная панель.
|}

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