[comment]: # (tags: mssql) [comment]: # ({12942068-2b91b381}) # 8. Плагин MSSQL [comment]: # ({/12942068-2b91b381}) [comment]: # ({824434d2-982c8358}) #### Обзор В этом разделе перечислены параметры, поддерживаемые в файле конфигурации плагина MSSQL для Zabbix агента 2 (mssql.conf). Плагин MSSQL является подгружаемым плагином, он доступен и полностью описан в [репозитории плагина MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse?at=refs%2Fheads%2Frelease%2F6.0). Этот плагин поддерживается с версии Zabbix 6.0.27. Предварительно скомпилированные бинарные файлы для Windows доступны, начиная с версии [Zabbix 6.0.28](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.28/), и совместимы с версией 6.0.27. Обратите внимание, что: - Значения по умолчанию отражают значения по умолчанию для процесса, а не значения в поставляемых файлах конфигурации; - Zabbix поддерживает файлы конфигурации только в кодировке UTF-8 без [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Комментарии, начинающиеся с «\#», поддерживаются только в начале строки. [comment]: # ({/824434d2-982c8358}) [comment]: # ({03a0ccba-efe3e04c}) #### Параметры |Параметр|Обязательный|Диапазон|По умолчанию|Описание| |--|--|--|--|----------| |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](https://learn.microsoft.com/en-us/sql/relational-databases/security/networking/tds-8?view=sql-server-ver16);
*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](https://learn.microsoft.com/ru-ru/sql/relational-databases/security/networking/tds-8?view=sql-server-ver16);
*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)](/manual/appendix/config/zabbix_agent2) / [Zabbix агент 2 (Windows)](/manual/appendix/config/zabbix_agent2_win) - Инструкции по настройке [плагинов](/manual/extensions/plugins) [comment]: # ({/03a0ccba-efe3e04c})