12 Plugin do PostgreSQL

Visão geral

O arquivo de configuração do Zabbix agent 2 é usado para configurar plugins. Estes parâmetros de configuração do Zabbix agent 2 são suportados para operar o plugin PostgreSQL.

Recomenda-se especificá-los em seu próprio arquivo de configuração (por exemplo, postgresql.conf) e então usar a diretiva Include para adicionar esse arquivo à configuração do Zabbix agent 2.

O plugin PostgreSQL é um plugin carregável e está disponível e totalmente descrito no repositório do plugin PostgreSQL.

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.

Opções

Parâmetro Descrição
-V --version Exibe a versão do plugin e informações de licença.
-h --help Exibe informações de ajuda (forma abreviada).
-t, --test <item key> Executa o plugin para teste (configuração do plugin ignorada).

Parâmetros

Parameter Mandatory Range Default Description
Plugins.PostgreSQL.Default.CacheMode no prepare Modo de cache para a conexão PostgreSQL.
Valores suportados:
prepare (padrão) - criará instruções preparadas no server PostgreSQL;
describe - usará a instrução preparada anônima para descrever uma instrução sem criar uma instrução no server.
Observe que "describe" é útil principalmente quando o ambiente não permite instruções preparadas, como ao usar um pooler de conexões como o PgBouncer.
Plugins.PostgreSQL.CallTimeout no 1-30 global timeout Tempo máximo de espera (em segundos) para que uma solicitação seja concluída.
Plugins.PostgreSQL.CustomQueriesPath no /usr/local/share/zabbix/custom-queries/postgreSQL para sistemas Unix

*:\Program Files\Zabbix Agent 2\Custom Queries\PostgreSQL para sistemas Windows, onde * é o nome da unidade da variável de ambiente ProgramFiles		 Caminho completo de um diretório que contém arquivos .sql com consultas personalizadas.
Plugins.PostgreSQL.CustomQueriesEnabled no false Se definido, habilita a execução da chave de item postgresql.custom.query. Se desabilitado, nenhuma consulta será carregada do caminho do diretório de consultas personalizadas.
Plugins.PostgreSQL.Default.Database no Banco de dados padrão para conexão com PostgreSQL; usado se nenhum valor for especificado em uma chave de item ou sessão nomeada.
Plugins.PostgreSQL.Default.Password no Senha padrão para conexão com PostgreSQL; usada se nenhum valor for especificado em uma chave de item ou sessão nomeada.
Plugins.PostgreSQL.Default.TLSCAFile no
(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full)		 Caminho completo de um arquivo que contém o certificado da(s) CA(s) de nível superior para verificação do certificado do par nas comunicações criptografadas entre o Zabbix agent 2 e os bancos de dados monitorados; usado se nenhum valor for especificado em uma sessão nomeada.
Plugins.PostgreSQL.Default.TLSCertFile no
(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full)		 Caminho completo de um arquivo que contém o certificado PostgreSQL ou a cadeia de certificados para comunicações criptografadas entre o Zabbix agent 2 e os bancos de dados monitorados; usado se nenhum valor for especificado em uma sessão nomeada.
Plugins.PostgreSQL.Default.TLSConnect no Tipo de criptografia para comunicações entre o Zabbix agent 2 e os bancos de dados monitorados; usado se nenhum valor for especificado em uma sessão nomeada.
Valores suportados:
required - conecta usando TLS como modo de transporte sem verificações de identidade;
verify_ca - conecta usando TLS e verifica o certificado;
verify_full - conecta usando TLS, verifica o certificado e verifica se a identidade do banco de dados (CN) especificada por DBHost corresponde ao seu certificado.
Tipo de criptografia indefinido significa conexão sem criptografia.
Plugins.PostgreSQL.Default.TLSKeyFile no
(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full)		 Caminho completo de um arquivo que contém a chave privada PostgreSQL para comunicações criptografadas entre o Zabbix agent 2 e os bancos de dados monitorados; usado se nenhum valor for especificado em uma sessão nomeada.
Plugins.PostgreSQL.Default.Uri no URI padrão para conexão com PostgreSQL; usado 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.
Exemplos: tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Default.User no Nome de usuário padrão para conexão com PostgreSQL; usado se nenhum valor for especificado em uma chave de item ou sessão nomeada.
Plugins.PostgreSQL.KeepAlive no 60-900 300 Tempo máximo de espera (em segundos) antes que conexões de plugin não utilizadas sejam fechadas.
Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode no prepare Modo de cache para a conexão PostgreSQL.
<SessionName> - define o nome de uma sessão para uso em chaves de item.
Valores suportados:
prepare (padrão) - criará instruções preparadas no server PostgreSQL;
describe - usará a instrução preparada anônima para descrever uma instrução sem criar uma instrução no server.
Observe que "describe" é útil principalmente quando o ambiente não permite instruções preparadas, como ao usar um pooler de conexões como o PgBouncer.
Plugins.PostgreSQL.Sessions.<SessionName>.Database no Banco de dados para a conexão da sessão.
<SessionName> - define o nome de uma sessão para uso em chaves de item.
Plugins.PostgreSQL.Sessions.<SessionName>.Password no Must match the password format. Senha para a conexão da sessão.
<SessionName> - define o nome de uma sessão para uso em chaves de item.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile no
(yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect is set to verify_ca or verify_full)		 Caminho completo de um arquivo que contém o certificado da(s) CA(s) de nível superior para verificação do certificado do par.
<SessionName> - define o nome de uma sessão para uso em chaves de item.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile is specified Caminho completo de um arquivo que contém o certificado PostgreSQL ou a cadeia de certificados.
<SessionName> - define o nome de uma sessão para uso em chaves de item.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect no Tipo de criptografia para a conexão PostgreSQL.
<SessionName> - define o nome de uma sessão para uso em chaves de item.

Valores suportados:
required - conecta usando TLS como modo de transporte sem verificações de identidade;
verify_ca - conecta usando TLS e verifica o certificado;
verify_full - conecta usando TLS, verifica o certificado e verifica se a identidade do banco de dados (CN) especificada por DBHost corresponde ao seu certificado.
Tipo de criptografia indefinido significa conexão sem criptografia.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile is specified Caminho completo de um arquivo que contém a chave privada PostgreSQL.
<SessionName> - define o nome de uma sessão para uso em chaves de item.
Plugins.PostgreSQL.Sessions.<SessionName>.Uri no String de conexão de uma sessão nomeada.
<SessionName> - define o nome de uma sessão para uso em chaves de item.

Não deve incluir credenciais embutidas (elas serão ignoradas).
Deve corresponder ao formato de URI.
Esquemas suportados: tcp, unix.
Exemplos: tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Sessions.<SessionName>.User no Nome de usuário da sessão nomeada.
<SessionName> - define o nome de uma sessão para uso em chaves de item.
Plugins.PostgreSQL.System.Path yes Caminho para o executável do plugin PostgreSQL.
Exemplo de uso: Plugins.PostgreSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-postgresql
Plugins.PostgreSQL.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: