Расширение IBM MQ

Материал из Документация Ключ-АСТРОМ

Контролируйте производительность объектов менеджера очередей IBM MQ.

Обзор

Благодаря выпуску Extensions Framework 2.0 расширения IBM MQ собирайте показатели производительности от ваших менеджеров очередей, работающих локально на вашем хосте ЕдиногоАгента или удаленно с ваших АктивныхШлюзов.

В эту версию включены новые метаданные и метрики.

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

(8994D60F-DC0B-46AF-8B61-1B53E9FF0DC5).png

Для объектов диспетчера очередей предусмотрен экран унифицированного анализа, содержащий всю необходимую информацию о диспетчере очередей — в одном месте.

(FAE49B46-3330-4FBC-9F42-A811D3B2EBA7).png

На экране UA диспетчера очередей перечислены все очереди и каналы, принадлежащие диспетчеру очередей.

(2E5E398A-471C-4AC9-B6D2-6558D28F16EF).png

Экран UA диспетчера очередей также содержит информацию о теме и размере логов.

(2C2B141B-D76B-4AF9-999C-079D17135B85).png

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

(96DFA14C-E3AA-4956-A177-19D2C35B7A15).png

При использовании локального развертывания (ЕдиныйАгент) на экране унифицированного анализа очереди отображается связь с существующими обнаруженными сущностями.

(BF6C8BF9-2DE6-4B96-A5B4-BD3358439803).png

Экран унифицированного анализа для объекта Очередь будет отображать другую информацию, если расширение развернуто удаленно.

(245E5B80-8E63-4125-A094-D3F5BB2E2F75).png

Для сущностей канала предусмотрен экран UA, на котором отображается важная метрическая информация для выбранного канала.

(84350D13-30D4-4976-83A5-EE34165B784D).png

Старт

Требования:

Развертывание ЕдиногоАгента:

  • ЕдиныйАгент только для Windows или Linux.
  • ЕдиныйАгент должен быть запущен и отслеживать процессы менеджера очередей.
  • Ключ-АСТРОМ версии 1.269+
  • IBM MQ 9.1+. IBM прекратила поддержку версии 9.0.x с 2021 году.
  • Сервер IBM MQ Command должен быть запущен на менеджерах очередей.
  • Библиотеки MQ должны быть указаны в переменной PATH в Windows или в переменной LD_LIBRARY_PATH в Linux. Пользователь, запускающий расширение, должен иметь возможность найти эти библиотеки.

Дополнительные требования для систем Linux:

  • Пользователь, работающий с ЕдинымАгентом (по умолчанию dtuser), также должен иметь права на чтение директорий менеджера очередей /var/mqm/qmgrs/<queue_manager> и на чтение/запись директорий логов /var/mqm/log, чтобы можно было выполнить привязку должным образом.
  • Убедитесь, что библиотеки MQ доступны пользователю dtuser, от имени которого запущена ваша служба ЕдиныйАгент. Расположение этих библиотек по умолчанию: /opt/mqm/lib64
  • По умолчанию IBM MQ устанавливает файл ldconfig с именем /etc/ld.so.conf.d/mqm.conf, который добавляет /usr/lib64 в переменную LD_LIBRARY_PATH. Убедитесь, что в этом пути есть символические ссылки библиотек IBM MQ на /opt/mqm/lib64. Если в каталоге /usr/lib64 нет ссылок на библиотеки /opt/mqm/lib64, возможно, вам придётся создать собственный файл .conf и поместить его в директорию /etc/ld.so.conf.d/.
  • Использование ldconfig позволит загружать библиотеки MQ по умолчанию. Для этого выполните следующие действия:
    • Создайте файл .conf в директории /etc/ld.so.conf.d/ с любым именем. Пример: ibmmq_ext.conf
    • Внутри этого файла введите местоположение библиотек IBM MQ: /opt/mqm/lib64
    • Сохраните файл
    • Перезагрузите ldconfig, выполнив команду: ldconfig

Развертывание АктивногоШлюза:

  • АктивныйШлюз на Windows или Linux
  • Ключ-АСТРОМ версии 1.269+
  • IBM MQ 9.1+. IBM прекратила поддержку версии 9.0.x с 2021 года.
  • Сервер IBM MQ Command должен быть запущен на менеджерах очередей.
  • Поддерживаются IBM MQ на платформах AIX, z/OS, Linux, Windows, zLinux и MQ Appliance. Возможно, он будет работать и на других ОС, но официально они могут не поддерживаться.
  • Канал связи с сервером для связи с каждым менеджером очередей. Он необходим для любого клиентского подключения к IBM MQ.
  • Межсетевой экран от АктивныхШлюзов к менеджерам очередей должен быть открыт. Менеджер очередей может работать на любом порту, поэтому убедитесь, что эти порты открыты для ваших АктивныхШлюзов. Обратитесь к администратору MQ, чтобы узнать эти порты.

Подробности

Аутентификация:

В IBM MQ предусмотрено несколько способов аутентификации клиентских и локальных подключений. Выбор способа определяется администратором вашей среды MQ в соответствии с его политиками безопасности.

Аутентификация пользователя зависит от конфигурации аутентификации канала (CHLAUTH). Если эта функция отключена или отключена ADOPTCTX, IBM MQ попытается аутентифицировать пользователя, запускающего процесс расширения, а не пользователя, указанного в конфигурации конечной точки.

Если включено ADOPTCTX и включено CHLAUTH, комбинация имени пользователя и пароля, введенная в конечной точке, передается в блок MQCSP, который IBM MQ попытается аутентифицировать.

  • Пожалуйста, примите это во внимание при аутентификации пользователей или в случае возникновения ошибок.

Разрешения пользователей к объектам MQ (распределенные)

(B1EB5EC6-3BE6-4E6F-A09B-568DD459A612).png

  • Разрешение CHG требуется только для сбора метрик постановки/вывода из очереди . Метрики постановки/вывода из очереди можно получить только после выполнения команды RESET_Q_STATISTICS, поэтому требуются разрешения CHG. Если вы не можете предоставить это разрешение, убедитесь, что вы сняли выбор этих метрик на странице Наборы функций в конфигурации мониторинга.