7. Плагин 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	глобальный тайм-аут	Время ожидания ответа сервера при первом подключении и последующих операциях в сессии.

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

Описание общих параметров конфигурации Zabbix агента 2: Zabbix агент 2 (UNIX) / Zabbix агент 2 (Windows)
Инструкции по настройке плагинов

Documentation

7. Плагин MSSQL

Обзор

Параметры