Просмотр кода страницы IBM i

Собирайте данные о производительности своих хостов IBM i с помощью этого удаленного расширения.

== Обзор ==
Ключ-АСТРОМ предлагает удаленный мониторинг хостов IBM i с помощью расширения АктивногоШлюза.

Полученные данные предоставляют Ключ-АСТРОМ возможность просмотра производительности хоста в режиме реального времени с помощью инструментов интерактивной визуализации, информационных панелей, унифицированного анализа и событий. В сочетании с мониторингом ЕдиногоШлюза вы получаете возможность понять, как IBM i взаимодействует с другими компонентами вашего стека.

== Начало ==

=== Требования ===
Примечание. Для обеспечения наилучшей производительности и сбора данных эти требования являются необходимыми. Всегда держите свою систему в актуальном состоянии.

* АктиыныйШлюз должен быть версии 1.265+
* Ключ-АСТРОМ версия 1.265+
* IBM добилась значительных улучшений производительности и представила более точные показатели в своих последних уровнях обновления технологий. По этой причине поддерживаются только следующие выпуски IBM i:
** IBM i 7.3 Technology Refresh 12+ (необходимо иметь группу PTF SF99703 уровня 28+)
** IBM i 7.4 Technology Refresh 6+ (необходимо иметь группу PTF SF99704 уровня 20+)
** IBM я 7.5
* Порты связи между АктивнымШлюзом и хостами IBM i должны быть открыты.

* Драйвер IBM i Access ODBC должен быть установлен на АктивныйШлюз. Это специальный драйвер, предоставляемый IBM для связи DB2 с хостами IBM i.
* Пул соединений должен быть включен в драйвере ODBC. В Windows это включено по умолчанию.
* Из-за конфиденциальных системных данных IBM требует, чтобы пользователь с профилем SECOFR имел доступ к таблицам производительности и всем их функциям.

----

== Windows АктивныйШлюз (для Linux см. ниже) ==

== Установка драйвера ODBC ==
Следуйте этим инструкциям, если вы используете АктивныеШлюзы под управлением Windows:

* Зайдите на сайт IBM .
* Щелкните ссылку Загрузки для решений IBM i Access .

* Войдите в свою учетную запись IBM и примите условия лицензии.
* Правильный драйвер ODBC входит только в состав «Клиентские решения IBM i Access — пакет приложений Windows для Windows». . Только этот пакет содержит необходимый драйвер ODBC. Не устанавливайте «Клиент IBM i Access». Обязательно загрузите пакет Windows.

* Извлеките zip-архив и следуйте его инструкциям для установки на АктивныйШлюз.
* После установки убедитесь, что драйвер IBM i Access установлен и пул соединений включен, запустив собственное приложение Windows Data Sources ODBC . Вы можете увеличить его таймаут до числа не меньше 60.

=== Linux АктивныеШлюзы (расширенная настройка) ===
В состав дистрибутивов Linux не входит менеджер драйверов ODBC, а он необходим для подключения к IBM i. unixODBC — наиболее распространенный и совместимый менеджер драйверов для Linux, также одобренный IBM.

* ⚠️ Установка unixODBC требует продвинутых знаний Linux.
* 🛑 Вам необходимо установить unixODBC 2.3.12 или выше . Более ранние версии не поддерживаются из-за необходимых исправлений, доступных только в версии 2.3.12 и новее.
* В зависимости от вашего дистрибутива Linux эта версия может быть доступна для вашего дистрибутива (rpm, debian или других), или вам может потребоваться скомпилировать ее из исходного кода. Это та часть, где вам может понадобиться администратор Linux, чтобы принять это решение.

При установке unixODBC устанавливаются библиотеки и команды, необходимые для подключения к IBM i. После этого unixODBC вам необходимо установить драйвер ODBC IBM i Access.

== Установка драйвера ODBC в Linux ==

* Зайдите на сайт IBM .
* Щелкните ссылку Загрузки для решений IBM i Access .

* Войдите в свою учетную запись IBM и примите условия лицензии.
* Правильный драйвер ODBC входит только в состав «IBM i Access Client Solutions — пакет приложений Linux для Linux». . Только этот пакет содержит необходимый драйвер ODBC. Не устанавливайте «Клиент IBM i Access». Обязательно загрузите пакет Linux.

* Извлеките zip-архив и следуйте его инструкциям для установки на АктивныйШлюз.
* После установки необходимо включить создание пулов соединений в определении драйвера ODBC IBM i Access в файле <code>odbcinst.ini</code>.
* Найдите файл odbcinst.ini (по умолчанию он находится в папке <code>/etc/odbcinst.ini</code>или ) <code>/etc/unixODBC/odbcinst.ini</code>, затем добавьте <code>CPTimeout=60</code>в каждое определение драйвера. Этот параметр необходим для работы расширения и обеспечения точных измерений.

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

* Войдите в консоль Ключ-АСТРОМ.
* В <code>Extensions</code>левом меню выберите <code>IBM i</code>.
* Добавьте конфигурацию мониторинга.

Это расширение АктивногоШлюза, также называемое «Remote», работает в группах АктивногоШлюза.

* Выберите, какая группа АктивногоШлюза будет запускать эту конфигурацию. В вашей группе должен быть хотя бы один АктивныйШлюз.
** Уровень лога : включайте DEBUG только в том случае, если служба устранения неполадок или служба поддержки попросят вас сделать это.
** Добавить хост IBM i: нажмите, чтобы настроить каждое соединение с отдельными хостами. Все эти соединения будут запускаться из этой группы АктивногоШлюза.

=== Хост ===

* Хост или IP-адрес: имя хоста или IP-адрес хоста IBM i.
* Имя пользователя: из-за конфиденциальных системных данных, табличных функций и внутренних хранимых процедур требуется пользователь с доступом SECOFR к хосту IBM i.
* Пароль: Пароль для пользователя выше.
* Использовать SSL: включите этот переключатель, если подключение к хосту осуществляется с использованием SSL.

=== Задания ===

* Получить самые активные задания: переключите, чтобы собрать N заданий, наиболее потребляющих ЦП. (Макс 500). Это требует наименьшего количества настроек, поскольку автоматически собирает большинство ресурсоемких заданий с помощью ЦП. Отключение этого переключателя позволяет вручную настраивать задания по определенным фильтрам.
** Отправлять события лога о состоянии всех заданий. Переключите эту кнопку, чтобы настроить правила, которые будут запускать событие журнала для любого задания в системе, соответствующего статусу. Результирующее событие лога также будет включать номер задания.
* Добавить фильтр заданий: если параметр «Самые активные задания» отключен, вы можете вручную настроить правила, соответствующие определенным заданиям, как по пользователю, так и по подсистеме.
** Отправлять событие лога о состоянии этого задания. Переключите эту кнопку, чтобы настроить правила, которые будут запускать событие лога, если это задание находится в этом состоянии. Результирующее событие лога также будет включать номер задания.

=== Очереди заданий ===

* Добавить фильтр очереди заданий: настройте правило для очередей заданий, соответствующих имени и/или библиотеке, в которой они находятся.

=== Подсистемы ===

* Добавить фильтр подсистем: настройте правило для подсистем, соответствующих имени и/или библиотеке, в которой они находятся.

=== Очереди сообщений для мониторинга ===

* Добавить фильтр очереди сообщений: настроена очередь сообщений по умолчанию — QSYSOPR. Большинство системных сообщений находится в этой очереди. Однако вы можете добавить дополнительные правила для других очередей сообщений. В этих очередях будут учитываться только сообщения, имеющие минимальную серьезность. При желании вы можете просмотреть отдельные сообщения, вызвав события лога для тех сообщений, которые соответствуют критериям.
** Минимальная серьезность: сообщения имеют уровень серьезности от 0 до 99. Использование этого фильтра позволит устранить шум и некритичные сообщения.
** Отправлять события лога в сообщении: переключите эту кнопку, чтобы активировать события лога для сообщений, которые соответствуют серьезности и идентификаторам сообщений и/или типам сообщений.
*** Идентификаторы сообщений: введите список важных идентификаторов сообщений, разделенных запятыми. Вы можете оставить это поле пустым, чтобы оно соответствовало любому идентификатору сообщения.
*** Фильтрация по типам сообщений. Переключение типов сообщений для фильтрации. Оставьте это поле пустым, чтобы отфильтровать любой из них.

=== Очереди вывода ===

* Добавить фильтр очереди вывода: настройте правила для сбора очередей вывода и информации об их буферных файлах.

=== Мониторинг сети ===

* Локальные адреса: введите разделенный запятыми список IP-адресов или адресов CIDR и номера их портов. Это полезно для просмотра статистики входящего трафика на определенные порты.
* Удаленные адреса: введите разделенный запятыми список IP-адресов или адресов CIDR и номера их портов. Это полезно для просмотра статистики исходящего трафика на определенные порты.

=== Расширенные параметры ===

* Частота опроса: по умолчанию данные собираются каждую минуту, но вы можете настроить частоту здесь. Данные за 1 минуту обеспечивают наиболее точные данные.
* Тайм-аут подключения: время в секундах, прежде чем попытка подключения к хосту IBM i прекратится. Это должно быть довольно быстро и не должно превышать 30 секунд.
* Тайм-аут запроса: время в секундах до запуска тайм-аута запроса.
* Важные статусы заданий: список распространенных статусов заданий. Этот список сведет к минимуму возможные комбинации статусов заданий, чтобы избежать использования слишком большого количества DDU. Любой статус, которого нет в этом списке, будет помещен в корзину статусов «Другое». События журнала, вызванные статусами заданий, не будут затронуты этим списком и всегда будут соответствовать его истинному статусу.

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

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

* Windows и Linux АктивныеШлюзы
* Поддерживаемые выпуски:
** IBM i 7.3 Technology Refresh 12+ (необходимо иметь группу PTF SF99703 уровня 28+)
** IBM i 7.4 Technology Refresh 6+ (необходимо иметь группу PTF SF99704 уровня 20+)
** IBM я 7.5

Для Linux АктивныеШлюзы:

* unixODBC 2.3.12 и выше

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

=== Вопрос: Каково потребление DDU этого расширения? ===
О: Формула потребления DDU расширения:
   <code>(15 + (11 * Memory pools) +  (7 * Jobs) +
   (9 * ASPs) +  (12 * Disk unit) + (5 * Job queues) + 
   ((3 * Output queues) * (3 * Spooled files)) + 
   (1 * Subsystems) + (1 * Network interfaces) + 
   (7 * Network connections) + (1 * Message queues) ) * 525.6 DDUs/year, per Host</code>
''В следующем примере предполагается, что вы собираете все наборы функций (группы показателей) каждую минуту.''

Например, мониторинг 1 хоста с 4 пулами памяти, 5 подсистем, 1 ASP с 20 дисковыми накопителями, 10 очередей заданий, 200 заданий, 1 очереди сообщений, 3 интерфейсов, 5 сетевых подключений, 3 очередей вывода и каждого из них с 5 буферными файлами создает следующий:

<code>(15 + (11 * 4) + (7 * 200) + (9 * 10) + (12 * 20) + (10 * 5) + ((3 * 3) * (3 * 5)) + (1 *5) + (1 * 3) + (7 * 5) * (1 *1)) * 525.6 DDUs/year</code>= 1 060 660 (1 млн) DDU/год

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

== Скриншоты ==

=== Включенные информационные панели: ===