Azubarev: Новая страница: «= Мониторинг IBM Informix = Расширение предназначено для удалённого мониторинга экземпляров IBM Informix через JDBC. Оно выполняет запросы к системной базе данных `sysmaster`, собирает показатели производительности и создаёт связанные сущности экземпляров, баз д...»

2026-09-25T19:38:29Z

Новая страница: «= Мониторинг IBM Informix = Расширение предназначено для удалённого мониторинга экземпляров IBM Informix через JDBC. Оно выполняет запросы к системной базе данных <code>sysmaster</code>, собирает показатели производительности и создаёт связанные сущности экземпляров, баз д...»

Новая страница

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

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

{| class="wikitable"
! Параметр
! Значение
|-
| Идентификатор
| <code>ru.ruscomtech.extension.sql-informix</code>
|-
| Минимальная версия Ключ-АСТРОМ
| <code>1.310</code>
|-
| Поддерживаемая версия Informix
| <code>14.10+</code>
|-
| Версия JDBC-драйвера
| <code>4.5.x+</code>
|-
| Источник данных
| JDBC
|}

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

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

== Требования ==

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

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

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

<pre>
remotepluginmodule/agent/conf/userdata/libs
</pre>

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

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

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

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

<pre>
syslocks
syssessions
sysdatabases
sysprofile
sysseglst
sysvpprof
sysdbspaces
syschunks
sysshmvals
syschktab
sysmchktab
sysdbstab
sysptprof
systabinfo
systables
</pre>

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

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

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

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

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

{| class="wikitable"
! Параметр
! Описание
|-
| Имя endpoint
| Произвольное уникальное имя подключения.
|-
| Host
| DNS-имя или IP-адрес сервера Informix.
|-
| Port
| Порт службы Informix.
|-
| Connection string
| JDBC-строка подключения к базе <code>sysmaster</code>.
|-
| Username
| Пользователь с правами чтения системных представлений.
|-
| Password
| Пароль пользователя либо ссылка на учётные данные из хранилища секретов.
|-
| SSL
| Включается, если сервер Informix настроен на защищённое JDBC-подключение.
|}

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

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

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

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

Где:

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

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

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

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

=== Экземпляр Informix ===

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

=== Базы данных ===

{| class="wikitable"
! Метрика
! Описание
|-
| <code>informix.database.sessions</code>
| Количество активных сеансов базы данных.
|-
| <code>informix.database.locks</code>
| Количество блокировок базы данных.
|-
| <code>informix.database.table_pages_used</code>
| Количество страниц, используемых таблицей.
|-
| <code>informix.database.table_scans</code>
| Количество сканирований таблицы.
|}

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

=== Dbspace ===

{| class="wikitable"
! Метрика
! Описание
|-
| <code>informix.dbspace.percent_free</code>
| Доля свободного пространства в dbspace.
|-
| <code>informix.dbspace.chunks_read</code>
| Количество операций чтения из chunk.
|-
| <code>informix.dbspace.chunks_written</code>
| Количество операций записи в chunk.
|-
| <code>informix.dbspace.chunk_pages_read</code>
| Количество прочитанных страниц chunk.
|-
| <code>informix.dbspace.chunk_pages_written</code>
| Количество записанных страниц chunk.
|}

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

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

{| class="wikitable"
! Тип
! Назначение
|-
| <code>informix:instance</code>
| Экземпляр сервера Informix.
|-
| <code>informix:database</code>
| База данных экземпляра.
|-
| <code>informix:dbspace</code>
| Пространство хранения Informix.
|}

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

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

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

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

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

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

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

{| class="wikitable"
! Версия
! Изменения
|-
|2.0.1
|
* Начало поддержки удалённого мониторинга IBM Informix.
* Адаптировано для Ключ-АСТРОМ <code>1.310+</code>.
* Добавлен сбор показателей экземпляров, баз данных, таблиц и dbspace.
* Добавлены сущности экземпляра, базы данных и dbspace и связи между ними.
* Добавлены готовые обзорные панели IBM Informix.
|}

Мониторинг IBM Informix - История изменений