Table of Contents
12 Plugin do PostgreSQL
Visão geral
O arquivo de configuração do Zabbix agent 2 é usado para configurar plugins. Esses parâmetros de configuração do Zabbix agent 2 são suportados para operar o plugin do PostgreSQL.
Recomenda-se especificá-los em seu próprio arquivo de configuração (por exemplo, postgresql.conf) e, em seguida, usar a diretiva Include para adicionar esse arquivo à configuração do Zabbix agent 2.
O plugin do 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 apenas na codificação UTF-8 sem BOM.
- Comentários iniciados 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
| Parâmetro | Obrigatório | Intervalo | Padrão | Descrição |
|---|---|---|---|---|
| Plugins.PostgreSQL.Default.CacheMode | não | prepare | Modo de cache para a conexão PostgreSQL. Valores suportados: prepare (padrão) - criará instruções preparadas no servidor PostgreSQL; describe - usará a instrução preparada anônima para descrever uma instrução sem criar uma instrução no servidor. Observe que "describe" é útil principalmente quando o ambiente não permite instruções preparadas, como ao executar um pool de conexões como o PgBouncer. |
|
| Plugins.PostgreSQL.CallTimeout | não | 1-30 | timeout global | Tempo máximo de espera (em segundos) para que uma solicitação seja concluída. |
| Plugins.PostgreSQL.CustomQueriesPath | não | /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 contendo arquivos .sql com consultas personalizadas. |
|
| Plugins.PostgreSQL.CustomQueriesEnabled | não | 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 | não | Banco de dados padrão para conexão com o PostgreSQL; usado se nenhum valor for especificado em uma chave de item ou sessão nomeada. | ||
| Plugins.PostgreSQL.Default.Password | não | Senha padrão para conexão com o PostgreSQL; usada se nenhum valor for especificado em uma chave de item ou sessão nomeada. | ||
| Plugins.PostgreSQL.Default.TLSCAFile | não (sim, se Plugins.PostgreSQL.Default.TLSConnect estiver definido como verify_ca ou verify_full) |
Caminho completo de um arquivo contendo o(s) certificado(s) da CA de nível superior para verificação do certificado do par 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.TLSCertFile | não (sim, se Plugins.PostgreSQL.Default.TLSConnect estiver definido como verify_ca ou verify_full) |
Caminho completo de um arquivo contendo o certificado PostgreSQL ou 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 | não | 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 - conectar usando TLS como modo de transporte sem verificações de identidade; verify_ca - conectar usando TLS e verificar o certificado; verify_full - conectar usando TLS, verificar o certificado e verificar se a identidade do banco de dados (CN) especificada por DBHost corresponde ao seu certificado. Tipo de criptografia indefinido significa conexão não criptografada. |
||
| Plugins.PostgreSQL.Default.TLSKeyFile | não (sim, se Plugins.PostgreSQL.Default.TLSConnect estiver definido como verify_ca ou verify_full) |
Caminho completo de um arquivo contendo a chave privada do 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 | não | URI padrão para conexão com o PostgreSQL; usado se nenhum valor for especificado em uma chave de item ou sessão nomeada. Não deve incluir credenciais incorporadas (serão ignoradas). Deve corresponder ao formato URI. Esquemas suportados: tcp, unix.Exemplos: tcp://127.0.0.1:5432tcp://localhostunix:/var/run/postgresql/.s.PGSQL.5432 |
||
| Plugins.PostgreSQL.Default.User | não | Nome de usuário padrão para conexão com o PostgreSQL; usado se nenhum valor for especificado em uma chave de item ou sessão nomeada. | ||
| Plugins.PostgreSQL.KeepAlive | não | 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 | não | 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 servidor PostgreSQL; describe - usará a instrução preparada anônima para descrever uma instrução sem criar uma instrução no servidor. Observe que "describe" é útil principalmente quando o ambiente não permite instruções preparadas, como ao executar um pool de conexões como o PgBouncer. |
|
| Plugins.PostgreSQL.Sessions.<SessionName>.Database | não | Banco de dados para conexão de sessão. <SessionName> - define o nome de uma sessão para uso em chaves de item. |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.Password | não | Deve corresponder ao formato de senha. | Senha para conexão de sessão. <SessionName> - define o nome de uma sessão para uso em chaves de item. |
|
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile | não (sim, se Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect estiver definido como verify_ca ou verify_full) |
Caminho completo de um arquivo contendo o(s) certificado(s) da CA 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 | sim, se Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile for especificado | Caminho completo de um arquivo contendo o certificado PostgreSQL ou cadeia de certificados. <SessionName> - define o nome de uma sessão para uso em chaves de item. |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect | não | Tipo de criptografia para conexão PostgreSQL. <SessionName> - define o nome de uma sessão para uso em chaves de item. Valores suportados: required - conectar usando TLS como modo de transporte sem verificações de identidade; verify_ca - conectar usando TLS e verificar o certificado; verify_full - conectar usando TLS, verificar o certificado e verificar se a identidade do banco de dados (CN) especificada por DBHost corresponde ao seu certificado. Tipo de criptografia indefinido significa conexão não criptografada. |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile | sim, se Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile for especificado | Caminho completo de um arquivo contendo a chave privada do PostgreSQL. <SessionName> - define o nome de uma sessão para uso em chaves de item. |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.Uri | não | 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 incorporadas (serão ignoradas). Deve corresponder ao formato URI. Esquemas suportados: tcp, unix.Exemplos: tcp://127.0.0.1:5432tcp://localhostunix:/var/run/postgresql/.s.PGSQL.5432 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.User | não | 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 | sim | 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 | não | 1-30 | timeout global | 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:
- Descrição dos parâmetros gerais de configuração do Zabbix agent 2: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- Instruções para configuração de plugins