IBM MQ

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

Обзор

В этой новой версии этого популярного расширения можно собирать показатели производительности от ваших менеджеров очередей, работающих локально на вашем хосте ЕдиныйАгент или удаленно с ваших АктивныйШлюзs. Собирайте метаданные и новые показатели в этой версии.

Метрики

Менеджер очередей

• Доступность: процент времени, в течение которого диспетчер очередей был доступен и доступен для этого расширения. Хотя администратор очередей иногда может быть запущен и работает, доступность находится в контексте этого расширения.
• Время работы: время в секундах с момента последнего запуска диспетчера очередей.
• Соединения: количество активных подключений к администратору очередей.
• Количество очередей: количество очередей, отслеживаемых расширением.
• Глубина DLQ: если DLQ включен, количество сообщений в очереди недоставленных сообщений.
• Активные каналы: количество каналов в активном состоянии.
• Использование журнала (только для распределенной версии): процентная оценка того, насколько хорошо рабочая нагрузка администратора очередей удерживается в основном пространстве журнала.
• Использование входа в систему (только для распределенной версии): процент основного пространства журнала, используемого для восстановления при перезапуске.
• Размер архива журнала (только для распределенной версии): объем места в мегабайтах, занимаемый экстентами журналов, которые больше не требуются для перезапуска или восстановления носителя, но ожидают архивирования.
• Размер повторного использования журнала (только для распределенной версии): объем пространства (в мегабайтах), занимаемого экстентами журнала, доступными для повторного использования.
• Общее количество наборов данных журнала (только для z/OS): общее количество активных наборов данных журнала.
• Полные наборы данных журнала (только для z/OS): общее количество полных активных наборов данных журнала, которые еще не были заархивированы.

Очереди

• Глубина : количество сообщений в очереди.
• Процент глубины: процент сообщений, заполняющих очередь.
• Inhibit GET : запрещает ли очередь MQGET.
• Inhibit PUT : запрещает ли очередь MQPUT.
• Открытые дескрипторы ввода : количество дескрипторов, открытых приложениями для ввода.
• Открытые дескрипторы вывода: количество дескрипторов, открытых приложениями для вывода.
• Незафиксированные сообщения: количество дескрипторов, открытых приложениями для вывода.

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

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

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

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

Каналы:

• Сообщения: количество отправленных или полученных сообщений или количество обработанных вызовов MQI.
• Отправлено байт: количество отправленных байтов.
• Получено байт: количество полученных байтов.
• Отправленные буферы: количество отправленных буферов.
• Полученные буферы: количество полученных буферов.
• Последнее отправленное сообщение: время отправки последнего сообщения или обработки вызова MQI.
• Под вопросом: находится ли канал в данный момент под вопросом. 0 = Нет. 1 = Да
• Сообщения, вызывающие сомнения: количество сообщений, вызывающих сомнения.
• Текущие общие беседы: количество активных в данный момент бесед в этом экземпляре канала. Этот параметр возвращается только для каналов подключения к серверу TCP/IP.
• Экземпляры канала: количество экземпляров этого канала. Эта метрика доступна только для каналов подключения к серверу.
• Пакеты: количество завершенных пакетов.
• Короткое время сети: количество времени в микросекундах, необходимое для отправки запроса на завершение пакетного запроса на удаленный конец канала и получения ответа в течение короткого периода времени.
• Время в сети: количество времени в микросекундах, необходимое для отправки запроса на завершение пакетного запроса на удаленный конец канала и получения ответа в течение более длительного периода.
• Короткое время очереди XMIT: время в микросекундах, в течение которого сообщения оставались в очереди передачи до их получения в течение короткого периода времени.
• Время в очереди XMIT: время в микросекундах, в течение которого сообщения оставались в очереди передачи до их получения в течение более длительного периода.
• Статус канала: используется для округления значений статуса канала в целях оповещения и построения диаграмм.
• Осталось длительных повторов: количество оставшихся длительных повторных попыток.
• Осталось коротких повторов: количество оставшихся коротких повторов.

Слушатели

• Доступность: процент работы и доступности этого прослушивателя.

Темы

• Количество публикаций: количество приложений, публикуемых в данный момент в этой теме.
• Количество подписок: количество подписчиков на эту строку темы, включая постоянных подписчиков, которые в данный момент не подключены.
• Запретить публикацию: разрешены ли публикации.
• Запретить подписку: разрешены ли подписки.

Использование (только z/OS)

• Всего страниц: общее количество страниц размером 4 КБ в наборе страниц.
• Число расширений: количество раз, когда набор страниц был динамически расширен с момента перезапуска.
• Неиспользуемые страницы: количество неиспользуемых страниц (то есть доступных наборов страниц).
• Страницы постоянных данных: количество страниц, содержащих постоянные данные.
• Страницы непостоянных данных: количество страниц, содержащих непостоянные данные.
• Свободные буферы пула: количество свободных буферов в пуле буферов.
• Процент свободных буферов пула: количество свободных буферов в процентах от всех буферов в пуле буферов.
• Всего буферов пула: количество буферов, определенных для указанного пула буферов.

Начать

Развертывание ЕдиныйАгент: (Для развертывания АктивныйШлюз см. ниже)

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

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

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

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

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

---

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

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

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

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

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

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

Примечание :

• Вышеуказанные разрешения должны быть предоставлены всем объектам, а не только тем, которые указаны в фильтрах расширений.
• Разрешение CHG требуется только при сборе показателей постановки в очередь/удаления из очереди.

Примечание :

• Вышеуказанные разрешения должны быть предоставлены всем объектам, а не только тем, которые указаны в фильтрах расширений.
• Разрешение CHG требуется только при сборе показателей постановки в очередь/удаления из очереди.

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

Примечание :

• Вышеуказанные разрешения должны быть предоставлены всем объектам, а не только тем, которые указаны в фильтрах расширений.
• Разрешение CONTROL требуется только при сборе метрик постановки в очередь/удаления из очереди.

---

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

ExtensionsВ меню слева выберите IBM MQ.

• Добавьте конфигурацию мониторинга.

Развертывание ЕдиныйАгент, также называемое «локальным», может выполняться на определенном хосте, в группах хостов, хостах в зоне управления или хостах с тегами. Развертывание АктивныйШлюз, также называемое «Удаленным», выполняется в группах АктивныйШлюз. Группы могут содержать один или несколько шлюзов АктивныйШлюз для большей надежности.

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

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

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

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

Часто задаваемые вопросы

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

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

Предполагая, что вы получили все метрики для всех объектов: ((10) + (Локальные очереди * 16) + (Псевдонимы + Удаленные очереди) * 2 + (Каналы * 18) + (Прослушиватели) + (Темы * 4)) * Менеджеры очередей * 525,6 = 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 имеют только метрики запрета GET/PUT.
• Я продолжаю получать несанкционированные ошибки, но знаю, что мой полдбзователь прав

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

Содержимое расширения

Тип содержимого	Количество включенных объектов
Screen Injections	2
Screen Entities Lists	29
Screen Layout	9
Screen Logs Cards	1
List Screen Layout	9
Generic Relationship	17
Screen Health Cards	1
Screen Chart Groups	16
Metric Metadata	61
Screen Events Cards	1
Screen Metric Tables	1
Screen Actions	10
Generic Type	9
Dashboards	1
Screen Properties	9
Screen Message Cards	14
Metric Query	4
Alerts	8