Parâmetros de configuração: Zabbix proxy

Visão geral

Os parâmetros de configuração permitem personalizar o comportamento do Zabbix proxy.

Especifique os valores dos parâmetros no arquivo de configuração do proxy do Zabbix (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
Parâmetro Descrição
AllowRoot Permitir que o proxy seja executado como root.
AllowUnsupportedDBVersions Permitir que o proxy funcione com versões de banco de dados não suportadas.
CacheSize Definir o tamanho do cache de configuração.
ConfigFrequency Este parâmetro está obsoleto (use ProxyConfigFrequency).
Definir a frequência de recuperação dos dados de configuração do Zabbix server.
DataSenderFrequency Definir a frequência de envio dos dados coletados ao Zabbix server.
DBHost Especificar o host do banco de dados (ou o diretório do socket).
DBName Especificar o nome do banco de dados ou o caminho para o arquivo de banco de dados do SQLite3.
DBPassword Especificar a senha do banco de dados.
DBPort Especificar a porta do host do banco de dados do Zabbix.
DBSchema Especificar o nome do esquema do banco de dados. Usado para PostgreSQL.
DBSocket Especificar o caminho para o arquivo de socket do MySQL.
DBUser Especificar o usuário do banco de dados.
DBTLSConnect Especificar um valor para exigir uma conexão TLS com o banco de dados.
DBTLSCAFile Especificar o nome de 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 Especificar o nome de caminho completo do arquivo que contém o certificado do Zabbix proxy para autenticação no banco de dados.
DBTLSKeyFile Especificar o nome de caminho completo do arquivo que contém a chave privada para autenticação no banco de dados.
DBTLSCipher Especificar a lista de cifras de criptografia permitidas pelo Zabbix proxy para protocolos TLS até a versão TLS v1.2. Suportado somente pelo MySQL.
DBTLSCipher13 Especificar a lista de conjuntos de cifras de criptografia permitidos pelo Zabbix proxy para o protocolo TLS v1.3. Suportado somente pelo MySQL, a partir da versão 8.0.16.
DebugLevel Definir o nível de depuração.
EnableRemoteCommands Permitir comandos remotos do Zabbix server.
ExternalScripts Especificar o local dos scripts externos.
Fping6Location Especificar o local do fping6.
FpingLocation Especificar o local do fping.
HistoryCacheSize Definir o tamanho do cache de histórico.
HistoryIndexCacheSize Definir o tamanho do cache de índices de histórico.
Hostname Especificar o nome do proxy.
HostnameItem Especificar o item usado para definir Hostname (se não estiver definido).
HousekeepingFrequency Definir a frequência do procedimento de housekeeping (em horas).
Include Especificar um diretório ou arquivos individuais a serem incluídos no arquivo de configuração.
JavaGateway Especificar o endereço IP (ou nome do host) do Java gateway do Zabbix.
JavaGatewayPort Especificar a porta do Java gateway do Zabbix.
ListenBacklog Definir o número máximo de conexões pendentes na fila TCP.
ListenIP Especificar o endereço IP de escuta do trapper.
ListenPort Especificar a porta de escuta do trapper.
LoadModule Especificar o módulo a ser carregado na inicialização do proxy.
LoadModulePath Especificar o caminho completo para o local dos módulos do proxy.
LogFile Especificar o arquivo de log do proxy.
LogFileSize Definir o tamanho máximo do arquivo de log.
LogRemoteCommands Ativar o registro de comandos shell executados como avisos.
LogSlowQueries Definir a duração máxima que uma consulta ao banco de dados pode levar antes de ser registrada (em milissegundos).
LogType Especificar o tipo de saída do log.
MaxConcurrentChecksPerPoller Definir o número máximo de verificações assíncronas que podem ser executadas simultaneamente por cada poller de HTTP agent, poller de agent ou poller SNMP.
PidFile Especificar o arquivo PID.
ProxyBufferMode Especificar o mecanismo de armazenamento dos dados de histórico, descoberta e registro automático (disco/memória/híbrido).
ProxyConfigFrequency Definir a frequência de recuperação dos dados de configuração do Zabbix server, em segundos.
ProxyLocalBuffer Definir por quanto tempo manter os dados localmente (em horas), mesmo que eles já tenham sido sincronizados com o server.
ProxyMemoryBufferAge Definir a idade máxima dos dados no buffer de memória do proxy, em segundos.
ProxyMemoryBufferSize Definir o tamanho do cache de memória compartilhada para os dados coletados de histórico, descoberta e registro automático.
ProxyMode Definir o modo de operação do proxy (ativo/passivo).
ProxyOfflineBuffer Definir por quanto tempo manter os dados (em horas) em caso de ausência de conectividade com o Zabbix server.
Server Se ProxyMode estiver definido como active: especificar o endereço IP ou o nome DNS do Zabbix server (address:port) ou do cluster (address:port;address2:port) do qual obter os dados de configuração e para o qual enviar os dados.
Se ProxyMode estiver definido como passive: especificar os endereços IP ou nomes DNS do Zabbix server.
SNMPTrapperFile Especificar o arquivo temporário usado para passar dados do daemon de traps SNMP para o proxy.
SocketDir Especificar o diretório para armazenar os sockets IPC usados pelos serviços internos do Zabbix.
SourceIP Especificar o endereço IP de origem.
SSHKeyLocation Especificar o local das chaves públicas e privadas para verificações e ações SSH.
SSLCertLocation Especificar o local dos arquivos de certificado do cliente SSL para autenticação do cliente.
SSLKeyLocation Especificar o local dos arquivos de chave privada SSL para autenticação do cliente.
SSLCALocation Especificar o local dos arquivos da autoridade certificadora (CA) para verificação do certificado do server SSL.
StartAgentPollers Definir o número de instâncias pré-fork de pollers assíncronos de Zabbix agent.
StartBrowserPollers Definir o número de instâncias pré-fork de pollers de itens de navegador.
StartDBSyncers Definir o número de instâncias pré-fork de sincronizadores de histórico.
StartDiscoverers Definir o número de instâncias pré-fork de workers de descoberta.
StartHTTPAgentPollers Definir o número de instâncias pré-fork de pollers assíncronos de HTTP agent.
StartHTTPPollers Definir o número de instâncias pré-fork de pollers HTTP.
StartIPMIPollers Definir o número de instâncias pré-fork de pollers IPMI.
StartJavaPollers Definir o número de instâncias pré-fork de pollers Java.
StartODBCPollers Definir o número de instâncias pré-fork de pollers ODBC.
StartPingers Definir o número de instâncias pré-fork de pingers ICMP.
StartPollersUnreachable Definir o número de instâncias pré-fork de pollers para hosts inacessíveis (incluindo IPMI e Java).
StartPollers Definir o número de instâncias pré-fork de pollers.
StartPreprocessors Definir o número de instâncias pré-iniciadas de workers de pré-processamento.
StartSNMPPollers Definir o número de instâncias pré-fork de pollers SNMP assíncronos.
StartSNMPTrapper Definir como "1" para iniciar um processo de trapper SNMP.
StartTrappers Definir o número de instâncias pré-fork de trappers.
StartVMwareCollectors Definir o número de instâncias pré-fork de coletores VMware.
StatsAllowedIP Especificar os endereços IP ou nomes DNS de instâncias externas do Zabbix autorizadas a solicitar estatísticas.
Timeout Especificar por quanto tempo aguardar (em segundos) o estabelecimento da conexão e a troca de dados com o Zabbix proxy, agent, serviço web e para verificações SNMP (exceto itens SNMP walk[OID] e get[OID]).
TLSAccept Especificar o nível de criptografia exigido para conexões de entrada do Zabbix server.
TLSCAFile Especificar o nome de caminho completo do arquivo que contém os certificados da CA de nível superior para verificação do certificado do peer, usado nas comunicações criptografadas entre componentes do Zabbix.
TLSCertFile Especificar o nome de caminho completo do arquivo que contém o certificado do server ou a cadeia de certificados, usado nas comunicações criptografadas entre componentes do Zabbix.
TLSCipherAll Especificar a string de prioridade do GnuTLS ou a string de cifras do OpenSSL (TLS 1.2). Substituir os critérios padrão de seleção do conjunto de cifras para criptografia baseada em certificado e PSK.
TLSCipherAll13 Especificar a string de cifras para OpenSSL 1.1.1 ou mais recente no TLS 1.3. Substituir os critérios padrão de seleção do conjunto de cifras para criptografia baseada em certificado e PSK.
TLSCipherCert Especificar a string de prioridade do GnuTLS ou a string de cifras do OpenSSL (TLS 1.2). Substituir os critérios padrão de seleção do conjunto de cifras para criptografia baseada em certificado.
TLSCipherCert13 Especificar a string de cifras para OpenSSL 1.1.1 ou mais recente no TLS 1.3. Substituir os critérios padrão de seleção do conjunto de cifras para criptografia baseada em certificado.
TLSCipherPSK Especificar a string de prioridade do GnuTLS ou a string de cifras do OpenSSL (TLS 1.2). Substituir os critérios padrão de seleção do conjunto de cifras para criptografia baseada em PSK.
TLSCipherPSK13 Especificar a string de cifras para OpenSSL 1.1.1 ou mais recente no TLS 1.3. Substituir os critérios padrão de seleção do conjunto de cifras para criptografia baseada em PSK.
TLSConnect Especificar o nível de criptografia exigido para conexões com o Zabbix server.
TLSCRLFile Especificar o nome de caminho completo do arquivo que contém os certificados revogados. Este parâmetro é usado nas comunicações criptografadas entre componentes do Zabbix.
TLSKeyFile Especificar o nome de caminho completo do arquivo que contém a chave privada do proxy, usada nas comunicações criptografadas entre componentes do Zabbix.
TLSListen Exigir conexões somente TLS no socket do trapper.
TLSPSKFile Especificar o nome de caminho completo do arquivo que contém a chave pré-compartilhada do proxy, usada nas comunicações criptografadas com o Zabbix server.
TLSPSKIdentity Especificar a string de identidade da chave pré-compartilhada, usada nas comunicações criptografadas com o Zabbix server.
TLSServerCertIssuer Especificar o emissor permitido do certificado do server.
TLSServerCertSubject Especificar o assunto permitido do certificado do server.
TmpDir Especificar o diretório temporário.
TrapperTimeout Especificar o tempo limite, em segundos, para:
- recuperação dos dados de configuração do Zabbix server;
- execução de scripts globais ou execução de comandos remotos.
UnavailableDelay Definir a frequência de verificação da disponibilidade do host durante o período de indisponibilidade.
UnreachableDelay Definir a frequência de verificação da disponibilidade do host durante o período de inacessibilidade.
UnreachablePeriod Definir após quantos segundos de inacessibilidade o host deve ser tratado como indisponível.
User Remover privilégios para um usuário específico e existente no sistema.
Vault Especificar o provedor do vault.
VaultAppRoleID Especificar o ID do AppRole do vault HashiCorp.
VaultAppSecretID Especificar o ID secreto do AppRole do vault HashiCorp.
VaultDBPath Especificar o local para recuperar as credenciais do banco de dados por chaves.
VaultPrefix Especificar um prefixo personalizado para o caminho ou a consulta do vault.
VaultTLSCertFile Especificar o nome do arquivo de certificado SSL usado para autenticação do cliente.
VaultTLSKeyFile Especificar o nome do arquivo de chave privada SSL usado para autenticação do cliente.
VaultToken Especificar o token de autenticação do vault HashiCorp.
VaultURL Especificar a URL do server do vault.
VMwareCacheSize Definir o tamanho da memória compartilhada para armazenar dados do VMware.
VMwareFrequency Definir a frequência de coleta de dados de um único serviço VMware, em segundos.
VMwarePerfFrequency Definir a frequência de recuperação das estatísticas dos contadores de desempenho de um único serviço VMware, em segundos.
VMwareTimeout Definir o número máximo de segundos que um vmware collector aguardará por uma resposta do serviço VMware.
WebDriverURL Especificar a URL da interface WebDriver.

Observe que:

  • Os valores padrão refletem os padrões do daemon, não os valores dos arquivos de configuração fornecidos.
  • Os valores aceitam variáveis de ambiente.
  • O Zabbix oferece suporte apenas a arquivos de configuração codificados em UTF-8 sem BOM.
  • Comentários iniciados com # são suportados somente 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) resulta no uso do socket UNIX nesse caminho.
  • 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, não é definido nenhum valor 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 o início e a parada dos processos do Zabbix;
  • 1 - informações críticas;
  • 2 - informações de erro;
  • 3 - avisos;
  • 4 - para depuração (produz muitas informações);
  • 5 - depuração estendida (produz 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 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, será repetido 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 e detalhes de runtime control e do housekeeping procedure.

Padrão: 1
Intervalo: 0-24

Include

Especifique um diretório ou arquivos individuais a serem incluídos no arquivo de configuração.
Durante a instalação do Zabbix, esse parâmetro é definido como /usr/local/etc, a menos que você o altere durante o tempo de compilação.

Regras gerais para o parâmetro Include:

  • O caminho pode ser relativo ao local do arquivo zabbix_proxy.conf.
  • Você pode especificar vários parâmetros Include em um único arquivo de configuração.
  • O Zabbix processa o parâmetro Include assim que o lê, portanto considere colocá-lo no final do arquivo de configuração.

Regras para arquivos incluídos:

  • Cada arquivo deve ser legível.
  • Cada arquivo deve ter sintaxe correta. Caso contrário, o componente não será iniciado.

Regras para incluir diretórios ou padrões de arquivo:

  • Não presuma nenhuma ordem de inclusão (por exemplo, os arquivos não são incluídos em ordem alfabética).
  • Não defina o mesmo parâmetro em mais de um arquivo incluído (por exemplo, para substituir uma configuração geral por uma específica), pois não é possível prever qual valor será usado.
  • Fique atento a cópias de backup que alguns editores de texto criam automaticamente (por exemplo, editar include/my_specific.conf pode criar include/my_specific.conf.BAK), pois ambos os arquivos serão incluídos.

Para incluir apenas os arquivos relevantes de um diretório, use o curinga (*) para correspondência de padrão.

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 anterior 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 ficar 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 de uma vez 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 o registro mais antigo exceder 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 a memória. 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

Defina 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: 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, ele força o buffer do proxy a mudar 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 em conjunto 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) de onde obter os dados de configuração e para onde enviar os 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.
Conexões de entrada serão aceitas somente 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 SSL do server.
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 do cURL.
Este parâmetro é usado no monitoramento 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 sã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 server do Zabbix. 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.
Tem efeito apenas se for executado como root e AllowRoot estiver desabilitado.

Padrão: zabbix

Vault

Especifique o provedor de vault:

  • HashiCorp - HashiCorp KV Secrets Engine versão 2;
  • CyberArk - CyberArk Central Credential Provider
    Deve corresponder ao provedor de vault definido no frontend.

Padrão: HashiCorp

VaultAppRoleID

Especifique o AppRole ID do HashiCorp vault.
Se definido, habilita a autenticação AppRole. Não pode ser usado com VaultToken.
Suportado apenas para HashiCorp vault.

VaultAppSecretID

Especifique o secret ID do AppRole do HashiCorp vault.
Suportado apenas para HashiCorp vault.

VaultDBPath

Especifique o local para recuperar credenciais do banco de dados por meio de 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 acrescentado após o ponto de montagem para HashiCorp se VaultPrefix não for especificado.
Observe que 'data' é automaticamente acrescentado 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 Zabbix proxy 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.
Não pode ser usado com VaultAppRoleID.
Suportado apenas para o HashiCorp Vault.

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 VMware 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 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