12 Плагин PostgreSQL

Обзор

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

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

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

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

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

Параметры

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

Параметры

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

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

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

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

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

См. также: