Documentation
Table of Contents
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 | глобальный тайм-аут | Время ожидания ответа сервера при первом подключении и последующих операциях в сессии. |
Смотрите также:
- Описание общих параметров конфигурации Zabbix агента 2: Zabbix агент 2 (UNIX) / Zabbix агент 2 (Windows)
- Инструкции по настройке плагинов