8 Плагин MSSQL

Обзор

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

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

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

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

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

Параметры

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

Параметры

Параметр Обязательный Диапазон По умолчанию Описание
Plugins.MSSQL.CustomQueriesDir нет /usr/local/share/zabbix/custom-queries/mssql для Unix-систем

*:\Program Files\Zabbix Agent 2\Custom Queries\MSSQL для Windows-систем, где * — имя диска из переменной окружения ProgramFiles		 Указывает путь к каталогу, содержащему определяемые пользователем файлы .sql с пользовательскими запросами, которые может выполнять плагин. При запуске плагин загружает все доступные файлы .sql из настроенного каталога. Это означает, что любые изменения в файлах пользовательских запросов не будут применены до перезапуска плагина. Плагин запускается и останавливается вместе с Zabbix агент 2.
Plugins.MSSQL.CustomQueriesEnabled нет false Если установлено, включает выполнение ключа элемента данных mssql.custom.query. Если отключено, из пути к каталогу пользовательских запросов не будет загружено ни одного запроса.
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 нет Общее имя (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.<SessionName>.CACertPath нет Путь к файлу сертификата открытого ключа центра сертификации (CA), который выдал сертификат сервера MSSQL, для именованной сессии. Сертификат должен быть в формате PEM.
<SessionName> — задайте имя сессии для использования в ключах элементов данных.
Plugins.MSSQL.Sessions.<SessionName>.Database нет Имя базы данных для подключения для именованной сессии.
<SessionName> — задайте имя сессии для использования в ключах элементов данных.
Plugins.MSSQL.Sessions.<SessionName>.Encrypt нет Определяет тип шифрования соединения для именованной сессии. Возможные значения:
true — передача данных между плагином и сервером шифруется;
false — передача данных между плагином и сервером не шифруется, кроме пакета входа в систему;
strict — передача данных между плагином и сервером шифруется по схеме E2E с использованием TDS8;
disable — передача данных между плагином и сервером не шифруется.
<SessionName> — задайте имя сессии для использования в ключах элементов данных.
Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate нет Общее имя (CN) сертификата сервера MSSQL для именованной сессии.
<SessionName> — задайте имя сессии для использования в ключах элементов данных.
Plugins.MSSQL.Sessions.<SessionName>.Password нет Пароль, который будет отправляться на защищённый сервер MSSQL для именованной сессии.
<SessionName> — задайте имя сессии для использования в ключах элементов данных.
Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion нет Минимальная версия TLS для именованной сессии. Возможные значения: 1.0, 1.1, 1.2, 1.3.
<SessionName> — задайте имя сессии для использования в ключах элементов данных.
Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate нет Следует ли плагину доверять сертификату сервера без его проверки для именованной сессии. Возможные значения: true, false.
<SessionName> — задайте имя сессии для использования в ключах элементов данных.
Plugins.MSSQL.Sessions.<SessionName>.Uri нет sqlserver://localhost:1433 URI для подключения для именованной сессии. Поддерживается только схема sqlserver://. Схему можно опустить. Встроенные учётные данные будут проигнорированы.
<SessionName> — задайте имя сессии для использования в ключах элементов данных.
Plugins.MSSQL.Sessions.<SessionName>.User нет Имя пользователя, которое будет отправляться на защищённый сервер MSSQL для именованной сессии.
<SessionName> — задайте имя сессии для использования в ключах элементов данных.
Plugins.MSSQL.System.Path нет Путь к исполняемому файлу плагина MSSQL.
Глобальная настройка для плагина MSSQL. Применяется ко всем соединениям.
Пример использования: Plugins.MSSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mssql
Plugins.MSSQL.Timeout нет 1-30 глобальный тайм-аут Время в секундах, в течение которого ожидается ответ сервера при первоначальном подключении и при последующих операциях в сессии.

См. также: