14 ODBC надгледање

Преглед

ODBC надгледање одговара типу ставке Надгледање базе података у Zabbix корисничком интерфејсу.

ODBC је API средњег софтвера програмског језика C за приступ системима за управљање базама података (DBMS). ODBC концепт је развио Microsoft и касније пренет на друге платформе.

Zabbix може да тражи било коју базу података коју подржава ODBC. Да би то урадио, Zabbix се не повезује директно са базама података, већ користи ODBC интерфејс и сет драјвера горе у ODBC-у. Ово омогућава ефикасније праћење различитих база података за више намена (на пример, провера одређених редова базе података, статистике коришћења, итд.).

Zabbix подржава unixODBC, који је једна од најчешће коришћених имплементација ODBC API-ја отвореног кода.

Инсталирање unixODBC-а

Предложени начин инсталирања unixODBC-а је коришћење подразумеваних спремишта пакета оперативног система Linux. У најпопуларнијим Linux дистрибуцијама, unixODBC је подразумевано укључен у спремиште пакета. Ако пакети нису доступни, изворне датотеке се могу добити на почетној страници unixODBC-а : http://www.unixodbc.org/download.html.

Да бисте инсталирали unixODBC, користите менаџер пакета за систем вашег избор:

# For Ubuntu/Debian systems:
       apt install unixodbc unixodbc-dev
       
       # For RedHat/Fedora-based systems:
       dnf install unixODBC unixODBC-devel
       
       # For SUSE-based systems:
       zypper in unixODBC-devel

Инсталирање unixODBC драјвера

UnixODBC драјвер за базу података треба да буде инсталиран за базу података која ће се надгледати. За листу подржаних база података и драјвера, погледајте почетну страницу unixODBC: http://www.unixodbc.org/drivers.html.

MySQL

Да бисте инсталирали MySQL unixODBC драјвер базе података, користите менаџер пакета за систем по вашем избору:

# For Ubuntu/Debian системе:
       apt install odbc-mariadb
       
       # For RedHat/Fedora-based системе:
       dnf install mariadb-connector-odbc
       
       # For SUSE-based системе:
       zypper install mariadb-connector-odbc

Да бисте инсталирали драјвер базе података без менаџер пакета, погледајте MySQL документацију за mysql-connector-odbc или MariaDB документацију за mariadb-connector-odbc.

PostgreSQL

Да бисте инсталирали PostgreSQL unixODBC драјвер базе података, користите менаџер пакета за систем по вашем избору:

# For Ubuntu/Debian системе:
       apt install odbc-postgresql
       
       # For RedHat/Fedora-based системе:
       dnf install postgresql-odbc
       
       # For SUSE-based системе:
       zypper install psqlODBC

Да бисте инсталирали драјвер базе података без пакета менаџера, погледајте PostgreSQL документацију.

Oracle

Да бисте инсталирали драјвер за базу података unixODBC, погледајте Oracle документацију.

MSSQL

Да бисте инсталирали управљачки програм базе података MSSQL unixODBC за Ubuntu/Debian системе, користите менаџер пакета за систем по вашем избору:

# For Ubuntu/Debian системи:
       apt install tdsodbc
       
       # For RedHat/Fedora-based системи (EPEL packages: https://docs.fedoraproject.org/en-US/epel/):
       dnf install epel-release
       dnf install freetds
       
       # For SUSE-based системи:
       zypper install libtdsodbc0

Да бисте инсталирали драјвер базе података без менаџера пакета, погледајте FreeTDS кориснички водич.

Конфигурисање unixODBC-а

Да бисте конфигурисали unixODBC, морате да уредите датотеке odbcinst.ini и odbc.ini. Можете да проверите локацију ових датотека тако што ћете извршити следећу команду:

odbcinst -j

Резултат команде треба да садржи информације то је слично следећем:

unixODBC 2.3.9
       DRIVERS............: /etc/odbcinst.ini
       SYSTEM DATA SOURCES: /etc/odbc.ini
       FILE DATA SOURCES..: /etc/ODBCDataSources

odbcinst.ini

Датотека odbcinst.ini наводи инсталиране драјвере ODBC базе података. Ако недостаје ODBC, потребно је да га креирате ручно.

[TEST_MYSQL]
       Description=ODBC for MySQL
       Driver=/usr/lib/libmyodbc5.so
       FileUsage=1

odbc.ini

Датотека odbc.ini се користи за конфигурисање извора података. Имајте на уму да листа подржаних параметара зависи од драјвера базе података (на пример, Oracle базе података могу користити ServerName уместо Server, итд.).

[TEST_MYSQL]
       Description=MySQL Test Database
       Driver=mysql
       Server=127.0.0.1
       User=root
       Password=
       Port=3306
       Socket=
       Database=zabbix

За друге могуће опције конфигурационих параметара, погледајте MySQL документација.

The odbc.ini file for PostgreSQL may contain additional parameters:

[TEST_PSQL]
       Description=PostgreSQL Test Database
       Driver=postgresql
       Username=zbx_test
       Password=zabbix
       Servername=127.0.0.1
       Database=zabbix
       Port=5432
       ReadOnly=No
       Protocol=7.4+
       ShowOidColumn=No
       FakeOidIndex=No
       RowVersioning=No
       ShowSystemTables=No
       Fetch=Yes
       BoolsAsChar=Yes
       SSLmode=Require
       ConnSettings=

Тестирање ODBC везе

Да бисте тестирали да ли ODBC веза функционише успешно, можете користити услужни програм isql (укључен у пакет unixODBC):

isql test
       +---------------------------------------+
       | Connected!     |
       |.    |
       | sql-statement.    |
       | help [tablename].    |
       | quit.    |
       |.  |
       +---------------------------------------+

Конфигурација ставке у Zabbix кориснички интерфејс

Конфигуришите надгледање базе података item.

Сва обавезна поља за унос су означена црвеном звездицом.

За ставке надгледања базе података, морате навести:

Важне напомене

• Ставке за праћење базе података ће постати неподржане ако се не покрену процеси odbc poller у конфигурацији сервера или проксија. Да бисте активирали ODBC полерa, поставите параметар StartODBCPollers у конфигурацији Zabbix сервер датотеку или, за провере које обавља прокси, у Zabbix-у прокси конфигурациона датотека.

• Вредност параметра * Timeout* у обрасцу конфигурација ставке се користи као временско ограничење за пријаву на ODBC и временско ограничење за извршење упита. Имајте на уму да се ове поставке временског ограничења могу занемарити ако их инсталирани ODBC драјвер не подржава.

• SQL команда мора да врати скуп резултата као и сваки упит који користи наредбу select. Синтакса упита зависиће од RDBMS-а који ће их обрадити. Синтакса захтева за процедуру складиштења мора бити покренута кључном речи call.

Кључни детаљи ставке

Параметри без угаоних заграда су обавезни. Параметри означени угаоним заградама < > су опциони.

db.odbc.select[<unique short description>,<dsn>,<connection string>]

Враћа једну вредност, односно прву колону првог реда резултата SQL упита.
Враћана вредност: У зависности од SQL упита.

Параметри:

• unique short description - јединствени кратки опис за идентификацију ставке (за употребу у окидачима, итд.);
• ** dsn** - име извора података (као што је наведено у odbc.ini);
• connection string - низ везе (може да садржи аргументе специфичне за драјвер).

Коментари:

• Иако су dsn и connection string опциони параметри, бар један од њих је обавезан; ако су оба дефинисана, dsn ће бити занемарен.
• Ако упит врати више од једне колоне, чита се само прва колона. Ако упит врати више од једног реда, чита се само први ред.

db.odbc.get[<unique short description>,<dsn>,<connection string>]

Трансформише резултат SQL упита у JSON низ.
Враћена вредност: JSON објекат.

Параметри:

• јединствени кратак опис - јединствени кратак опис за идентификацију ставке (за употребу у окидачима итд.);
• dsn - назив извора података (као што је наведено у odbc.ini);
• стринг за повезивање - стринг за повезивање (може садржати аргументе специфичне за драјвер).

Коментари:

• Иако су dsn и стринг за повезивање опциони параметри, барем један од њих је обавезан; ако су оба дефинисана, dsn ће бити игнорисан.
• Може се вратити више редова/колона у JSON формату. Ова ставка може се користити као главна ставка која прикупља све податке у једном системском позиву, док се JSONPath претходна обрада може користити у зависним ставкама за издвајање појединачних вредности. За више информација, погледајте пример враћеног формата, који се користи у откривању ниског нивоа.

Пример:

Веза за MySQL ODBC драјвер 5:

db.odbc.get[MySQL пример,"Driver=/usr/local/lib/libmyodbc5a.so;Database=master;Server=127.0.0.1;Port=3306"]

db.odbc.discovery[<unique short description>,<dsn>,<connection string>]

Трансформише резултат SQL упита у JSON низ, који се користи за откривање ниског нивоа. Имена колона из резултата упита се претварају у имена макроа за откривање ниског нивоа упарена са откривене вредности поља. Ови макрои се могу користити за креирање ставке, покретача итд. прототипови.
Повратна вредност: JSON object.

Параметри:

• unique short description - јединствени кратак опис за идентификацију ставке (за употребу у покретачима, итд.);
• ** dsn** - име извора података (као што је наведено у odbc.ini);
• сonnection string - низ везе (може да садржи аргументе специфичне за драјвер).

Коментари:

• Иако су dsn и connection string су опциони параметри, бар један од њих је обавезан; ако су оба дефинисана, dsn ће бити занемарен.

Error messages

ODBC error messages are structured into fields to provide detailed information. For example:

Cannot execute ODBC query: [SQL_ERROR]:[42601][7][ERROR: syntax error at or near ";"; Error while executing the query]
       └───────────┬───────────┘  └────┬────┘ └──┬──┘└┬┘└─────────────────────────────┬─────────────────────────────────────┘
                   │                   │         │    └─ Native error code            └─ Native error message
                   │                   │         └─ SQLState
                   └─ Zabbix message   └─ ODBC return code

Note that the error message length is limited to 2048 bytes, so the message can be truncated. If there is more than one ODBC diagnostic record, Zabbix tries to concatenate them (separated with |) as far as the length limit allows.