8. Плагин MSSQL

Обзор

В этом разделе перечислены параметры, поддерживаемые в файле конфигурации плагина MSSQL для Zabbix агента 2 (mssql.conf).

Плагин MSSQL является подгружаемым плагином, он доступен и полностью описан в репозитории плагина MSSQL.

Этот плагин поддерживается с версии Zabbix 6.0.27. Предварительно скомпилированные бинарные файлы для Windows доступны, начиная с версии Zabbix 6.0.28, и совместимы с версией 6.0.27.

Обратите внимание, что:

  • Значения по умолчанию отражают значения по умолчанию для процесса, а не значения в поставляемых файлах конфигурации;
  • Zabbix поддерживает файлы конфигурации только в кодировке UTF-8 без BOM;
  • Комментарии, начинающиеся с «#», поддерживаются только в начале строки.

Параметры

Параметр Обязательный Диапазон По умолчанию Описание
Plugins.MSSQL.CustomQueriesDir нет пусто Указывает путь к директории, содержащей определяемые пользователем файлы .sql с пользовательскими запросами, которые плагин может выполнять. При запуске плагин подгружает все доступные файлы .sql в указанной директории. Это означает, что любые изменения в файлах пользовательских запросов никак не отразятся до рестарта плагина. Плагин запускается и останавливается вместе с Zabbix агентом 2.
Plugins.MSSQL.Default.CACertPath нет Путь по умолчанию к файлу сертификата открытого ключа центра сертификации (CA), выдавшего сертификат сервера MSSQL. Сертификат должен быть в формате PEM.
Plugins.MSSQL.Default.Database нет Имя базы данных по умолчанию для подключения.
Plugins.MSSQL.Default.Encrypt нет Указывает тип шифрования соединения по умолчанию. Возможные значения:
true — данные, пересылаемые между плагином и сервером, шифруются;
false — данные, пересылаемые между плагином и сервером, не шифруются, за исключением пакета логина;
strict — данные, пересылаемые между плагином и сервером, шифруются E2E с использованием TDS8;
disable — данные, пересылаемые между плагином и сервером, не шифруются.
Plugins.MSSQL.Default.HostNameInCertificate нет Общее имя (common name, CN) сертификата сервера MSSQL по умолчанию.
Plugins.MSSQL.Default.Password нет Пароль, пересылаемый на защищённый сервер MSSQL по умолчанию.
Plugins.MSSQL.Default.TLSMinVersion нет Минимальная версия TLS для использования по умолчанию. Возможные значения: 1.0, 1.1, 1.2, 1.3.
Plugins.MSSQL.Default.TrustServerCertificate нет Должен ли по умолчанию плагин доверять сертификату сервера без его проверки. Возможные значения: true, false.
Plugins.MSSQL.Default.Uri нет sqlserver://localhost:1433 URI для подключения по умолчанию. Единственная поддерживаемая схема — sqlserver://. Схема может быть опущена. Встроенные креденшиалы будут проигнорированы.
Plugins.MSSQL.Default.User нет Имя пользователя по умолчанию, пересылаемое на защищённый сервер MSSQL.
Plugins.MSSQL.KeepAlive нет 60-900 300 Максимальное время ожидания (в секундах), прежде чем неиспользуемые плагином соединения будут закрыты.
Plugins.MSSQL.Sessions.<ИмяСессии>.CACertPath нет Путь к файлу сертификата открытого ключа центра сертификации (CA), выдавшего сертификат сервера MSSQL для именованной сессии. Сертификат должен быть в формате PEM.
<ИмяСессии> — определяет имя сессии, используемое в ключах элементов данных.
Plugins.MSSQL.Sessions.<ИмяСессии>.Database нет Имя базы данных для подключения для именованной сессии.
<ИмяСессии> — определяет имя сессии, используемое в ключах элементов данных.
Plugins.MSSQL.Sessions.<ИмяСессии>.Encrypt нет Указывает тип шифрования соединения для именованной сессии. Возможные значения:
true — данные, пересылаемые между плагином и сервером, шифруются;
false — данные, пересылаемые между плагином и сервером, не шифруются, за исключением пакета логина;
strict — данные, пересылаемые между плагином и сервером, шифруются E2E с использованием TDS8;
disable — данные, пересылаемые между плагином и сервером, не шифруются.
<ИмяСессии> — определяет имя сессии, используемое в ключах элементов данных.
Plugins.MSSQL.Sessions.<ИмяСессии>.HostNameInCertificate нет Общее имя (common name, CN) сертификата сервера MSSQL для именованной сессии.
<ИмяСессии> — определяет имя сессии, используемое в ключах элементов данных.
Plugins.MSSQL.Sessions.<ИмяСессии>.Password нет Пароль, пересылаемый на защищённый сервер MSSQL для именованной сессии.
<ИмяСессии> — определяет имя сессии, используемое в ключах элементов данных.
Plugins.MSSQL.Sessions.<ИмяСессии>.TLSMinVersion нет Минимальная версия TLS для использования для именованной сессии. Возможные значения: 1.0, 1.1, 1.2, 1.3.
<ИмяСессии> — определяет имя сессии, используемое в ключах элементов данных.
Plugins.MSSQL.Sessions.<ИмяСессии>.TrustServerCertificate нет Должен ли плагин доверять сертификату сервера без его проверки (для именованной сессии). Возможные значения: true, false.
<ИмяСессии> — определяет имя сессии, используемое в ключах элементов данных.
Plugins.MSSQL.Sessions.<ИмяСессии>.Uri нет sqlserver://localhost:1433 URI для подключения, для именованной сессии. Единственная поддерживаемая схема — sqlserver://. Схема может быть опущена. Встроенные креденшиалы будут проигнорированы.
<ИмяСессии> — определяет имя сессии, используемое в ключах элементов данных.
Plugins.MSSQL.Sessions.<ИмяСессии>.User нет Имя пользователя, пересылаемое на защищённый сервер MSSQL (для именованной сессии).
<ИмяСессии> — определяет имя сессии, используемое в ключах элементов данных.
Plugins.MSSQL.System.Path нет Путь до исполняемого файла плагина MSSQL.
Глобальная настройка для плагина MSSQL. Применяется ко всем соединениям.
Пример использования: Plugins.MSSQL.System.Path=/usr/sbin/zabbix-agent2-plugin/zabbix-agent2-plugin-mssql
Plugins.MSSQL.Timeout нет 1-30 глобальный тайм-аут Время ожидания ответа сервера при первом подключении и последующих операциях в сессии.

Смотрите также: