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:

  • localhost ou 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