12 Плагин PostgreSQL

Обзор

В этом разделе перечислены параметры, поддерживаемые в файле конфигурации плагина PostgreSQL для агента 2 Zabbix (postgresql.conf).

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

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

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

Опции

Параметр Описание
-V --version Вывести версию плагина и информацию о лицензии.
-h --help Распечатать справочную информацию (сокращённо).

Параметры

Parameter Mandatory Range Default Description
Plugins.PostgreSQL.Default.CacheMode no prepare Режим кэширования для подключения PostgreSQL.
Поддерживаемые значения:
prepare (по умолчанию) - создаст подготовленные операторы на сервере PostgreSQL;
describe - будет использовать анонимный подготовленный оператор для описания оператора без создания оператора на сервере.
Обратите внимание, что "describe" в первую очередь полезен, когда среда не позволяет использовать подготовленные операторы, например при работе через пул соединений, такой как PgBouncer.
Plugins.PostgreSQL.CallTimeout no 1-30 global timeout Максимальное время ожидания (в секундах) завершения запроса.
Plugins.PostgreSQL.CustomQueriesPath no /usr/local/share/zabbix/custom-queries/postgreSQL для Unix-систем

*:\Program Files\Zabbix Agent 2\Custom Queries\PostgreSQL для Windows-систем, где * - имя диска из переменной среды ProgramFiles		 Полный путь к каталогу, содержащему файлы .sql с пользовательскими запросами.
Plugins.PostgreSQL.CustomQueriesEnabled no false Если задано, включает выполнение ключа элемента данных postgresql.custom.query. Если отключено, запросы не будут загружаться из пути каталога пользовательских запросов.
Plugins.PostgreSQL.Default.Database no База данных по умолчанию для подключения к PostgreSQL; используется, если значение не указано в ключе элемента данных или именованной сессии.
Plugins.PostgreSQL.Default.Password no Пароль по умолчанию для подключения к PostgreSQL; используется, если значение не указано в ключе элемента данных или именованной сессии.
Plugins.PostgreSQL.Default.TLSCAFile no
(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full)		 Полный путь к файлу, содержащему сертификат(ы) CA верхнего уровня для проверки сертификата узла при зашифрованной связи между Zabbix agent 2 и контролируемыми базами данных; используется, если значение не указано в именованной сессии.
Plugins.PostgreSQL.Default.TLSCertFile no
(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full)		 Полный путь к файлу, содержащему сертификат PostgreSQL или цепочку сертификатов для зашифрованной связи между Zabbix agent 2 и контролируемыми базами данных; используется, если значение не указано в именованной сессии.
Plugins.PostgreSQL.Default.TLSConnect no Тип шифрования для связи между Zabbix agent 2 и контролируемыми базами данных; используется, если значение не указано в именованной сессии.
Поддерживаемые значения:
required - подключение с использованием TLS в качестве транспортного режима без проверки идентичности;
verify_ca - подключение с использованием TLS и проверкой сертификата;
verify_full - подключение с использованием TLS, проверкой сертификата и проверкой того, что идентификатор базы данных (CN), указанный DBHost, совпадает с ее сертификатом.
Неопределенный тип шифрования означает незашифрованное соединение.
Plugins.PostgreSQL.Default.TLSKeyFile no
(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full)		 Полный путь к файлу, содержащему закрытый ключ PostgreSQL для зашифрованной связи между Zabbix agent 2 и контролируемыми базами данных; используется, если значение не указано в именованной сессии.
Plugins.PostgreSQL.Default.Uri no URI по умолчанию для подключения к PostgreSQL; используется, если значение не указано в ключе элемента данных или именованной сессии.

Не должен включать встроенные учетные данные (они будут проигнорированы).
Должен соответствовать формату URI.
Поддерживаемые схемы: tcp, unix.
Примеры: tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Default.User no Имя пользователя по умолчанию для подключения к PostgreSQL; используется, если значение не указано в ключе элемента данных или именованной сессии.
Plugins.PostgreSQL.KeepAlive no 60-900 300 Максимальное время ожидания (в секундах) перед закрытием неиспользуемых подключений плагина.
Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode no prepare Режим кэширования для подключения PostgreSQL.
<SessionName> - задает имя сессии для использования в ключах элементов данных.
Поддерживаемые значения:
prepare (по умолчанию) - создаст подготовленные операторы на сервере PostgreSQL;
describe - будет использовать анонимный подготовленный оператор для описания оператора без создания оператора на сервере.
Обратите внимание, что "describe" в первую очередь полезен, когда среда не позволяет использовать подготовленные операторы, например при работе через пул соединений, такой как PgBouncer.
Plugins.PostgreSQL.Sessions.<SessionName>.Database no База данных для подключения сессии.
<SessionName> - задает имя сессии для использования в ключах элементов данных.
Plugins.PostgreSQL.Sessions.<SessionName>.Password no Must match the password format. Пароль для подключения сессии.
<SessionName> - задает имя сессии для использования в ключах элементов данных.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile no
(yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect is set to verify_ca or verify_full)		 Полный путь к файлу, содержащему сертификат(ы) CA верхнего уровня для проверки сертификата узла.
<SessionName> - задает имя сессии для использования в ключах элементов данных.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile is specified Полный путь к файлу, содержащему сертификат PostgreSQL или цепочку сертификатов.
<SessionName> - задает имя сессии для использования в ключах элементов данных.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect no Тип шифрования для подключения PostgreSQL.
<SessionName> - задает имя сессии для использования в ключах элементов данных.

Поддерживаемые значения:
required - подключение с использованием TLS в качестве транспортного режима без проверки идентичности;
verify_ca - подключение с использованием TLS и проверкой сертификата;
verify_full - подключение с использованием TLS, проверкой сертификата и проверкой того, что идентификатор базы данных (CN), указанный DBHost, совпадает с ее сертификатом.
Неопределенный тип шифрования означает незашифрованное соединение.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile is specified Полный путь к файлу, содержащему закрытый ключ PostgreSQL.
<SessionName> - задает имя сессии для использования в ключах элементов данных.
Plugins.PostgreSQL.Sessions.<SessionName>.Uri no Строка подключения именованной сессии.
<SessionName> - задает имя сессии для использования в ключах элементов данных.

Не должен включать встроенные учетные данные (они будут проигнорированы).
Должен соответствовать формату URI.
Поддерживаемые схемы: tcp, unix.
Примеры: tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Sessions.<SessionName>.User no Имя пользователя именованной сессии.
<SessionName> - задает имя сессии для использования в ключах элементов данных.
Plugins.PostgreSQL.System.Path yes Путь к исполняемому файлу плагина PostgreSQL.
Пример использования: Plugins.PostgreSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-postgresql
Plugins.PostgreSQL.Timeout no 1-30 global timeout Таймаут выполнения запроса (время ожидания, в секундах, по истечении которого запрос будет остановлен).

См. также: