8 Плагин MSSQL

Обзор

Файл конфигурации агента Zabbix 2 используется для настройки плагинов. Для работы плагина MSSQL поддерживаются следующие параметры конфигурации агента Zabbix 2.

Рекомендуется указывать их в отдельном файле конфигурации (например, mssql.conf), а затем использовать директиву Include для добавления этого файла в конфигурацию агента Zabbix 2.

Плагин MSSQL является загружаемым плагином и доступен, а также полностью описан в репозитории плагина MSSQL.

Обратите внимание:

  • Значения по умолчанию отражают значения по умолчанию процесса, а не значения в поставляемых файлах конфигурации.
  • Значения поддерживают переменные среды;
  • Zabbix поддерживает файлы конфигурации только в кодировке UTF-8 без BOM.
  • Комментарии, начинающиеся с "#", поддерживаются только в начале строки.

Параметры

Параметр Описание
-V --version Вывести версию плагина и информацию о лицензии.
-h --help Вывести справочную информацию (краткая форма).
-t, --test <item key> Запустить плагин для тестирования (конфигурация плагина игнорируется).

Параметры

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

См. также: