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

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

Обзор

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

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

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

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

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

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

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

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

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

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

Начало работы

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

• ЕдиныйАгент только для 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 (распределенные)

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

Разрешения пользователей к объектам MQ (z/OS)

Примечание : разрешение CONTROL требуется только при сборе показателей постановки в очередь/вывода из очереди.

Сбор показателей постановки/вывода из очереди:

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

• Количество сообщений в очереди: количество сообщений, помещённых в очередь. Это количество включает сообщения, которые были помещены в очередь, но ещё не были зафиксированы.
• Количество сообщений, извлеченных из очереди: количество сообщений, извлеченных из очереди. Это количество включает сообщения, которые были успешно извлечены из очереди (с помощью MQGET-запроса без просмотра), даже если MQGET-запрос ещё не был зафиксирован.
• Скорость постановки в очередь: количество сообщений, помещаемых в очередь в секунду.
• Скорость извлечения из очереди: количество сообщений, извлекаемых из очереди в секунду.

Сбор показателей состояния очереди:

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

• Самое старое сообщение: возраст в секундах самого старого сообщения в очереди.
• Последний GET: время, когда последнее сообщение было успешно прочитано из очереди.
• Last PUT: Время, когда последнее сообщение было успешно помещено в очередь.
• Индикатор короткого времени: количество времени, которое сообщение провело в очереди за короткий период.
• Индикатор длительного времени: количество времени, в течение которого сообщение находилось в очереди в течение длительного периода.

Конфигурация Ключ-АСТРОМ

В Расширения левом меню выберите IBM MQ.

• Добавьте конфигурацию мониторинга. Развертывание ЕдиногоАгента, также называемое локальным, может выполняться на определённом хосте, группах хостов, хостах в менеджмент зонах или на отмеченных хостах. Развертывание АктивногоШлюза, также называемое удалённым, выполняется на группах АктивногоШлюза. Для повышения надёжности группы могут включать один или несколько АктивныхШлюзов.

Для локального развертывания (ЕдиныйАгент):

• Выберите, на каких хостах будет запущено это расширение
  • Уровень логов: включайте DEBUG только в том случае, если специалисты по устранению неполадок или служба поддержки дают такую ​​рекомендацию.
  • Добавить менеджер очередей: все менеджеры очередей, соответствующие фильтру, будут использовать эту конфигурацию. Вы можете создать отдельную конфигурацию для каждого менеджера очередей на хосте или одну конфигурацию для всех менеджеров очередей на этом хосте.
  • Фильтр менеджера очередей: имя, соответствующее этому фильтру, будет сопоставляться с запущенными процессами на этом хосте. Если имя соответствует этому фильтру, к нему будут применены все настройки этой конечной точки конфигурации.
  • Использовать хранилище учётных данных: это позволит вам выбрать имя пользователя и пароль, хранящиеся в хранилище учётных данных Ключ-АСТРОМ. При использовании этой функции любые имя пользователя и пароль, введённые вручную, будут игнорироваться, и будут использоваться только учётные данные, хранящиеся в хранилище.
  • Пользователь: необязательно, но рекомендуется добавить пользователя. В противном случае, если оставить поле пустым, IBM MQ попытается аутентифицировать пользователя dtuser, запускающего процесс, по умолчанию.
  • Пароль: Пароль указанного выше пользователя.
  • Объекты для мониторинга: два способа добавления объектов.
    • Используя новый режим, просто нажимайте кнопки для ввода правил. Если есть объект, который вы совершенно не хотите отслеживать, удалите это правило.
    • В расширенном режиме добавьте фильтры, разделяя их запятыми, под каждой вкладкой. Наведите указатель мыши на значок (i) рядом с каждым типом объекта, чтобы увидеть правила и примеры.
    • Примечание: Правила оцениваются последовательно. Таким образом, вы можете включать или исключать объекты из результата предыдущего правила. Например: *, -SYSTEM.*, SYSTEM.CLUSTER* включит все очереди, а затем удалит те, которые начинаются с SYSTEM, а затем включит те, которые начинаются с SYSTEM.CLUSTER. Обратите особое внимание на порядок ввода правил, независимо от того, используете ли вы обычный или расширенный режим .
  • Отправлять событие логов для очереди недоставленных сообщений: включите этот параметр, чтобы любое событие DLQ в любом менеджере очередей, соответствующем этой конфигурации, запускало событие логов, указывающее на то, что количество сообщений в очереди DLQ превысило пороговое значение. Вы можете создать оповещение на основе этого события логов.
  • Отправлять событие логов при высокой глубине очереди из менеджера очередей: включите этот параметр, чтобы любая соответствующая очередь в любом менеджере очередей в этой конфигурации запускала событие логов при превышении заданного порогового значения глубины. Этот порог настраивается в IBM MQ.
  • Отправлять событие логов при малой глубине очереди из менеджера очередей: включите этот параметр, чтобы любая соответствующая очередь в любом менеджере очередей в этой конфигурации запускала событие логов, если её заданная глубина ниже порогового значения. Это пороговое значение настраивается в IBM MQ.
  • Извлечь топологию для улучшенной трассировки транзакций: включение этого параметра позволит собирать сопоставления для псевдонимов очередей, удалённых очередей и очередей кластера. Эти сопоставления затем отправляются в Ключ-АСТРОМ для дополнения информации о сопоставлениях для улучшенной трассировки транзакций. Сбор этой информации может потребоваться только один раз, если сопоставления в IBM MQ не меняются часто. Если этот параметр включён, введите токен Ключ-АСТРОМ для взаимодействия с API со следующими разрешениями: Read settings, Write settings.
  • Переименовать менеджеров очередей: включение этого параметра позволит вам добавлять псевдонимы к менеджерам очередей, соответствующим вашему фильтру (см. выше). Настоящее имя менеджера очередей будет по-прежнему включено в название. Это необходимо только для того, чтобы различать менеджеры очередей с похожими или одинаковыми именами в Ключ-АСТРОМ. Это не приведёт к переименованию менеджеров очередей в IBM MQ.
  • Массовый запрос метрик: включение этого параметра сократит количество запросов к IBM MQ и позволит собирать метрики для очередей и каналов за меньшее количество запросов, тем самым сокращая время и потенциальную нагрузку на процессор. Однако этот параметр потребует предоставления разрешений на все очереди и все каналы, включая объекты SYSTEM. Этот параметр не подходит для крупных сред с большим количеством очередей или каналов.
  • Наконец, выберите, какие наборы характеристик (группы метрик) должна собирать эта конфигурация. Выбор слишком малого количества не обеспечит необходимого уровня прозрачности и может привести к потере важных данных о производительности, а также ключевых показателей, которые можно сопоставить между различными объектами.

Для удаленного развертывания (АктивныйШлюз):

• Выберите, какая группа АктивныхШлюзов будет запускать это расширение
  • Уровень логов: включайте DEBUG только в том случае, если специалисты по устранению неполадок или служба поддержки дают такую ​​рекомендацию.
  • Размер контейнера задач: по умолчанию все конечные точки, определённые в конфигурации мониторинга, создают задачу. Используйте этот параметр для создания отдельных задач для групп конечных точек, определённых в конфигурации мониторинга. Это позволит оптимизировать использование ресурсов вашего АктивногоШлюза и потенциально распределить выполнение задач между другими АктивнымиШлюзами в вашей группе.
  • Добавить менеджер очередей: нажмите эту кнопку для каждого менеджера очередей, который вы хотите подключить. Рекомендуется использовать несколько менеджеров очередей на группу АктивныхШлюзов.
  • Хосты, разделённые запятыми: Большинство менеджеров очередей работают на одном хосте, но бывают случаи, когда у вас есть многоэкземплярные менеджеры очередей, работающие на нескольких хостах. Введите здесь этот хост и порт или список хостов и портов, разделённых запятыми, для этого менеджера очередей.
  • Название менеджера очередей: введите название менеджера очередей, к которому вы подключаетесь. Это обязательное поле.
  • Канал подключения к серверу: любое клиентское приложение, например это расширение, подключающееся к IBM MQ, должно взаимодействовать с менеджером очередей через канал. Введите здесь имя этого канала подключения к серверу.
  • Использовать хранилище учётных данных: это позволит вам выбрать имя пользователя и пароль, хранящиеся в хранилище учётных данных Ключ-АСТРОМ. При использовании этой функции любые имя пользователя и пароль, введённые вручную, будут игнорироваться, и будут использоваться только учётные данные, хранящиеся в хранилище.
  • Имя пользователя: необязательно, но рекомендуется добавить пользователя. Имя пользователя всегда указывается, но в зависимости от конфигурации менеджера очередей в IBM MQ его можно игнорировать или аутентифицировать пользователя в этом поле. Рекомендуется всегда указывать имя пользователя.
  • Пароль: Пароль указанного выше пользователя.
  • Использовать SSL: включите этот параметр, чтобы установить TLS-соединение между расширением (клиентом) и сервером MQ. Поддерживается как односторонняя, так и двусторонняя аутентификация, которая полностью обрабатывается сервером IBM MQ. Расширение всегда предоставляет сертификат, и IBM MQ принимает решение о его принятии или отклонении.
  • Очередь моделей: необязательно. Если не задано, будет использоваться системная очередь моделей по умолчанию для запросов и ответов команд.
  • Префикс ответа: Если вы ввели модель очереди, необходимо ввести префикс для очереди ответа.
  • Объекты для мониторинга: два способа добавления объектов.
    • Используя новый режим, просто нажимайте кнопки для ввода правил. Если есть объект, который вы совершенно не хотите отслеживать, удалите это правило.
    • В расширенном режиме добавьте фильтры, разделяя их запятыми, под каждой вкладкой. Наведите указатель мыши на значок (i) рядом с каждым типом объекта, чтобы увидеть правила и примеры.
    • Примечание: Правила оцениваются последовательно. Таким образом, вы можете включать или исключать объекты из результата предыдущего правила. Например: *, -SYSTEM.*, SYSTEM.CLUSTER* включит все очереди, а затем удалит те, которые начинаются с SYSTEM, а затем включит те, которые начинаются с SYSTEM.CLUSTER. Обратите особое внимание на порядок ввода правил, независимо от того, используете ли вы обычный или расширенный режим.
  • Отправлять событие логов для очереди недоставленных сообщений: включите этот параметр, чтобы любое событие DLQ в любом менеджере очередей, соответствующем этой конфигурации, запускало событие логов, указывающее на то, что количество сообщений в очереди DLQ превысило пороговое значение. Вы можете создать оповещение на основе этого события логов.
  • Отправлять событие логов при высокой глубине очереди из менеджера очередей: включите этот параметр, чтобы любая соответствующая очередь в любом менеджере очередей в этой конфигурации запускала событие логов при превышении заданного порогового значения глубины. Этот порог настраивается в IBM MQ.
  • Отправлять событие логов при малой глубине очереди из менеджера очередей: включите этот параметр, чтобы любая соответствующая очередь в любом менеджере очередей в этой конфигурации запускала событие логов, если её заданная глубина ниже порогового значения. Это пороговое значение настраивается в IBM MQ.
  • Извлечь топологию для улучшенной трассировки транзакций: включение этого параметра позволит собирать сопоставления для псевдонимов очередей, удалённых очередей и очередей кластера. Эти сопоставления затем отправляются в Ключ-АСТРОМ для дополнения информации о сопоставлениях для улучшенной трассировки транзакций. Сбор этой информации может потребоваться только один раз, если сопоставления в IBM MQ не меняются часто. Если этот параметр включён, введите токен Ключ-АСТРОМ для взаимодействия с API со следующими разрешениями: Read settings, Write settings.
  • Переименовать менеджеров очередей: включение этого параметра позволит вам добавлять псевдонимы к менеджерам очередей, соответствующим вашему фильтру (см. выше). Настоящее имя менеджера очередей будет по-прежнему включено в название. Это необходимо только для того, чтобы различать менеджеры очередей с похожими или одинаковыми именами в Ключ-АСТРОМ. Это не приведёт к переименованию менеджеров очередей в IBM MQ.
  • Массовый запрос метрик: включение этого параметра сократит количество запросов к IBM MQ и позволит собирать метрики для очередей и каналов за меньшее количество запросов, тем самым сокращая время и потенциальную нагрузку на процессор. Однако этот параметр потребует предоставления разрешений на все очереди и все каналы, включая объекты SYSTEM. Этот параметр не подходит для крупных сред с большим количеством очередей или каналов.
  • Отключить автоматическое оповещение: автоматическое создание проблем при сбоях будет отключено. Ошибки по-прежнему будут регистрироваться как события, но не будут вызывать проблемы. Если вы хотите создавать проблемы, вам потребуется создать правила для их запуска из событий логов.
  • Наконец, выберите, какие наборы характеристик (группы метрик) должна собирать эта конфигурация. Выбор слишком малого количества не обеспечит необходимого уровня прозрачности и может привести к потере важных данных о производительности, а также ключевых показателей, которые можно сопоставить между различными объектами.

Варианты использования

• Мониторинг инфраструктуры IBM MQ, включая менеджеры очередей, очереди, каналы, темы.
• Получайте оповещения, если диспетчер очередей недавно был запущен, недоступен, имеет каналы повторных попыток и т. д.
• Контролируйте свой IBM MQ, развернув его локально на контролируемом хосте ЕдиногоАгента или удаленно с помощью АктивногоШлюза.

Информация о совместимости

Более подробную информацию о совместимости можно найти в разделе Начало работы.

Часто задаваемые вопросы и устранение неполадок

Сколько DDU он будет потреблять в год?

Ниже приведены приблизительные значения. Метрики меняются в зависимости от типа объектов. Некоторые метрики доступны не для всех каналов, некоторые — не для всех очередей.

Например:

1      Queue manager 400    Local queues 20     Alias and remote queues 50     Channels 1      Listener 50     Topics ( 10 + (400 * 16) + (20 * 2) + (50 * 18) + (1 * 1) + (50 * 4) ) * 1 * 525.6 = (10 + 6400 + 40 + 900 + 1 + 200)  * 525.6 = approximately 3.9M DDUs per year

Не видны все показатели очереди

Некоторые метрики зависят от типа очередей. Другие — от настроек вашего менеджера очередей и наличия у вашего пользователя достаточных прав для их сбора.

• Вам не хватает Enqueue и Dequeue? Убедитесь, что у вашего пользователя есть разрешение CHG на очередях, чтобы сбросить статистику. Только после этого вы сможете получать метрики Enqueue и Dequeue.
• Не хватает самого старого сообщения и последнего получения? Убедитесь, что мониторинг статистики включён в менеджере очередей для всех очередей.
• Вы рассматриваете очереди Alias ​​или Remote? Метрики состояния есть только у локальных очередей. У Alias ​​и Remote есть только метрики запрета GET/PUT.

Ошибки - Неавторизованный пользователь

Проверьте сам менеджер очередей AMQERR01.LOG. В этом файле логов будет указано, какие именно данные он пытался аутентифицировать и каких прав не хватает. Если вам не удаётся подключиться к менеджеру очередей, убедитесь, что у пользователя, запускающего процесс расширения, есть разрешения на доступ к менеджеру очередей ADOPTCTX, или что расширение CHLAUTH включено, чтобы аутентифицировать комбинацию имени пользователя и пароля, переданную в блоке MQCSP.

Ошибка pymqe, сообщающая, что libmqm_r.so не найден

Это означает, что библиотеки IBM MQ не найдены в переменной PATH в Unix. Убедитесь, что вы выполнили шаги ldconfig, описанные выше в разделе «Локальное развёртывание».

Другие распространенные ошибки и их значения

MQRC_HOST_NOT_AVAILABLE: Менеджер очередей недоступен из вашего АктивногоШлюза. Обычно это означает отсутствие правила брандмауэра. Поскольку менеджер очередей может работать на пользовательском порту, необходимо убедиться, что параметр host:port доступен из АктивногоШлюза, на котором запущено расширение.

MQRC_NO_MSG_AVAILABLE: Ответ от вашего менеджера очередей пришёл слишком поздно, и ответ оказался пустым. Это может произойти, если размер очереди ответов (MAX LENGTH) недостаточен для размещения полезной нагрузки ответа. Вы можете попробовать увеличить это значение. Это также может быть вызвано тайм-аутом или несвоевременным ответом менеджера очередей.

MQRC_CONNECTION_BROKEN: Соединение с менеджером очередей разорвано либо из-за сбоя в работе сети, либо из-за того, что менеджер очередей его закрыл. Убедитесь, что производительность сети оптимальна. Кроме того, если вы используете SSL, убедитесь, что вы не используете устаревший шифр TLS, требующий ручного сброса ключей TLS, например, шифры TLS 1.2 AES-GCM. Переключитесь на шифр TLS 1.3 с автоматическим сбросом ключей TLS.