Parâmetros de configuração: Zabbix proxy
Visão geral
Os parâmetros de configuração permitem personalizar o comportamento do proxy do Zabbix.
Especifique os valores dos parâmetros no arquivo de configuração (zabbix_proxy.conf). Todos os parâmetros são opcionais, a menos que seja explicitamente indicado que o parâmetro é obrigatório.
Esta página está estruturada da seguinte forma:
- Visão geral dos parâmetros (para ver os detalhes completos de um parâmetro, clique no nome dele)
- Detalhes dos parâmetros
| Parameter | Description |
|---|---|
| AllowRoot | Permite que o proxy seja executado como root. |
| AllowUnsupportedDBVersions | Permite que o proxy funcione com versões de banco de dados sem suporte. |
| CacheSize | Define o tamanho do cache de configuração. |
| ConfigFrequency | Este parâmetro está obsoleto (use ProxyConfigFrequency em vez disso). Define a frequência de recuperação dos dados de configuração do Zabbix server. |
| DataSenderFrequency | Define a frequência de envio dos dados coletados para o Zabbix server. |
| DBHost | Especifica o host do banco de dados (ou o diretório do socket). |
| DBName | Especifica o nome do banco de dados ou o caminho para o arquivo de banco de dados do SQLite3. |
| DBPassword | Especifica a senha do banco de dados. |
| DBPort | Especifica a porta do host do banco de dados do Zabbix. |
| DBSchema | Especifica o nome do schema do banco de dados. Usado para PostgreSQL. |
| DBSocket | Especifica o caminho para o arquivo de socket do MySQL. |
| DBUser | Especifica o usuário do banco de dados. |
| DBTLSConnect | Especifica um valor para impor uma conexão TLS com o banco de dados. |
| DBTLSCAFile | Especifica o caminho completo do arquivo que contém os certificados da CA de nível superior para verificação do certificado do banco de dados. |
| DBTLSCertFile | Especifica o caminho completo do arquivo que contém o certificado do proxy do Zabbix para autenticação no banco de dados. |
| DBTLSKeyFile | Especifica o caminho completo do arquivo que contém a chave privada para autenticação no banco de dados. |
| DBTLSCipher | Especifica a lista de cifras de criptografia que o proxy do Zabbix permite para protocolos TLS até TLS v1.2. Suportado apenas para MySQL. |
| DBTLSCipher13 | Especifica a lista de suites de cifras de criptografia que o proxy do Zabbix permite para o protocolo TLS v1.3. Suportado apenas para MySQL, a partir da versão 8.0.16. |
| DebugLevel | Define o nível de depuração. |
| EnableRemoteCommands | Permite comandos remotos do Zabbix server. |
| ExternalScripts | Especifica o local dos scripts externos. |
| Fping6Location | Especifica o local do fping6. |
| FpingLocation | Especifica o local do fping. |
| HistoryCacheSize | Define o tamanho do cache de histórico. |
| HistoryIndexCacheSize | Define o tamanho do cache do índice de histórico. |
| Hostname | Especifica o nome do proxy. |
| HostnameItem | Especifica o item usado para definir Hostname (se indefinido). |
| HousekeepingFrequency | Define a frequência do procedimento de housekeeping (em horas). |
| Include | Especifica um diretório ou arquivos individuais a serem incluídos no arquivo de configuração. |
| JavaGateway | Especifica o endereço IP (ou hostname) do Zabbix Java gateway. |
| JavaGatewayPort | Especifica a porta do Zabbix Java gateway. |
| ListenBacklog | Define o número máximo de conexões pendentes na fila TCP. |
| ListenIP | Especifica o endereço IP de escuta do trapper. |
| ListenPort | Especifica a porta de escuta do trapper. |
| LoadModule | Especifica o módulo a ser carregado na inicialização do proxy. |
| LoadModulePath | Especifica o caminho completo para o local dos módulos do proxy. |
| LogFile | Especifica o arquivo de log do proxy. |
| LogFileSize | Define o tamanho máximo do arquivo de log. |
| LogRemoteCommands | Ativa o registro de comandos de shell executados como avisos. |
| LogSlowQueries | Define a duração máxima que uma consulta ao banco de dados pode levar antes de ser registrada (em milissegundos). |
| LogType | Especifica o tipo de saída de log. |
| MaxConcurrentChecksPerPoller | Define o número máximo de verificações assíncronas que podem ser executadas ao mesmo tempo por cada HTTP agent poller, agent poller ou SNMP poller. |
| PidFile | Especifica o arquivo PID. |
| ProxyBufferMode | Especifica o mecanismo de armazenamento para dados de histórico, descoberta e autoregistro (disco/memória/híbrido). |
| ProxyConfigFrequency | Define a frequência de recuperação dos dados de configuração do Zabbix server em segundos. |
| ProxyLocalBuffer | Define a duração de retenção dos dados localmente (em horas), mesmo que os dados já tenham sido sincronizados com o server. |
| ProxyMemoryBufferAge | Define a idade máxima dos dados no buffer de memória do proxy em segundos. |
| ProxyMemoryBufferSize | Define o tamanho do cache em memória compartilhada para dados coletados de histórico, descoberta e autoregistro. |
| ProxyMode | Define o modo de operação do proxy (ativo/passivo). |
| ProxyOfflineBuffer | Define a duração de retenção dos dados (em horas) em caso de falta de conectividade com o Zabbix server. |
| Server | Se ProxyMode estiver definido como active: especifique o endereço IP ou o nome DNS do Zabbix server (address:port) ou o cluster (address:port;address2:port) para obter os dados de configuração e enviar os dados.Se ProxyMode estiver definido como passive: especifique os endereços IP ou nomes DNS do Zabbix server. |
| SNMPTrapperFile | Especifica o arquivo temporário usado para passar dados do daemon de trap SNMP para o proxy. |
| SocketDir | Especifica o diretório para armazenar sockets IPC usados pelos serviços internos do Zabbix. |
| SourceIP | Especifica o endereço IP de origem. |
| SSHKeyLocation | Especifica o local das chaves pública e privada para verificações e ações SSH. |
| SSLCertLocation | Especifica o local dos arquivos de certificado SSL-client para autenticação do cliente. |
| SSLKeyLocation | Especifica o local dos arquivos de chave privada SSL para autenticação do cliente. |
| SSLCALocation | Especifica o local dos arquivos da autoridade certificadora (CA) para verificação do certificado do servidor SSL. |
| StartAgentPollers | Define o número de instâncias pré-fork de agent pollers assíncronos do Zabbix. |
| StartBrowserPollers | Define o número de instâncias pré-fork de browser item pollers. |
| StartDBSyncers | Define o número de instâncias pré-fork de sincronizadores de histórico. |
| StartDiscoverers | Define o número de instâncias pré-fork de workers de descoberta. |
| StartHTTPAgentPollers | Define o número de instâncias pré-fork de HTTP agent pollers assíncronos. |
| StartHTTPPollers | Define o número de instâncias pré-fork de HTTP pollers. |
| StartIPMIPollers | Define o número de instâncias pré-fork de IPMI pollers. |
| StartJavaPollers | Define o número de instâncias pré-fork de Java pollers. |
| StartODBCPollers | Define o número de instâncias pré-fork de ODBC pollers. |
| StartPingers | Define o número de instâncias pré-fork de ICMP pingers. |
| StartPollersUnreachable | Define o número de instâncias pré-fork de pollers para hosts inacessíveis (incluindo IPMI e Java). |
| StartPollers | Define o número de instâncias pré-fork de pollers. |
| StartPreprocessors | Define o número de instâncias pré-iniciadas de workers de pré-processamento. |
| StartSNMPPollers | Define o número de instâncias pré-fork de SNMP pollers assíncronos. |
| StartSNMPTrapper | Defina como "1" para iniciar um processo SNMP trapper. |
| StartTrappers | Define o número de instâncias pré-fork de trappers. |
| StartVMwareCollectors | Define o número de instâncias pré-fork de coletores VMware. |
| StatsAllowedIP | Especifica os endereços IP ou nomes DNS de instâncias externas do Zabbix que têm permissão para solicitar estatísticas. |
| Timeout | Especifica quanto tempo aguardar (em segundos) para estabelecer conexão e trocar dados com o proxy do Zabbix, agent, serviço web e para verificações SNMP (exceto itens SNMP walk[OID] e get[OID]). |
| TLSAccept | Especifica o nível de criptografia exigido para conexões de entrada do Zabbix server. |
| TLSCAFile | Especifica o caminho completo do arquivo que contém os certificados da CA de nível superior para verificação do certificado do par, usado para comunicações criptografadas entre componentes do Zabbix. |
| TLSCertFile | Especifica o caminho completo do arquivo que contém o certificado do servidor ou a cadeia de certificados, usado para comunicações criptografadas entre componentes do Zabbix. |
| TLSCipherAll | Especifica a string de prioridade do GnuTLS ou a string de cifras do OpenSSL (TLS 1.2). Substitui os critérios padrão de seleção de suite de cifras para criptografia baseada em certificado e PSK. |
| TLSCipherAll13 | Especifica a string de cifras para OpenSSL 1.1.1 ou mais recente em TLS 1.3. Substitui os critérios padrão de seleção de suite de cifras para criptografia baseada em certificado e PSK. |
| TLSCipherCert | Especifica a string de prioridade do GnuTLS ou a string de cifras do OpenSSL (TLS 1.2). Substitui os critérios padrão de seleção de suite de cifras para criptografia baseada em certificado. |
| TLSCipherCert13 | Especifica a string de cifras para OpenSSL 1.1.1 ou mais recente em TLS 1.3. Substitui os critérios padrão de seleção de suite de cifras para criptografia baseada em certificado. |
| TLSCipherPSK | Especifica a string de prioridade do GnuTLS ou a string de cifras do OpenSSL (TLS 1.2). Substitui os critérios padrão de seleção de suite de cifras para criptografia baseada em PSK. |
| TLSCipherPSK13 | Especifica a string de cifras para OpenSSL 1.1.1 ou mais recente em TLS 1.3. Substitui os critérios padrão de seleção de suite de cifras para criptografia baseada em PSK. |
| TLSConnect | Especifica o nível de criptografia exigido para conexões com o Zabbix server. |
| TLSCRLFile | Especifica o caminho completo do arquivo que contém certificados revogados. Este parâmetro é usado para comunicações criptografadas entre componentes do Zabbix. |
| TLSKeyFile | Especifica o caminho completo do arquivo que contém a chave privada do proxy, usada para comunicações criptografadas entre componentes do Zabbix. |
| TLSListen | Exige conexões somente TLS no socket do trapper. |
| TLSPSKFile | Especifica o caminho completo do arquivo que contém a chave pré-compartilhada do proxy, usada para comunicações criptografadas com o Zabbix server. |
| TLSPSKIdentity | Especifica a string de identidade da chave pré-compartilhada, usada para comunicações criptografadas com o Zabbix server. |
| TLSServerCertIssuer | Especifica o emissor permitido do certificado do servidor. |
| TLSServerCertSubject | Especifica o subject permitido do certificado do servidor. |
| TmpDir | Especifica o diretório temporário. |
| TrapperTimeout | Especifica o timeout em segundos para: - recuperação de dados de configuração do Zabbix server; - execução de script global ou execução de comando remoto. |
| UnavailableDelay | Define a frequência de verificação da disponibilidade do host durante o período de indisponibilidade. |
| UnreachableDelay | Define a frequência de verificação da disponibilidade do host durante o período de inacessibilidade. |
| UnreachablePeriod | Define após quantos segundos de inacessibilidade o host deve ser tratado como indisponível. |
| User | Remove privilégios para um usuário específico e existente no sistema. |
| Vault | Especifica o provedor de vault. |
| VaultDBPath | Especifica o local para recuperar credenciais do banco de dados por meio de chaves. |
| VaultPrefix | Especifica um prefixo personalizado para o caminho ou consulta do vault. |
| VaultTLSCertFile | Especifica o nome do arquivo de certificado SSL usado para autenticação do cliente. |
| VaultTLSKeyFile | Especifica o nome do arquivo de chave privada SSL usado para autenticação do cliente. |
| VaultToken | Especifica o token de autenticação do HashiCorp vault. |
| VaultURL | Especifica a URL do servidor vault. |
| VMwareCacheSize | Define o tamanho da memória compartilhada para armazenar dados do VMware. |
| VMwareFrequency | Define a frequência de coleta de dados de um único serviço VMware em segundos. |
| VMwarePerfFrequency | Define a frequência de recuperação das estatísticas de contadores de desempenho de um único serviço VMware em segundos. |
| VMwareTimeout | Define o número máximo de segundos que um vmware collector aguardará por uma resposta do serviço VMware. |
| WebDriverURL | Especifica a URL da interface WebDriver. |
Observe que:
- Os valores padrão refletem os padrões do daemon, 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 em codificação UTF-8 sem BOM.
- Comentários que começam com "#" são suportados apenas no início da linha.
Detalhes do parâmetro
AllowRoot
Permite que o proxy seja executado como root.
Se estiver desativado e o proxy for iniciado por root, o proxy tentará alternar para o usuário zabbix.
Não tem efeito se for iniciado por um usuário comum.
Padrão: 0
Valores: 0 - não permitir; 1 - permitir
AllowUnsupportedDBVersions
Permite que o proxy funcione com versões de banco de dados não suportadas.
Padrão: 0
Valores: 0 - não permitir; 1 - permitir
CacheSize
Defina o tamanho do cache de configuração, em bytes. O tamanho da memória compartilhada para armazenar dados de host e item.
Padrão: 32M
Intervalo: 128K-64G
ConfigFrequency
Este parâmetro está obsoleto (use ProxyConfigFrequency em seu lugar).
Define a frequência de obtenção dos dados de configuração do Zabbix server (em segundos).
Parâmetro do proxy ativo.
Ignorado para proxies passivos (consulte o parâmetro ProxyMode).
Padrão: 3600
Intervalo: 1-604800
DataSenderFrequency
Define a frequência de envio dos dados coletados do proxy para o server do Zabbix.
Observe que um proxy ativo ainda consultará o server do Zabbix a cada segundo para tarefas de comando remoto.
Parâmetro do proxy ativo.
Ignorado para proxies passivos (consulte o parâmetro ProxyMode).
Padrão: 1
Intervalo: 1-3600
DBHost
Especifique o host do banco de dados (ou o diretório do socket).
Para MySQL:
localhostou uma string vazia usa o socket UNIX de domínio padrão.
Para PostgreSQL:
localhosté resolvido via DNS (normalmente para 127.0.0.1).- Uma string vazia usa o socket UNIX de domínio padrão.
- Um caminho (por exemplo,
/var/run/pgbouncer) faz com que o socket UNIX nesse caminho seja usado. - Uma lista separada por vírgulas pode conter vários valores
host:port. Cada host é tentado em ordem até que uma conexão de leitura e gravação seja estabelecida. Exemplo:DBHost=localhost:5431,127.0.0.1:20051,zabbix.domain,[::1]:30051,[12fc::1]
Padrão: localhost
DBName
Especifique o nome do banco de dados ou o caminho para o arquivo de banco de dados do SQLite3 (a arquitetura multiprocessos do Zabbix não permite usar banco de dados em memória, por exemplo, :memory:, file::memory:?cache=shared ou file:memdb1?mode=memory&cache=shared).
Aviso: Não tente usar o mesmo banco de dados que o server do Zabbix está usando.
Obrigatório: Sim
DBPassword
Especifique a senha do banco de dados. Comente esta linha se nenhuma senha for usada. Ignorado para SQLite.
DBPort
Especifique a porta do host do banco de dados do Zabbix (veja DBHost). Ignorado para SQLite.
DBSocket e DBPort são mutuamente exclusivos na configuração do proxy. Especifique apenas um, ou deixe ambos indefinidos.
Padrão para MySQL: 3306
Padrão para PostgreSQL: 5432
Intervalo: 1024-65535
DBSchema
Especifique o nome do esquema do banco de dados. Usado para PostgreSQL.
DBSocket
Especifique o caminho para o arquivo de socket do MySQL.
DBSocket e DBPort são mutuamente exclusivos na configuração do proxy. Especifique apenas um, ou deixe ambos indefinidos.
DBUser
Especifique o usuário do banco de dados. Ignorado para SQLite.
DBTLSConnect
Especifique um valor para impor uma conexão TLS com o banco de dados:
required - conectar usando TLS
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 especificada por DBHost corresponde ao seu certificado
No MySQL, a partir da versão 5.7.11, e no PostgreSQL, os seguintes valores são suportados: "required", "verify", "verify_full".
No MariaDB, a partir da versão 10.2.6, os valores "required" e "verify_full" são suportados.
Por padrão, nenhuma opção é definida e o comportamento depende da configuração do banco de dados.
DBTLSCAFile
Especifique o caminho completo do arquivo que contém os certificados da CA de nível superior para a verificação de certificados do banco de dados.
Obrigatório: não (sim, se DBTLSConnect estiver definido como verify_ca ou verify_full)
DBTLSCertFile
Especifique o caminho completo do arquivo que contém o certificado do proxy Zabbix para autenticação no banco de dados.
DBTLSKeyFile
Especifique o caminho completo do arquivo que contém a chave privada para autenticação no banco de dados.
DBTLSCipher
Especifique a lista de cifras de criptografia que o Zabbix proxy permite para os protocolos TLS até o TLS v1.2. Suportado apenas para MySQL.
DBTLSCipher13
Especifique a lista de suites de cifras de criptografia que o Zabbix proxy permite para o protocolo TLS v1.3. Suportado apenas para MySQL, a partir da versão 8.0.16.
DebugLevel
Defina o nível de depuração:
0 - informações básicas sobre a inicialização e a finalização dos processos do Zabbix
1 - informações críticas;
2 - informações de erro;
3 - avisos;
4 - para depuração (gera muitas informações);
5 - depuração estendida (gera ainda mais informações).
Padrão: 3
Intervalo: 0-5
EnableRemoteCommands
Permite comandos remotos do Zabbix server.
Padrão: 0
Valores: 0 - não permitir; 1 - permitir
ExternalScripts
Especifique o local do script externo (depende da variável de instalação em tempo de compilação datadir).
Padrão: /usr/local/share/zabbix/externalscripts
Fping6Location
Especifique o local do fping6. Certifique-se de que o binário fping6 tenha propriedade de root e o sinalizador SUID definido. Deixe em branco ("Fping6Location=") se o utilitário fping for capaz de processar endereços IPv6.
Padrão: /usr/sbin/fping6
FpingLocation
Especifique o local do fping. Certifique-se de que o binário do fping tenha propriedade de root e o sinalizador SUID definido.
Padrão: /usr/sbin/fping
HistoryCacheSize
Defina o tamanho do cache de histórico, em bytes. O tamanho da memória compartilhada para armazenar dados de histórico.
Padrão: 16M
Intervalo: 128K-16G
HistoryIndexCacheSize
Defina o tamanho do cache de índice do histórico, em bytes. O tamanho da memória compartilhada para indexar os dados de histórico armazenados no cache de histórico. O tamanho do cache de índice precisa de aproximadamente 100 bytes para armazenar em cache um item.
Padrão: 4M
Intervalo: 128K-16G
Nome do host
Especifique um nome de proxy exclusivo, com diferenciação entre maiúsculas e minúsculas.
Certifique-se de que o nome do proxy seja conhecido pelo server.
Caracteres permitidos: alfanuméricos, '.', ' ', '_' e '-'.
Comprimento máximo: 128
Padrão: Definido por HostnameItem
HostnameItem
Especifique um item para definir o Hostname (se não estiver definido).
Este item será executado no proxy da mesma forma que em um agent.
Ignorado se Hostname estiver definido.
Não oferece suporte a parâmetros de usuário, contadores de desempenho ou aliases; oferece suporte a system.run[].
Padrão: system.hostname
HousekeepingFrequency
Defina a frequência do procedimento de housekeeping (em horas).
Housekeeping é a remoção de informações desatualizadas do banco de dados.
Nota: Para reduzir a carga na inicialização do proxy, o housekeeping é adiado por 30 minutos após a inicialização do proxy.
Assim, se HousekeepingFrequency for 1, o primeiro procedimento de housekeeping após a inicialização do proxy será executado após 30 minutos e, depois disso, se repetirá a cada hora.
É possível desativar o housekeeping automático definindo HousekeepingFrequency como 0.
Nesse caso, o procedimento de housekeeping só pode ser iniciado pela opção de controle em tempo de execução housekeeper_execute.
Consulte também as opções de controle em tempo de execução e os detalhes sobre o procedimento de housekeeping.
Padrão: 1
Intervalo: 0-24
Incluir
Especifique um diretório ou arquivos individuais a serem incluídos no arquivo de configuração.
Para incluir apenas os arquivos relevantes no diretório especificado, o caractere curinga asterisco é suportado para correspondência de padrões.
Consulte notas especiais sobre limitações.
Exemplo:
Include=/absolute/path/to/config/files/*.conf
JavaGateway
Especifique o endereço IP ou o nome do host do Zabbix Java gateway. Necessário apenas se os Java pollers estiverem iniciados.
JavaGatewayPort
Especifique a porta do Zabbix Java gateway.
Padrão: 10052
Intervalo: 1024-32767
ListenBacklog
Define o número máximo de conexões pendentes na fila TCP.
O valor padrão é uma constante codificada, que depende do sistema.
O valor máximo suportado também depende do sistema; valores muito altos podem ser truncados silenciosamente para o 'maximum specified by the implementation'.
Padrão: SOMAXCONN
Intervalo: 0 - INT_MAX
ListenIP
Especifique o endereço IP de escuta do trapper. Uma lista delimitada por vírgulas.
O trapper escutará em todas as interfaces de rede se este parâmetro não for especificado.
Padrão: 0.0.0.0
ListenPort
Especifique a porta de escuta do trapper.
Padrão: 10051
Intervalo: 1024-32767
LoadModule
Especifique o módulo a ser carregado na inicialização do proxy.
Os módulos são usados para estender a funcionalidade do proxy.
O módulo deve estar localizado no diretório especificado por LoadModulePath ou o caminho deve preceder o nome do módulo.
Se o caminho precedente for absoluto (começa com '/') então LoadModulePath é ignorado.
Formatos:
LoadModule=<module.so>
LoadModule=<path/module.so>
LoadModule=</abs_path/module.so>
É permitido incluir vários parâmetros LoadModule.
LoadModulePath
O caminho completo para o local dos módulos do proxy. O padrão depende das opções de compilação.
LogFile
Especifique o arquivo de log do proxy.
Obrigatório: Sim, se LogType estiver definido como file; caso contrário, não
LogFileSize
Defina o tamanho máximo do arquivo de log (em MB).
0 - desativa a rotação automática do log.
Nota: Se o limite de tamanho do arquivo de log for atingido e a rotação do arquivo falhar, por qualquer motivo, o arquivo de log existente será truncado e iniciado novamente.
Padrão: 1
Intervalo: 0-1024
LogRemoteCommands
Ative o registro dos comandos de shell executados como avisos.
Padrão: 0
Valores: 0 - desativado, 1 - ativado
LogSlowQueries
Define a duração máxima que uma consulta ao banco de dados pode levar antes de ser registrada no log (em milissegundos).
0 - não registrar consultas lentas.
Esta opção passa a ser habilitada a partir de DebugLevel=3.
Padrão: 0
Intervalo: 0-3600000
LogType
Especifique o tipo de saída do log:
file - grava o log no arquivo especificado pelo parâmetro LogFile;
system - grava o log no syslog;
console - grava o log na saída padrão.
Padrão: file
MaxConcurrentChecksPerPoller
Define o número máximo de verificações assíncronas que podem ser executadas ao mesmo tempo por cada HTTP agent poller, agent poller ou SNMP poller. Veja StartHTTPAgentPollers, StartAgentPollers e StartSNMPPollers.
Padrão: 1000
Intervalo: 1-1000
PidFile
Especifique o arquivo PID.
Padrão: /tmp/zabbix_proxy.pid
ProxyBufferMode
Especifique o mecanismo de armazenamento para os dados de history, discovery e autoregistration:
disk - os dados são armazenados no banco de dados e enviados a partir do banco de dados;
memory - os dados são armazenados na memória e enviados a partir da memória.
Se o buffer ficar sem memória, os dados antigos serão descartados.
Ao desligar, o buffer é descartado.
hybrid - o buffer do proxy normalmente funciona como no modo de memória até ficar sem memória ou até que o registro mais antigo exceda a idade configurada.
Se isso acontecer, o buffer é descarregado para o banco de dados e passa a funcionar como no modo de disco até que todos os dados tenham sido enviados e então volta a funcionar com memória novamente.
Ao desligar, o buffer de memória é descarregado para o banco de dados.
Veja também: Proxy memory buffer.
Padrão: disk
Valores: disk; memory; hybrid
ProxyConfigFrequency
Define a frequência de recuperação dos dados de configuração do Zabbix server em segundos.
Parâmetro do proxy ativo.
Ignorado para proxies passivos (veja o parâmetro ProxyMode).
Padrão: 10
Intervalo: 1-604800
ProxyLocalBuffer
Defina a duração de retenção dos dados localmente (em horas), mesmo que os dados já tenham sido sincronizados com o server..
Este parâmetro pode ser usado se os dados locais forem utilizados por aplicativos de terceiros.
Padrão: 0
Intervalo: 0-720
ProxyMemoryBufferAge
Define a idade máxima dos dados no buffer de memória do proxy, em segundos.
Quando habilitado (diferente de zero) e os registros no buffer de memória do proxy estiverem mais antigos, isso força o buffer do proxy a alternar para o modo de banco de dados até que todos os registros sejam enviados para o server.
Este parâmetro deve ser menor ou igual ao parâmetro ProxyOfflineBuffer.
Padrão: 0
Intervalo: 0;600-864000
ProxyMemoryBufferSize
Define o tamanho do cache de memória compartilhada para os dados coletados de history, discovery e auto registration (em bytes). Se habilitado (diferente de zero), o proxy manterá os dados de history, discovery e autoregistration na memória, a menos que o cache esteja cheio ou que os registros armazenados sejam mais antigos do que o ProxyMemoryBufferAge definido. Este parâmetro não pode ser usado junto com o parâmetro ProxyLocalBuffer.
Padrão: 0
Intervalo: 0;128K-2G
ProxyMode
Define o modo de operação do proxy.
0 - proxy no modo ativo
1 - proxy no modo passivo
Nota que os dados de configuração sensíveis do proxy podem ficar disponíveis para partes que tenham acesso à porta trapper do Zabbix server ao usar um proxy ativo.
Isso é possível porque qualquer pessoa pode se passar por um proxy ativo e solicitar dados de configuração; a autenticação não é realizada.
Padrão: 0
Intervalo: 0-1
ProxyOfflineBuffer
Defina a duração de retenção dos dados (em horas) em caso de falta de conectividade com o Zabbix server.
Dados mais antigos serão perdidos.
Padrão: 1
Intervalo: 1-720
Server
Se ProxyMode estiver definido como active: especifique o endereço IP ou o nome DNS do Zabbix server (address:port) ou cluster (address:port;address2:port) para obter os dados de configuração e enviar dados.
Se a porta não for especificada, a porta padrão será usada.
Os nós do cluster devem ser separados por ponto e vírgula.
Se ProxyMode estiver definido como passive: especifique endereços IP, opcionalmente em notação CIDR, ou nomes DNS do Zabbix server. Uma lista separada por vírgulas.
As conexões de entrada serão aceitas somente a partir dos endereços listados aqui.
Se o suporte a IPv6 estiver habilitado, então '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' serão tratados igualmente.
'::/0' permitirá qualquer endereço IPv4 ou IPv6.
'0.0.0.0/0' pode ser usado para permitir qualquer endereço IPv4.
Exemplo:
Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
Obrigatório: sim
SNMPTrapperFile
Especifique o arquivo temporário usado para passar dados do daemon de traps SNMP para o proxy.
Deve ser o mesmo definido em zabbix_trap_receiver.pl ou no arquivo de configuração do SNMPTT.
Padrão: /tmp/zabbix_traps.tmp
SocketDir
Especifique o diretório para armazenar os sockets IPC usados pelos serviços internos do Zabbix.
Padrão: /tmp
SourceIP
Especifique o endereço IP de origem para:
- conexões de saída para o Zabbix server
- conexões sem agent (VMware, SSH, JMX, SNMP, Telnet e verificações simples)
- conexões do HTTP agent
- solicitações HTTP JavaScript do item script
- solicitações HTTP JavaScript de pré-processamento
- conexões com o Vault
SSHKeyLocation
Especifique o local das chaves pública e privada para verificações e ações SSH.
SSLCertLocation
Especifique o local dos arquivos de certificado SSL do cliente para autenticação do cliente.
Este parâmetro é usado apenas no monitoramento web.
SSLKeyLocation
Especifique o local dos arquivos de chave privada SSL para autenticação do cliente.
Este parâmetro é usado apenas no monitoramento web.
SSLCALocation
Especifique o local dos arquivos da autoridade certificadora (CA) para a verificação do certificado do servidor SSL.
Observe que o valor deste parâmetro será definido como a opção CURLOPT_CAPATH do libcurl.
Para versões do libcurl anteriores à 7.42.0, isso só tem efeito se o libcurl tiver sido compilado para usar OpenSSL.
Para mais informações, consulte a página da web do cURL.
Este parâmetro é usado no monitoramento da web e na autenticação SMTP.
StartAgentPollers
Define o número de instâncias pré-forkadas de pollers do Zabbix agent.
Veja MaxConcurrentChecksPerPoller.
Padrão: 1
Intervalo: 0-1000
StartBrowserPollers
Define o número de instâncias pré-forked de browser item pollers.
Padrão: 1
Intervalo: 0-1000
StartDBSyncers
Define o número de instâncias pré-forked de history syncers.
Nota: Tenha cuidado ao alterar este valor; aumentá-lo pode causar mais prejuízo do que benefício.
Padrão: 4
Intervalo: 1-100
StartDiscoverers
Define o número de instâncias pré-forked de discovery workers.
Padrão: 5
Intervalo: 0-1000
StartHTTPAgentPollers
Define o número de instâncias pré-forked de HTTP agent pollers.
Veja MaxConcurrentChecksPerPoller.
Padrão: 1
Intervalo: 0-1000
StartHTTPPollers
Define o número de instâncias pré-forked de HTTP pollers.
Padrão: 1
Intervalo: 0-1000
StartIPMIPollers
Define o número de instâncias pré-forked de IPMI pollers.
Padrão: 0
Intervalo: 0-1000
StartJavaPollers
Define o número de instâncias pré-forked de Java pollers.
Padrão: 0
Intervalo: 0-1000
StartODBCPollers
Define o número de instâncias pré-forked de ODBC pollers.
Padrão: 1
Intervalo: 0-1000
StartPingers
Define o número de instâncias pré-forked de ICMP pingers.
Padrão: 1
Intervalo: 0-1000
StartPollersUnreachable
Define o número de instâncias pré-forked de pollers para hosts inacessíveis (incluindo IPMI e Java). Pelo menos um poller para hosts inacessíveis deve estar em execução se pollers regulares, IPMI ou Java forem iniciados.
Padrão: 1
Intervalo: 0-1000
StartPollers
Define o número de instâncias pré-fork de pollers.
Padrão: 5
Intervalo: 0-1000
StartPreprocessors
Defina o número de instâncias pré-iniciadas de threads de worker de pré-processamento para não ser menor que a quantidade de núcleos de CPU disponíveis.
Mais workers devem ser definidos se o pré-processamento não estiver limitado pela CPU e tiver muitas requisições de rede.
Padrão: 16
Intervalo: 1-1000
StartSNMPPollers
Define o número de instâncias pré-forked de SNMP pollers.
Veja MaxConcurrentChecksPerPoller.
Padrão: 1
Intervalo: 0-1000
StartSNMPTrapper
Defina como "1" para iniciar um processo SNMP trapper.
Padrão: 0
Intervalo: 0-1
StartTrappers
Define o número de instâncias pré-forkadas de trappers.
Trappers aceitam conexões de entrada do Zabbix sender e de agents ativos.
Padrão: 5
Intervalo: 0-1000
StartVMwareCollectors
Define o número de instâncias pré-forked de vmware collector.
Padrão: 0
Intervalo: 0-250
StatsAllowedIP
Especifique endereços IP (opcionalmente em notação CIDR) ou nomes DNS de instâncias externas do Zabbix que têm permissão para solicitar estatísticas. Uma lista separada por vírgulas.
Se este parâmetro não estiver definido, nenhuma solicitação de estatísticas será aceita.
Se o suporte a IPv6 estiver habilitado, então '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' serão tratados igualmente e '::/0' permitirá qualquer endereço IPv4 ou IPv6.
'0.0.0.0/0' pode ser usado para permitir qualquer endereço IPv4.
Exemplo:
StatsAllowedIP=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
Timeout
Especifique quanto tempo aguardar (em segundos) para estabelecer a conexão e trocar dados com o server Zabbix, agent, web service e verificações SNMP legadas (número OID único ou string).
Este parâmetro define a duração de várias operações de comunicação:
- Execução de comando remoto no agent Zabbix
- Execução de comando SSH / Telnet
- Reagendamento de items quando a interface IPMI se torna indisponível
- Envio de resposta ao server Zabbix ao falhar a troca de dados devido a problemas de permissões ou criptografia
- Prazo para sockets assíncronos de IPC e opções de controle em tempo de execução
- Solicitações DNS do poller assíncrono
- Resposta para heartbeat de verificação ativa
- Recuperação de dados (valores) do agent Zabbix a partir de agents ativos
- Recuperação de dados do Zabbix sender
- Envio da lista de verificações ativas para o agent Zabbix
Este timeout não será usado para as verificações que tenham configurações de timeout flexível definidas no frontend (em nível global, de proxy ou por item).
Por exemplo, os items SNMP walk[OID] e get[OID] usam o timeout configurado no frontend; as verificações SNMP legadas ainda usam o valor de timeout do server.
Padrão: 3
Intervalo: 1-30
TLSAccept
Especifique o nível de criptografia exigido para conexões de entrada do Zabbix server.
Usado para um proxy passivo, ignorado em um proxy ativo.
Vários valores podem ser especificados, separados por vírgula:
unencrypted - aceita conexões sem criptografia (padrão)
psk - aceita conexões com TLS e uma chave pré-compartilhada (PSK)
cert - aceita conexões com TLS e um certificado
Obrigatório: sim para proxy passivo, se os parâmetros de certificado TLS ou PSK estiverem definidos (mesmo para conexão unencrypted); caso contrário, não
TLSCAFile
Especifique o caminho completo do arquivo que contém os certificados da(s) CA(s) de nível superior para verificação do certificado do par, usado para comunicações criptografadas entre os componentes do Zabbix.
TLSCertFile
Especifique o caminho completo do arquivo que contém o certificado do proxy ou a cadeia de certificados, usado para comunicações criptografadas entre os componentes do Zabbix.
TLSCipherAll
Especifique a string de prioridade do GnuTLS ou a string de cifra do OpenSSL (TLS 1.2). Substitua os critérios padrão de seleção do conjunto de cifras para criptografia baseada em certificado e PSK.
Exemplo:
TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCipherAll13
Especifique a string de cifra para OpenSSL 1.1.1 ou mais recente em TLS 1.3. Substitua os critérios padrão de seleção da ciphersuite para criptografia baseada em certificado e em PSK.
Exemplo para GnuTLS:
NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509
Exemplo para OpenSSL:
EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128
TLSCipherCert
Especifique a string de prioridade do GnuTLS ou a string de cifra do OpenSSL (TLS 1.2). Substitua os critérios padrão de seleção do conjunto de cifras para criptografia baseada em certificado.
Exemplo para GnuTLS:
NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509
Exemplo para OpenSSL:
EECDH+aRSA+AES128:RSA+aRSA+AES128
TLSCipherCert13
Especifique a string de cifra para OpenSSL 1.1.1 ou mais recente no TLS 1.3. Substitua os critérios padrão de seleção do conjunto de cifras para criptografia baseada em certificado.
TLSCipherPSK
Especifique a string de prioridade do GnuTLS ou a string de cifra do OpenSSL (TLS 1.2). Substitua os critérios padrão de seleção do conjunto de cifras para criptografia baseada em PSK.
Exemplo para GnuTLS:
NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL
Exemplo para OpenSSL:
kECDHEPSK+AES128:kPSK+AES128
TLSCipherPSK13
Especifique a string de cifra para OpenSSL 1.1.1 ou mais recente no TLS 1.3. Substitua os critérios padrão de seleção do conjunto de cifras para criptografia baseada em PSK.
Exemplo:
TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSConnect
Especifique o nível de criptografia exigido para conexões do proxy com o Zabbix server.
Usado para um proxy ativo, ignorado em um proxy passivo.
Apenas um valor pode ser especificado:
unencrypted - conectar sem criptografia (padrão)
psk - conectar usando TLS e uma chave pré-compartilhada (PSK)
cert - conectar usando TLS e um certificado
Obrigatório: sim para proxy ativo, se os parâmetros de certificado TLS ou PSK estiverem definidos (mesmo para conexão unencrypted); caso contrário, não
TLSCRLFile
Especifique o caminho completo do arquivo que contém os certificados revogados. Este parâmetro é usado para comunicações criptografadas entre os componentes do Zabbix.
TLSKeyFile
Especifique o caminho completo do arquivo que contém a chave privada do proxy, usada para comunicações criptografadas entre os componentes do Zabbix.
TLSListen
Exigir conexões somente TLS no socket do trapper.
Valores suportados:
- required - aceitar apenas conexões TLS
TLSPSKFile
Especifique o caminho completo do arquivo que contém a chave pré-compartilhada do proxy, usada para comunicações criptografadas com o Zabbix server.
TLSPSKIdentity
Especifique a string de identidade da chave pré-compartilhada, usada para comunicações criptografadas com o Zabbix server.
TLSServerCertIssuer
Especifique o emissor do certificado do server permitido.
TLSServerCertSubject
Especifique o subject do certificado do server permitido.
TmpDir
Especifique o diretório temporário.
Padrão: /tmp
TrapperTimeout
Especifique o tempo limite em segundos para:
- recuperação de dados de configuração do server Zabbix;
- execução de script global ou execução de comando remoto.
Padrão: 300
Intervalo: 1-300
UnavailableDelay
Define a frequência de verificação da disponibilidade do host durante o período de indisponibilidade, em segundos.
Padrão: 60
Intervalo: 1-3600
UnreachableDelay
Define a frequência de verificação da disponibilidade do host durante o período de inacessibilidade em segundos.
Padrão: 15
Intervalo: 1-3600
UnreachablePeriod
Define após quantos segundos de inacessibilidade tratar o host como indisponível.
Padrão: 45
Intervalo: 1-3600
Usuário
Reduz os privilégios para um usuário específico e existente no sistema.
Só tem efeito se for executado como root e AllowRoot estiver desabilitado.
Padrão: zabbix
Vault
Especifique o provedor do vault:
HashiCorp - HashiCorp KV Secrets Engine versão 2
CyberArk - CyberArk Central Credential Provider
Deve corresponder ao provedor do vault definido no frontend.
Padrão: HashiCorp
VaultDBPath
Especifique o local para recuperar as credenciais do banco de dados por chaves. Trata-se de um caminho ou consulta do Vault, dependendo do Vault.
As chaves usadas pelo HashiCorp são 'password' e 'username'.
Exemplo de caminho com VaultPrefix=/v1/secret/data/zabbix/:
database
Exemplo de caminho sem VaultPrefix:
secret/zabbix/database
As chaves usadas pelo CyberArk são 'Content' e 'UserName'.
Exemplo:
AppID=zabbix_server&Query=Safe=passwordSafe;Object=zabbix_proxy_database
Esta opção só pode ser usada se DBUser e DBPassword não estiverem especificados.
VaultPrefix
Especifique um prefixo personalizado para o caminho ou consulta do vault, dependendo do Vault.
Os padrões mais adequados serão usados se não forem especificados.
Observe que 'data' é automaticamente anexado após o ponto de montagem para HashiCorp se VaultPrefix não for especificado.
Observe que 'data' é automaticamente anexado após o ponto de montagem para HashiCorp se VaultPrefix não for especificado.
Exemplo de prefixo para Hashicorp:
v1/secret/data/zabbix/
Exemplo de prefixo para Cyberark:
/AIMWebService/api/Accounts?
VaultTLSCertFile
Especifique o nome do arquivo de certificado SSL usado para autenticação do cliente.
O arquivo de certificado deve estar no formato PEM1.
Se o arquivo de certificado também contiver a chave privada, deixe o campo do arquivo de chave SSL em branco.
O diretório que contém este arquivo é especificado pelo parâmetro de configuração SSLCertLocation.
Esta opção pode ser omitida, mas é recomendada para o vault CyberArkCCP.
VaultTLSKeyFile
Especifique o nome do arquivo de chave privada SSL usado para autenticação do cliente.
O arquivo de chave privada deve estar no formato PEM1.
O diretório que contém esse arquivo é especificado pelo parâmetro de configuração SSLKeyLocation.
Esta opção pode ser omitida, mas é recomendada para o vault CyberArkCCP.
VaultToken
Especifique o token de autenticação do HashiCorp Vault que deve ter sido gerado exclusivamente para o proxy do Zabbix com permissão somente leitura para o caminho especificado no parâmetro de configuração opcional VaultDBPath.
É um erro se VaultToken e a variável de ambiente VAULT_TOKEN estiverem definidos ao mesmo tempo.
Obrigatório: Sim, se Vault estiver definido como HashiCorp; caso contrário, não
VaultURL
Especifique a URL do server do vault. O diretório de certificados CA do sistema será usado se SSLCALocation não for especificado.
Padrão: https://127.0.0.1:8200
VMwareCacheSize
Define o tamanho da memória compartilhada para armazenar dados do VMware.
Uma verificação interna do Zabbix zabbix\[vmware,buffer,...\] pode ser usada para monitorar o uso do cache do VMware (consulte Verificações internas).
Observe que a memória compartilhada não é alocada se não houver instâncias do coletor do VMware configuradas para iniciar.
Padrão: 8M
Intervalo: 256K-2G
VMwareFrequency
Defina a frequência de coleta de dados de um único serviço VMware (em segundos).
Essa frequência deve ser definida como o menor intervalo de atualização de qualquer item de monitoramento VMware.
Padrão: 60
Intervalo: 10-86400
VMwarePerfFrequency
Defina a frequência de recuperação das estatísticas dos contadores de desempenho de um único serviço VMware (em segundos).
Essa frequência deve ser definida como o menor intervalo de atualização de qualquer item de monitoramento VMware que use contadores de desempenho VMware.
Padrão: 60
Intervalo: 10-86400
VMwareTimeout
Define o número máximo de segundos que um vmware collector aguardará por uma resposta do serviço VMware (vCenter ou hipervisor ESX).
Padrão: 10
Intervalo: 1-300
WebDriverURL
Especifique a URL da interface do WebDriver.
Exemplo (usado com o servidor standalone do Selenium WebDriver):
WebDriverURL=http://localhost:4444