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

См. также: