Zabbix Documentation 2.0

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools

This translation is older than the original page and might be outdated. See what has changed.

Sidebar

ru:manual:config:items:itemtypes:odbc_checks

15 ODBC мониторинг

15.1 Обзор

ODBC мониторинг соответствует типу элемента данных Монитору баз данных в веб-интерфейсе Zabbix.

ODBC - язык программирования на C, промежуточная прослойка API для доступа к системам управления баз данных (DBMS). Концепт ODBC был разработан Microsoft и в дальнейшем портирован на другие платформы.

Zabbix может выполнять запросы в любой базе данных, которые поддерживаются ODBC. Чтобы это сделать, Zabbix не подключается напрямую к базам данных, он использует интерфейс ODBC и драйвера установленные в ODBC. Эта функция позволяет мониторить различные базы данных с различными целями с большей эффективностью - например, проверка специфичных запросов к базе данных, статистика использования и прочее. Zabbix поддерживает unixODBC и iODBC, которые наиболее часто используются в реализациях ODBC API с открытым исходным кодом.

15.2 Установка unixODBC

Предлагаемый вариант установки unixODBC состоит из использования пакетных репозитариев Linux операционной системы по умолчанию. В наиболее популярные дистрибутивы Linux unixODBC включен в пакетные репозитарии по умолчанию. Если он недоступен, вы можете обратиться к UnixODBC домашней странице: http://www.unixodbc.org/download.html.

Установка unixODBC с использованием пакетного менеджера yum:

shell> yum -y install unixODBC unixODBC-devel

Пакет unixODBC-devel требуется для компиляции Zabbix с поддержкой unixODBC.

15.3 Установка драйверов unixODBC

Драйвер unixODBC базы данных должен быть установлен для базы данных, которая будет наблюдаться. unixODBC имеет список поддерживаемых баз данных и драйверов: http://www.unixodbc.org/drivers.html. В некоторых дистрибутивах Linux драйвера баз данных включены в пакетные репозитарии.

Например, драйвера MySQL базы данных можно установить с помощью менеджера пакетов yum:

shell> yum install mysql-connector-odbc

15.4 Настройка unixODBC

Настройка ODBC выполняется редактированием файлов odbcinst.ini и odbc.ini. Для проверки размещения этих файлов введите:

shell> odbcinst -j

odbcinst.ini используется для списка установленных драйверов баз данных ODBC:

[mysql]
Description = ODBC for MySQL
Driver      = /usr/lib/libmyodbc5.so

Подробная информация:

Атрибут Описание
mysql Имя драйвера базы данных.
Description Описание драйвера базы данных.
Driver Размещение библиотеки драйвера базы данных.

odbc.ini используется для указания источников данных:

[test]
Description = MySQL test database
Driver      = mysql
Server      = 127.0.0.1
User        = root
Password    =
Port        = 3306
Database    = zabbix

Подробная информация:

Атрибут Описание
test Имя источника данных (DSN).
Description Описание источника данных.
Driver Имя драйвера базы данных - как указано в odbcinst.ini
Server IP/DNS сервера базы данных.
User Пользователь базы данных для подключения.
Password Пароль базы данных для подключения.
Port Порт подключения к базе данных.
Database Имя базы данных.

Для проверки работает ли соединение ODBC корректно, подключение к базе данных необходимо протестировать. Для этого можно воспользоваться утилитой isql (включена в пакет unixODBC):

shell> isql test
+---------------------------------------+
| Connected!                            |
|                                       |
| sql-statement                         |
| help [tablename]                      |
| quit                                  |
|                                       |
+---------------------------------------+
SQL>

15.5 Компиляция Zabbix с поддержкой ODBC

Для включения поддержки ODBC, Zabbix должен быть скомпилирован с одним из следующих флагов:

  --with-iodbc[=ARG]      use odbc driver against iODBC package [default=no],
  --with-unixodbc[=ARG]   use odbc driver against unixODBC package

Смотрите более подробную информацию о установке Zabbix из исходных кодов.

15.6 Настройка элемента данных в веб-интерфейсе Zabbix

Настройте для мониторинга базы данных элемент данных:

Специально для элементов данных мониторинга баз данных вы должны указать:

Тип Выберите здесь Монитор баз данных.
Ключ Укажите db.odbc.select[уникальное_описание]
Уникальное описание будет служить для идентификации элемента данных в триггерах и тому подобном.
Дополнительные параметры DSN - имя источника данных (как указано в odbc.ini)
user - имя пользователя базы данных (опционально, если пользователь указан в odbc.ini)
password - пароль к базе данных (опционально, если пароль указан в odbc.ini)
sql - SQL запрос
Тип информации Очень важно знать какой тип информации будет возвращаться указанным запросом, то есть выберите корректный тип информации здесь. С некорректным типом информации элемент данных станет неподдерживаемым.

15.7 Важные замечания

  • Запрос не должен выполняться дольше чем указано в параметре Timeout на сервере.
  • Запрос должен возвращать только одно значение.
  • Если запрос возвращает более чем одну колонку, читаться будет только первая колонка.
  • Если запрос возвращает более чем одну строку, читаться будет только первая строка.
  • Команда SQL должна начинаться с select.
  • Команда SQL не должна включать в себя переводы строк.