Плагин Redis

Обзор

Параметры конфигурации позволяют настраивать поведение плагина Redis.

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

Все параметры являются необязательными, если явно не указано, что параметр обязателен.

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

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

Parameter details

Plugins.Redis.Default.Password

Specify the default password for connecting to Redis.
Used if no value is specified in an item key or named session.

Plugins.Redis.Default.TLSConnect

Specify the level of encryption required for Zabbix agent 2 communications.
An empty or unset value is treated as no TLS.

Range: required - encrypted, unverified (only for testing), verify_ca - encrypted, server certificate, verify_full - encrypted, server certificate and server name verified with SAN

Plugins.Redis.Default.TLSCAFile

Specify full pathname of the file containing the top-level CA(s) certificates.

Plugins.Redis.Default.TLSCertFile

Specify full pathname of the file containing the agent certificate.

Plugins.Redis.Default.TLSKeyFile

Specify full pathname of the file containing the agent private key.

Plugins.Redis.Default.Uri

Specify the default URI for connecting to Redis.
Used if no value is specified in an item key or named session.
Embedded credentials will be ignored. Must match the URI format.
Supported schemes: tcp, unix
A scheme can be omitted.
A port can be omitted (default=6379).

Default: tcp://localhost:6379

Examples:

tcp://localhost:6379
localhost
unix:/var/run/redis.sock
Plugins.Redis.Default.User

Specify the default username for connecting to Redis.
Used if no value is specified in an item key or named session.

Default: default

Plugins.Redis.KeepAlive

Set the maximum time of waiting (in seconds) before unused plugin connections are closed.

Default: 300 Range: 60-900

Plugins.Redis.Sessions.<SessionName>.Password

Specify the named session password for connecting to Redis.
<SessionName> - define the session name to be used in item keys.

Plugins.Redis.Sessions.<SessionName>.TLSConnect

Specify the level of encryption required for Zabbix agent 2 communications for named session.
<SessionName> - define the session name to be used in item keys.
An empty or unset value is treated as no TLS.

Range: required - encrypted, unverified (only for testing), verify_ca - encrypted, server certificate, verify_full - encrypted, server certificate and server name verified with SAN

Plugins.Redis.Sessions.<SessionName>.TLSCAFile

Specify full pathname of the file containing the top-level CA(s) certificates for named session.
<SessionName> - define the session name to be used in item keys.

Mandatory: yes, if Plugins.Redis.Sessions.<SessionName>.TLSConnect is set to verify_ca or verify_full

Plugins.Redis.Sessions.<SessionName>.TLSCertFile

Specify full pathname of the file containing containing the agent certificate for named session.
<SessionName> - define the session name to be used in item keys.

Plugins.Redis.Sessions.<SessionName>.TLSKeyFile

Specify full pathname of the file containing the agent private key for named session.
<SessionName> - define the session name to be used in item keys.

Plugins.Redis.Sessions.<SessionName>.Uri

Specify the named session URI for connecting to Redis.
<SessionName> - define the session name to be used in item keys.
Embedded credentials will be ignored. Must match the URI format.
Supported schemes: tcp, unix
A scheme can be omitted.
A port can be omitted (default=6379).

Default: tcp://localhost:6379

Examples:

tcp://localhost:6379
localhost
unix:/var/run/redis.sock
Plugins.Redis.Sessions.<SessionName>.User

Specify the named session username for connecting to Redis.
<SessionName> - define the session name to be used in item keys.

Plugins.Redis.Timeout

Set the request execution timeout (the duration, in seconds, to wait for a request to complete before shutting it down).

Default: global timeout Range: 1-30

Параметры

Parameter Mandatory Range Default Description
Plugins.Redis.Default.Password no Пароль по умолчанию для подключения к Redis; используется, если в ключе элемента данных или именованной сессии не указано значение.
Plugins.Redis.Default.TLSConnect no Требование к проверке TLS на стороне клиента (Zabbix agent 2).

Поддерживаемые значения:
required - зашифрованное, без проверки (только для тестирования)
verify_ca - зашифрованное, сертификат сервера
verify_full - зашифрованное, сертификат сервера и имя сервера проверяются с помощью SAN
Пустое или не заданное значение считается отсутствием TLS.
Plugins.Redis.Default.TLSCAFile no Полный путь к файлу, содержащему сертификаты корневого центра сертификации (CA).
Plugins.Redis.Default.TLSCertFile no Полный путь к файлу, содержащему сертификат агента.
Plugins.Redis.Default.TLSKeyFile no Полный путь к файлу, содержащему закрытый ключ агента.
Plugins.Redis.Default.Uri no tcp://localhost:6379 URI по умолчанию для подключения к Redis; используется, если в ключе элемента данных или именованной сессии не указано значение.

Не должен содержать встроенные учетные данные (они будут проигнорированы).
Должен соответствовать формату URI.
Поддерживаемые схемы: tcp, unix; схема может быть опущена.
Порт может быть опущен (по умолчанию=6379).
Примеры: tcp://localhost:6379
localhost
unix:/var/run/redis.sock
Plugins.Redis.Default.User no default Пользователь по умолчанию для отправки на защищенный сервер Redis; используется, если в ключе элемента данных или именованной сессии не указано значение.
Plugins.Redis.KeepAlive no 60-900 300 Максимальное время ожидания (в секундах) перед закрытием неиспользуемых подключений плагина.
Plugins.Redis.Sessions.<SessionName>.Password no Пароль именованной сессии.
<SessionName> - задает имя сессии, которое будет использоваться в ключах элементов данных.
Plugins.Redis.Sessions.<SessionName>.TLSConnect no Требование к проверке TLS на стороне клиента (Zabbix agent 2).
<SessionName> - задает имя сессии, которое будет использоваться в ключах элементов данных.

Поддерживаемые значения:
required - зашифрованное, без проверки (только для тестирования)
verify_ca - зашифрованное, сертификат сервера
verify_full - зашифрованное, сертификат сервера и имя сервера проверяются с помощью SAN
Пустое или не заданное значение считается отсутствием TLS.
Plugins.Redis.Sessions.<SessionName>.TLSCAFile no
(yes, if TLSConnect is verify_ca or verify_full)		 Полный путь к файлу, содержащему сертификаты корневого центра сертификации (CA) для проверки сертификата сервера Redis.
<SessionName> - задает имя сессии, которое будет использоваться в ключах элементов данных.
Plugins.Redis.Sessions.<SessionName>.TLSCertFile no Полный путь к файлу, содержащему сертификат агента для аутентификации клиента.
<SessionName> - задает имя сессии, которое будет использоваться в ключах элементов данных.
Plugins.Redis.Sessions.<SessionName>.TLSKeyFile no Полный путь к файлу, содержащему закрытый ключ агента для аутентификации клиента.
<SessionName> - задает имя сессии, которое будет использоваться в ключах элементов данных.
Plugins.Redis.Sessions.<SessionName>.Uri no localhost:6379 Строка подключения именованной сессии.
<SessionName> - задает имя сессии, которое будет использоваться в ключах элементов данных.

Не должен содержать встроенные учетные данные (они будут проигнорированы).
Должен соответствовать формату URI.
Поддерживаемые схемы: tcp, unix; схема может быть опущена.
Порт может быть опущен (по умолчанию=6379).
Примеры: tcp://localhost:6379
localhost
unix:/var/run/redis.sock
Plugins.Redis.Sessions.<SessionName>.User no default Пользователь для отправки на защищенный сервер Redis.
<SessionName> - задает имя сессии, которое будет использоваться в ключах элементов данных.
Plugins.Redis.Timeout no 1-30 global timeout Тайм-аут выполнения запроса (время ожидания, в секундах, завершения запроса перед его остановкой).

См. также: