Plugin Redis

Visão geral

Os parâmetros de configuração permitem personalizar o comportamento do plugin Redis.

Recomenda-se especificá-los em seu próprio arquivo de configuração (por exemplo, redis.conf), em vez de no arquivo de configuração do agent 2. Em seguida, use a diretiva Include para incluir esse arquivo na configuração do Zabbix agent 2.

Todos os parâmetros são opcionais, a menos que seja explicitamente indicado que o parâmetro é obrigatório.

Observe que:

  • Os valores padrão refletem os padrões do processo, não os valores nos arquivos de configuração fornecidos.
  • Os valores suportam variáveis de ambiente.
  • O Zabbix suporta arquivos de configuração somente em codificação UTF-8 sem BOM.
  • Comentários que começam com "#" são suportados apenas no início da linha.

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

Parâmetros

Parameter Mandatory Range Default Description
Plugins.Redis.Default.Password no Senha padrão para conexão com o Redis; usada se nenhum valor for especificado em uma chave de item ou sessão nomeada.
Plugins.Redis.Default.TLSConnect no Requisito de verificação TLS do cliente (Zabbix agent 2).

Valores suportados:
required - criptografado, não verificado (apenas para testes)
verify_ca - criptografado, certificado do server
verify_full - criptografado, certificado do server e nome do server verificado com SAN
Um valor vazio ou não definido é tratado como sem TLS.
Plugins.Redis.Default.TLSCAFile no Caminho completo padrão de um arquivo que contém os certificados da(s) CA(s) de nível superior.
Plugins.Redis.Default.TLSCertFile no Caminho completo padrão de um arquivo que contém o certificado do agent.
Plugins.Redis.Default.TLSKeyFile no Caminho completo padrão de um arquivo que contém a chave privada do agent.
Plugins.Redis.Default.Uri no tcp://localhost:6379 URI padrão para conexão com o Redis; usada se nenhum valor for especificado em uma chave de item ou sessão nomeada.

Não deve incluir credenciais embutidas (elas serão ignoradas).
Deve corresponder ao formato de URI.
Esquemas suportados: tcp, unix; um esquema pode ser omitido.
Uma porta pode ser omitida (padrão=6379).
Exemplos: tcp://localhost:6379
localhost
unix:/var/run/redis.sock
Plugins.Redis.Default.User no default Usuário padrão a ser enviado ao server Redis protegido; usado se nenhum valor for especificado em uma chave de item ou sessão nomeada.
Plugins.Redis.KeepAlive no 60-900 300 Tempo máximo de espera (em segundos) antes que conexões de plugin não utilizadas sejam encerradas.
Plugins.Redis.Sessions.<SessionName>.Password no Senha da sessão nomeada.
<SessionName> - define o nome da sessão a ser usado nas chaves de item.
Plugins.Redis.Sessions.<SessionName>.TLSConnect no Requisito de verificação TLS do cliente (Zabbix agent 2).
<SessionName> - define o nome da sessão a ser usado nas chaves de item.

Valores suportados:
required - criptografado, não verificado (apenas para testes)
verify_ca - criptografado, certificado do server
verify_full - criptografado, certificado do server e nome do server verificado com SAN
Um valor vazio ou não definido é tratado como sem TLS.
Plugins.Redis.Sessions.<SessionName>.TLSCAFile no
(yes, if TLSConnect is verify_ca or verify_full)		 Caminho completo de um arquivo que contém os certificados da(s) CA(s) de nível superior para verificação do certificado do server Redis.
<SessionName> - define o nome da sessão a ser usado nas chaves de item.
Plugins.Redis.Sessions.<SessionName>.TLSCertFile no Caminho completo de um arquivo que contém o certificado do agent para autenticação do cliente.
<SessionName> - define o nome da sessão a ser usado nas chaves de item.
Plugins.Redis.Sessions.<SessionName>.TLSKeyFile no Caminho completo de um arquivo que contém a chave privada do agent para autenticação do cliente.
<SessionName> - define o nome da sessão a ser usado nas chaves de item.
Plugins.Redis.Sessions.<SessionName>.Uri no localhost:6379 String de conexão de uma sessão nomeada.
<SessionName> - define o nome da sessão a ser usado nas chaves de item.

Não deve incluir credenciais embutidas (elas serão ignoradas).
Deve corresponder ao formato de URI.
Esquemas suportados: tcp, unix; um esquema pode ser omitido.
Uma porta pode ser omitida (padrão=6379).
Exemplos: tcp://localhost:6379
localhost
unix:/var/run/redis.sock
Plugins.Redis.Sessions.<SessionName>.User no default Usuário a ser enviado ao server Redis protegido.
<SessionName> - define o nome da sessão a ser usado nas chaves de item.
Plugins.Redis.Timeout no 1-30 global timeout Tempo limite de execução da solicitação (a duração, em segundos, para aguardar a conclusão de uma solicitação antes de encerrá-la).

Veja também: