На странице
8. Плагин MSSQL
Обзор
В этом разделе перечислены параметры, поддерживаемые в файле конфигурации плагина MSSQL для агента 2 Zabbix (mssql.conf).
Плагин MSSQL является загружаемым плагином и доступен, а также полностью описан в репозитории плагина MSSQL.
Обратите внимание:
- Значения по умолчанию отражают значения по умолчанию процесса, а не значения в поставляемых файлах конфигурации.
- Значения поддерживают переменные среды;
- Zabbix поддерживает файлы конфигурации только в кодировке UTF-8 без BOM.
- Комментарии, начинающиеся с "#", поддерживаются только в начале строки.
Опции
| Параметр | Описание |
|---|---|
| -V --version | Вывести версию плагина и информацию о лицензии. |
| -h --help | Распечатать справочную информацию (сокращённо). |
Параметры
| Parameter | Mandatory | Range | Default | Description |
|---|---|---|---|---|
| Plugins.MSSQL.CustomQueriesDir | no | /usr/local/share/zabbix/custom-queries/mssql для систем Unix*:\Program Files\Zabbix Agent 2\Custom Queries\MSSQL для систем Windows, где * — имя диска из переменной среды ProgramFiles |
Указывает путь к каталогу, содержащему пользовательские файлы .sql с пользовательскими запросами, которые плагин может выполнять. Плагин загружает все доступные файлы .sql в настроенном каталоге при запуске. Это означает, что любые изменения в файлах пользовательских запросов не будут отражены до перезапуска плагина. Плагин запускается и останавливается вместе с Zabbix agent 2. | |
| Plugins.MSSQL.CustomQueriesEnabled | no | false | Если задано, включает выполнение ключа элемента данных mssql.custom.query. Если отключено, из пути каталога пользовательских запросов не будут загружаться никакие запросы. |
|
| Plugins.MSSQL.Default.CACertPath | no | Путь к файлу с публичным ключом сертификата центра сертификации (CA), выдавшего сертификат сервера MSSQL. Сертификат должен быть в формате PEM. | ||
| Plugins.MSSQL.Default.Database | no | Имя базы данных, к которой подключаться по умолчанию. | ||
| Plugins.MSSQL.Default.Encrypt | no | Указывает тип шифрования соединения по умолчанию. Возможные значения: true - передача данных между плагином и сервером шифруется; false - передача данных между плагином и сервером не шифруется, кроме пакета входа в систему; strict - передача данных между плагином и сервером шифруется end-to-end с использованием TDS8; disable - передача данных между плагином и сервером не шифруется. |
||
| Plugins.MSSQL.Default.HostNameInCertificate | no | Общее имя (CN) сертификата сервера MSSQL по умолчанию. | ||
| Plugins.MSSQL.Default.Password | no | Пароль, который по умолчанию будет отправляться на защищенный сервер MSSQL. | ||
| Plugins.MSSQL.Default.TLSMinVersion | no | Минимальная версия TLS, используемая по умолчанию. Возможные значения: 1.0, 1.1, 1.2, 1.3. |
||
| Plugins.MSSQL.Default.TrustServerCertificate | no | Следует ли плагину доверять сертификату сервера без его проверки по умолчанию. Возможные значения: true, false. |
||
| Plugins.MSSQL.Default.Uri | no | sqlserver://localhost:1433 | URI для подключения по умолчанию. Единственная поддерживаемая схема — sqlserver://. Схему можно опустить. Встроенные учетные данные будут проигнорированы. |
|
| Plugins.MSSQL.Default.User | no | Имя пользователя, которое по умолчанию будет отправляться на защищенный сервер MSSQL. | ||
| Plugins.MSSQL.KeepAlive | no | 60-900 | 300 | Максимальное время ожидания (в секундах) до закрытия неиспользуемых соединений плагина. |
| Plugins.MSSQL.Sessions.<SessionName>.CACertPath | no | Путь к файлу с публичным ключом сертификата центра сертификации (CA), выдавшего сертификат сервера MSSQL, для именованной сессии. Сертификат должен быть в формате PEM. <SessionName> - задайте имя сессии для использования в ключах элементов данных. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Database | no | Имя базы данных, к которой нужно подключаться для именованной сессии. <SessionName> - задайте имя сессии для использования в ключах элементов данных. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Encrypt | no | Указывает тип шифрования соединения для именованной сессии. Возможные значения: true - передача данных между плагином и сервером шифруется; false - передача данных между плагином и сервером не шифруется, кроме пакета входа в систему; strict - передача данных между плагином и сервером шифруется end-to-end с использованием TDS8; disable - передача данных между плагином и сервером не шифруется. <SessionName> - задайте имя сессии для использования в ключах элементов данных. |
||
| Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate | no | Общее имя (CN) сертификата сервера MSSQL для именованной сессии. <SessionName> - задайте имя сессии для использования в ключах элементов данных. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Password | no | Пароль, который будет отправляться на защищенный сервер MSSQL для именованной сессии. <SessionName> - задайте имя сессии для использования в ключах элементов данных. |
||
| Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion | no | Минимальная версия TLS, используемая для именованной сессии. Возможные значения: 1.0, 1.1, 1.2, 1.3.<SessionName> - задайте имя сессии для использования в ключах элементов данных. |
||
| Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate | no | Следует ли плагину доверять сертификату сервера без его проверки для именованной сессии. Возможные значения: true, false.<SessionName> - задайте имя сессии для использования в ключах элементов данных. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Uri | no | sqlserver://localhost:1433 | URI для подключения для именованной сессии. Единственная поддерживаемая схема — sqlserver://. Схему можно опустить. Встроенные учетные данные будут проигнорированы.<SessionName> - задайте имя сессии для использования в ключах элементов данных. |
|
| Plugins.MSSQL.Sessions.<SessionName>.User | no | Имя пользователя, которое будет отправляться на защищенный сервер MSSQL для именованной сессии. <SessionName> - задайте имя сессии для использования в ключах элементов данных. |
||
| Plugins.MSSQL.System.Path | no | Путь к исполняемому файлу плагина MSSQL. Глобальная настройка для плагина MSSQL. Применяется ко всем соединениям. Пример использования: Plugins.MSSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mssql |
||
| Plugins.MSSQL.Timeout | no | 1-30 | global timeout | Продолжительность ожидания ответа сервера в секундах при первом подключении и при последующих операциях в сессии. |
См. также:
- Описание общих параметров конфигурации Zabbix agent 2: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- Инструкции по настройке плагинов