Мониторинг IBM Informix

Мониторинг IBM Informix

Расширение предназначено для удалённого мониторинга экземпляров IBM Informix через JDBC. Оно выполняет запросы к системной базе данных sysmaster, собирает показатели производительности и создаёт связанные сущности экземпляров, баз данных и dbspace в Ключ-АСТРОМ.

Параметр	Значение
Идентификатор	ru.ruscomtech.extension.sql-informix
Минимальная версия Ключ-АСТРОМ	1.310
Поддерживаемая версия Informix	14.10+
Версия JDBC-драйвера	4.5.x+
Источник данных	JDBC

Возможности расширения

• Удалённый сбор метрик без установки агента на сервер Informix.
• Мониторинг загрузки процессора и эффективности буферного кэша.
• Контроль последовательных сканирований и контрольных точек.
• Мониторинг разделяемой памяти экземпляра.
• Контроль ожиданий блокировок и превышения системных ограничений.
• Сбор количества подключений и блокировок по базам данных.
• Контроль свободного пространства и операций ввода-вывода по dbspace.
• Сбор статистики наиболее активно сканируемых таблиц.
• Создание сущностей экземпляров, баз данных и dbspace.
• Готовые обзорные панели IBM Informix.

Требования

Для работы расширения необходимы:

• АктивныйШлюз с поддержкой выполнения расширений.
• Сетевой доступ от АктивногоШлюза к серверу Informix.
• IBM Informix JDBC Driver версии 4.5.x или новее.
• Отдельная учётная запись Informix с правами только на чтение системных представлений.
• Доступ к системной базе данных sysmaster.

Расширение не содержит JDBC-драйвер. Файл драйвера необходимо разместить в каталоге:

remotepluginmodule/agent/conf/userdata/libs

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

Права учётной записи

Рекомендуется использовать отдельную учётную запись мониторинга без прав на изменение данных.

Учётной записи необходимо предоставить право подключения к базе sysmaster и чтения следующих системных представлений:

syslocks
syssessions
sysdatabases
sysprofile
sysseglst
sysvpprof
sysdbspaces
syschunks
sysshmvals
syschktab
sysmchktab
sysdbstab
sysptprof
systabinfo
systables

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

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

1. Откройте раздел управления расширениями Ключ-АСТРОМ.
2. Загрузите подписанный пакет ru.ruscomtech.extension.sql-informix-2.0.1.zip.
3. Установите расширение.
4. Откройте установленное расширение и выберите добавление конфигурации мониторинга.
5. Выберите группу АктивныхШлюзов, с которой доступен сервер Informix.
6. Добавьте endpoint для каждого контролируемого экземпляра.
7. Сохраните и включите конфигурацию.

Конфигурация

Для endpoint необходимо указать следующие параметры:

Параметр	Описание
Имя endpoint	Произвольное уникальное имя подключения.
Host	DNS-имя или IP-адрес сервера Informix.
Port	Порт службы Informix.
Connection string	JDBC-строка подключения к базе sysmaster.
Username	Пользователь с правами чтения системных представлений.
Password	Пароль пользователя либо ссылка на учётные данные из хранилища секретов.
SSL	Включается, если сервер Informix настроен на защищённое JDBC-подключение.

Адрес и порт необходимо заполнить отдельно, даже если они уже присутствуют в JDBC-строке.

Строка подключения

Строка подключения должна начинаться с jdbc:informix-sqli:// и вести к базе sysmaster:

jdbc:informix-sqli://informix.example.local:9088/sysmaster:INFORMIXSERVER=ol_informix1410

Где:

• informix.example.local — адрес сервера Informix;
• 9088 — порт Informix;
• sysmaster — системная база данных, из которой собираются показатели;
• ol_informix1410 — значение параметра INFORMIXSERVER.

Имя пользователя и пароль рекомендуется указывать в отдельных полях конфигурации, а не включать в JDBC-строку.

В версии 2.0.1 отдельная настройка интервала отсутствует. Запросы выполняются штатным циклом источника данных SQL, обычно один раз в минуту.

Собираемые данные

Экземпляр Informix

Метрика	Описание
informix.instance.cpu_user.count	Процессорное время в пользовательском режиме.
informix.instance.cpu_system.count	Процессорное время в системном режиме.
informix.instance.buffer_cache_hit_ratio_read	Доля операций чтения, обслуженных из буферного кэша.
informix.instance.buffer_cache_hit_ratio_write	Доля операций записи, обслуженных через буферный кэш.
informix.instance.scan.count	Количество последовательных сканирований.
informix.instance.checkpoint.count	Количество выполненных контрольных точек.
informix.instance.count_segments	Количество сегментов разделяемой памяти.
informix.instance.segment_size	Размер сегментов разделяемой памяти.
informix.instance.segment_blocks_used	Количество используемых блоков разделяемой памяти.
informix.instance.segment_blocks_free	Количество свободных блоков разделяемой памяти.
informix.instance.ovuser	Попытки превышения максимального количества сеансов.
informix.instance.ovlock	Попытки превышения максимального количества блокировок.
informix.instance.ovtrans	Попытки превышения максимального количества транзакций.
informix.instance.lockwts	Количество ожиданий блокировок.
informix.instance.lruwrites	Количество операций записи LRU.

Базы данных

Метрика	Описание
informix.database.sessions	Количество активных сеансов базы данных.
informix.database.locks	Количество блокировок базы данных.
informix.database.table_pages_used	Количество страниц, используемых таблицей.
informix.database.table_scans	Количество сканирований таблицы.

Статистика таблиц собирается для десяти наиболее активно сканируемых таблиц. Системные базы данных и системные таблицы из этой выборки исключаются.

Dbspace

Метрика	Описание
informix.dbspace.percent_free	Доля свободного пространства в dbspace.
informix.dbspace.chunks_read	Количество операций чтения из chunk.
informix.dbspace.chunks_written	Количество операций записи в chunk.
informix.dbspace.chunk_pages_read	Количество прочитанных страниц chunk.
informix.dbspace.chunk_pages_written	Количество записанных страниц chunk.

Создаваемые сущности

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

Тип	Назначение
informix:instance	Экземпляр сервера Informix.
informix:database	База данных экземпляра.
informix:dbspace	Пространство хранения Informix.

Базы данных и dbspace связываются с соответствующим экземпляром Informix. Если в Ключ-АСТРОМ обнаружен хост с совпадающим IP-адресом, экземпляр также связывается с этим хостом.

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

После сохранения конфигурации:

1. Проверьте состояние конфигурации расширения.
2. Убедитесь, что проверочный запрос SELECT 1 выполняется успешно.
3. Откройте обзорную панель IBM Informix.
4. Проверьте появление сущностей экземпляра, баз данных и dbspace.
5. Убедитесь, что метрики с префиксом informix. поступают в Ключ-АСТРОМ.

Устранение неполадок

Ошибка	Возможная причина и решение
JDBC-драйвер не найден	Проверьте размещение JAR-файла, права на чтение и перезапустите службу АктивногоШлюза.
Строка подключения отклонена	Убедитесь, что она начинается с jdbc:informix-sqli://.
Ошибка аутентификации	Проверьте имя пользователя, пароль и способ аутентификации Informix.
Недостаточно прав	Предоставьте пользователю доступ к sysmaster и право чтения необходимых системных представлений.
Подключение работает, но метрики отсутствуют	Проверьте, что JDBC-строка ведёт к базе sysmaster и системные представления возвращают данные.
Не создаётся связь с хостом	Проверьте наличие контролируемого хоста с IP-адресом, совпадающим с адресом endpoint.

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

Версия	Изменения
2.0.1	Начало поддержки удалённого мониторинга IBM Informix. Адаптировано для Ключ-АСТРОМ 1.310+. Добавлен сбор показателей экземпляров, баз данных, таблиц и dbspace. Добавлены сущности экземпляра, базы данных и dbspace и связи между ними. Добавлены готовые обзорные панели IBM Informix.