# - \#2 Zabbix Proxy

::: noteclassic
Os valores padrões aqui descritos se referem aos valores
padrões dos daemons, os valores existentes nos arquivos de configuração
fornecidos poderão ser diferentes.
:::

Os parâmetros suportados em um arquivo de configuração do proxy são:

|Parameter|Mandatory|Range|Default|Description|
|---------|---------|-----|-------|-----------|
|AllowRoot|não|<|0|Permite que o proxy seja executado como root. Se o proxy for iniciado pelo 'root' e esta opção estiver desativada, o proxy tentará mudar o permissionamento para o usuário 'zabbix'. Não tem nenhum efeito quando é iniciado por um usuário normal.<br>0 - não permite<br>1 - permite<br>Este parâmetro é suportado desde o Zabbix 2.2.0.|
|CacheSize|não|128K-8G|8M|Tamanho do cache de configuração, em bytes.<br>Tamanho da memória compartilhada, para armazenar dados de hosts e itens.<br>O limite antes do Zabbix 2.2.3 era de 2GB.|
|ConfigFrequency|não|1-604800|3600|Periodicidade de recebimento de dados de configuração do Zabbix Server para o Zabbix Proxy em segundos.<br>Active proxy parameter. Ignored for passive proxies (see ProxyMode parameter).|
|DBHost|não|<|localhost|Host que hospeda o DB.<br>Caso seja um MySQL e esteja definido como 'localhost' ou deixado vazio, será utilizado o socket local. Caso seja um PostgreSQL apenas se estiver vazio será utilizado o socket local.|
|DBName|sim|<|<|Nome do DB.<br>Para o SQLite3 o caminho completo para o arquivo de dados deverá ser informado. Os parâmetros DBUser e DBPassword serão ignorados.<br>Aviso: Não tente utilizar o mesmo banco de dados do Zabbix Server.|
|DBPassword|não|<|<|Senha do DB. Ignorado para o SQLite.<br>Comente esta linha se não existir uma senha.|
|DBSchema|não|<|<|Schema name. Utilizado ppelo IBM DB2 e pelo PostgreSQL.|
|DBSocket|não|<|3306|Caminho para o socket do MySQL.<br>A porta do DB não será utilizada quando utilizar-se do socket. Ignorado para o SQLite.|
|DBUser|<|<|<|Usuário de BD. Ignorado pelo SQLite.|
|DataSenderFrequency|não|1-3600|1|Intervalo de envio de dados para o Zabbix Server (em segundos).<br>Parâmetro válido apenas para proxy ativo, será ignorado se o proxy for passivo (consulte o parâmetro ProxyMode).|
|DebugLevel|não|0-5|3|Define o nível de depuração:<br>0 - informações básicas sobre iniciação e finalização dos processos do<br>1 - informações críticas<br>2 - informações de erro<br>3 - avisos<br>4 - para depuração (produz grande volume de informações)<br>5 - depuração extendida (produz realmente MUITA informação)|
|ExternalScripts|não|<|/usr/local/share/zabbix/externalscripts|Localização dos scripts externos (depende da variável de compilação *datadir*).|
|Fping6Location|não|<|/usr/sbin/fping6|Localização do fping6.<br>Certifique-se que a biblioteca fping6 é do 'root' e possui a flag SUID definida.<br>Deixar vazio ("Fping6Location=") se seu utilitário 'fping' tiver a capacidade de processar endereços IPv6.|
|FpingLocation|não|<|/usr/sbin/fping|Localização do fping.<br>Certifique-se que o binário do 'fping' é do 'root' e que possui a flag SUID definida!|
|HeartbeatFrequency|não|0-3600|60|Frequência em segundos das mensagens de "heartbeat" (sinal de vida).<br>Utilizado para monitorar a disponibilidade do proxy a partir do Zabbix Server.<br>0 - mensagens de 'heartbeat' desabilitadas.<br>Parâmetro de proxy ativo, ignorado nos proxies passivos (veja o parâmetro ProxyMode).|
|HistoryCacheSize|não|128K-2G|8M|Tamanho do cache de histórico, em bytes.<br>Tamanho da memória compartilhada para armazenar dados do histórico.|
|HistoryTextCacheSize|não|128K-2G|16M|Tamanho do cache de histórico de textos, em bytes.<br>Tamanho da memória compartilhada para armazenar os dados do histórico que sejam do tipo caractere, texto ou log.|
|Hostname|não|<|Definido pelo 'HostnameItem'|Nome único do Proxy - senssível ao caso. Certifique-se que o nome do proxy é exatamente o mesmo do definido na interface web do Zabbix!<br>Caracteres permitidos: alfanuméricos, '.', ' ', '\_' e '-'.<br>Tamanho máximo: 64|
|HostnameItem|não|<|system.hostname|Item utilizado para definir o hostname se este não tiver sido definido (será executado no proxy de forma similar à execução no agente).<br>Não suporta parâmetros de usuário, contadores de performance ou apelidos, mas suporta support 'system.run\[\]'.<br><br>Ignorado se o parâmetro 'Hostname' tiver sido definido.<br><br>Este parâmetro é suportado desde o Zabbix 1.8.6.|
|HousekeepingFrequency|não|0-24|1|Periodicidade em que o Zabbix executa o processo de limpeza de dados (em horas).<br>O processo de limpeza de dados remove do BD os dados antigos.<br>*Nota*: Para evitar sobrecarga (por exemplo, quando os parâmetros 'ProxyLocalBuffer' ou 'ProxyOfflineBuffer' são muito reduzidos), não serão excluídas dados mais antigos que 4 vezes o definido em horas pelo parÂmetro 'HousekeepingFrequency', a cada ciclo. Logo, se 'HousekeepingFrequency' for '1', não serão excluidos mais que 4 horas de dados antigos (começando pelo mais antigo) por ciclo.<br>*Nota*: Para evitar concorrência de processos e reduzir a carga no Zabbix Proxy a primeira execução do 'housekeeping' será atrazada em 30 minutos após a inicialização dos processos do proxy. Assim, se a 'HousekeepingFrequency' for igual a '1', a primeira das verificações iniciará 30 minutos após a carga do Zabbix Proxy, e irá repetir a cada hora a partir daí. Este início com atrazo foi implementado no **Zabbix 2.4.0.**<br>A partir do **Zabbix 3.0.0** é possível desabilitar o processo de limpeza de dados ao definir 'HousekeepingFrequency' para '0'. Neste caso o processo de limpeza de dados só será executado através do parâmetro de tempo de execução *housekeeper\_execute* e o período de informação antiga excluido em um ciclo será igual a 4 vezes o período desde sua última execução manual, nunca permitindo que seja a menos de 4 horas ou superior a 4 dias.|
|Include|não|<|<|Você pode incluir arquivos individuais ou todos os arquivos de um diretório no arquivo de configuração.<br>Para incluir apenas os arquivos relevantes de um determinado diretório, o caracter coringa "\*" é suportado para definir o padrão. Por exemplo: `/absolute/path/to/config/files/*.conf`. O suporte a padrões foi adicionado no **Zabbix 2.4.0.**<br>Veja as [notas especiais](special_notes_include) sobre as limitações.|
|JavaGateway|não|<|<|Endereço IP (ou hostname) do Zabbix Java gateway.<br>Requerido apenas se os poolers Java tiverem sido iniciados.<br>Este parâmetro é suportado desde o Zabbix 2.0.0.|
|JavaGatewayPort|não|1024-32767|10052|Porta que o Zabbix Java gateway estará escutando.<br>Este parâmetro é suportado desde o Zabbix 2.0.0.|
|ListenIP|não|<|0.0.0.0|Lista separada por vírgulas com os endereços IP que o Trapper deverá escutar.<br>O trapper irá escutar em todas as interfaces se este parâmetro estier ausente.<br>Múltiplos endereços IP são suportados desde o Zabbix 1.8.3.|
|ListenPort|não|1024-32767|10051|Porta do Trapper.|
|LoadModule|não|<|<|Módulo a carregar durante a inicialização do servidor. Módulos são utilizados para extender as funcionalidades do Zabbix Server.<br>Formato: LoadModule=<module.so><br>Os módulos precisam estar localizados no diretório especificado em LoadModulePath.<br>É permitida a inclusão de vários parâmetros 'LoadModule'.|
|LoadModulePath|não|<|<|Caminho completo do local (diretório) onde estarão os módulos carregáveis do servidor.<br>O valor padrão depende de opções de compilação.|
|LogFile|não|<|<|Nome do arquivo de log.|
|LogFileSize|não|0-1024|1|Tamanho máximo do log em MB.<br>0 - desativa a rotação de log.<br>*Nota*: Se o tamanho limite do log for alcançado e a rotação falhar, por qualquer que seja o motivo, o log atual será truncado e será inicializado um novo.|
|LogSlowQueries|não|0-3600000|0|Define o tempo mínimo de execução de uma consulta SQL para que ela seja classificada como lenta e registrada em log (em milisegundos).<br>0 - não registra queries lentas.<br>Esta opção é habilitada com se *DebugLevel=3*.<br>Este parâmetro é suportado desde o Zabbix 1.8.2.|
|PidFile|não|<|/tmp/zabbix\_server.pid|Nome do arquivo de PID.|
|ProxyLocalBuffer|não|0-720|0|O proxy irá guardar os dados localmente por N horas, caso estes ainda nao tenham sido enviados par ao Zabbix Server.<br>Este parâmetro pode ser utilizado se o dados forem ser utilizados por aplicações de terceiros.|
|ProxyMode|não|0-1|0|Modo de operação do proxy.<br>0 - proxy e mmodo ativo<br>1 - proxy em modo passivo<br>Este parâmetro é suportado desde o Zabbix 1.8.3.<br>*Nota* esta configuração do proxy pode ter implicações de segurança pois uma terceira parte poderá requisistar dados para esta porta, tal qual os de configuração.|
|ProxyOfflineBuffer|não|1-720|1|O proxy irá reter dados por N horas caso não seja possível a comunicação com o Zabbix Server.<br>Dados mais antigos serão perdidos.|
|ServerPort|não|1024-32767|10051|Porta do Zabbix trapper no Zabbix Server.<br>Parâmetro para o proxy ativo. Ignorado para o proxy passivo (consulte o parâmetro ProxyMode).|
|Server|sim|<|<|Endereço IP (ou hostname) do Zabbix server.<br>Um proxy ativo irá coletar a configuração de monitoração a ser executada do servidor aqui definido.<br>Parâmetro apenas para modo Ativo, será ignorado por proxy passivo (veja o parâmetro ProxyMode).|
|SNMPTrapperFile|não|<|/tmp/zabbix\_traps.tmp|Arquivo temporário utilizado para enviar dados do daemon SNMP para o proxy.<br>Precisa ser o mesmo arquivo utilizado pelo 'zabbix\_trap\_receiver.pl' ou 'SNMPTT'.<br>Este parâmetro é suportado desde o Zabbix 2.0.0.|
|SourceIP|não|<|<|Endereço de origem das comunicações de saída.|
|SSHKeyLocation|não|<|<|Localização dos arquivos de chave public e private keys para verificações SSH e ações|
|SSLCertLocation|não|<|<|Localização dos arquivos de certificado de cliente SSL para a autenticação de cliente.<br>Este parâmetro é utilizado pela monitoração web apenas e é suportado desde o **Zabbix 2.4.0**.|
|SSLKeyLocation|não|<|<|Localização do arquivo de chave privada SSL para a autenticação de cliente.<br>Este parâmetro é utilizado pela monitoração web apenas e é suportado desde o **Zabbix 2.4.0**.|
|SSLCALocation|não|<|<|Localização da cadeia de certificados (CA) para o certificado SSL do servidor.<br>Observe que este valor deve ser definido na opção CURLOPT\_CAPATH do libcurl. Para versões anteriores à versão 7.42.0 do libcurl, só fará efeito se o this libcurl was tiver sido compilado para utilizar o OpenSSL. Para maiores informações consulte [página web do cURL](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html).<br>Este parâmetro é utilizado pela monitoração web e é suportado desde o **Zabbix 2.4.0** e pela autenticação SMTP desde o Zabbix 3.0.0.|
|StartDBSyncers|não|1-100|4|Quantidade de instâncias pré-alocadas de DB Syncers.<br>O limite de utilização era 64 antes da versão 1.8.5.<br>Este parâmetro é suportado desde o Zabbix 1.8.3.|
|StartDiscoverers|não|0-250|1|Quantidade de instâncias pré-alocadas de discoverers.<br>O limite de utilização era 255 antes da versão 1.8.5.|
|StartHTTPPollers|não|0-1000|1|Quantidade de instâncias pré-alocadas de HTTP pollers.|
|StartIPMIPollers|não|0-1000|0|Quantidade de instâncias pré-alocadas de IPMI pollers.<br>O limite de utilização era 255 antes da versão 1.8.5.|
|StartJavaPollers|não|0-1000|0|Quantidade de instâncias pré-alocadas de Java pollers.<br>Este parâmetro é suportado desde o Zabbix 2.0.0.|
|StartPingers|não|0-1000|1|Quantidade de instâncias pré-alocadas de ICMP pingers.<br>O limite de utilização era 255 antes da versão 1.8.5.|
|StartPollersUnreachable|não|0-1000|1|Quantidade de instâncias pré-alocadas de pollers para hosts inacessíveis (incluindo IPMI e Java).<br>Desde o **Zabbix 2.4.0**, no mínimo um poller para hosts inacessíveis deverá estar rodando se um processo IPMI ou Java pollers tiver sido iniciado.<br>O limite de utilização era 255 antes da versão 1.8.5.|
|StartPollers|não|0-1000|5|Quantidade de instâncias pré-alocadas de pollers.<br>O limite de utilização era 255 antes da versão 1.8.5.|
|StartSNMPTrapper|não|0-1|0|Se definido como '1', o trapper SNMP será iniciado.<br>Este parâmetro é suportado desde o Zabbix 2.0.0.|
|StartTrappers|não|0-1000|5|Quantidade de instâncias pré-alocadas de trappers.<br>Os trappers aceitam conexões de entrada do Zabbix Sender e de agentes ativos.<br>O limite de utilização era 255 antes da versão 1.8.5.|
|StartVMwareCollectors|não|0-250|0|Quantidade de processos pré-alocados dos coletores VMware.<br>Este parâmetro é suportado desde o Zabbix 2.2.0.|
|Timeout|não|1-30|3|Define quanto tempo esperar pelo resultado do agente, SNMP ou verificação externa (em segundos).|
|TLSAccept|não|<|<|Quais conexões de entrada serão aceitas do Servidor Zabbix. Utilizado apenas pelo proxy passivo. Podem ser informados múltiplos valores, separados pro vírgulas:<br>'unencrypted' - aceita conexões sem criptografia (padrão)<br>psk - aceita conexões com TLS e PSK<br>cert - aceita conexões com TLS e certificado|
|TLSCAFile|não|<|<|Caminho completo para o arquivo contendo os certificados raiz para a autenticação entre as partes, utilizado para criptografar as comunicações entre os componentes do Zabbix.|
|TLSCertFile|não|<|<|Caminho completo para o arquivo contendo o certificado do proxy ou a cadeia de certificados, utilizado para criptografar as comunicações entre os componentes do Zabbix.|
|TLSConnect|não|<|<|Como o proxy irá se conectar ao servidor. Utilizado para proxy ativo apenas. Pode ser informado um destes valores:<br>'unencrypted' - aceita conexões sem criptografia (padrão)<br>psk - aceita conexões com TLS e PSK<br>cert - aceita conexões com TLS e certificado|
|TLSCRLFile|não|<|<|Caminho completo para o arquivo contendo os certificados revogados, utilizado para criptografar as comunicações entre os componentes do Zabbix.|
|TLSKeyFile|não|<|<|Caminho completo para o arquivo contendo the proxy private key, utilizado para criptografar as comunicações entre os componentes do Zabbix.|
|TLSPSKFile|não|<|<|Caminho completo para o arquivo contendo the proxy pre-shared key. used for encrypted communications with Zabbix server.|
|TLSPSKIdentity|não|<|<|Identidade da Chave PSK, utilizado para criptografar as comunicações com o Zabbix Server.|
|TLSServerCertIssuer|não|<|<|Emissor de certificado aceito.|
|TLSServerCertSubject|não|<|<|Assunto aceito no certificado emitido.|
|TmpDir|não|<|/tmp|Diretório temporário.|
|TrapperTimeout|não|1-300|300|Define quantos segundos o trapper pode demorar enviando novos dados.|
|User|não|<|zabbix|Muda os permissionamentos para um usuário específico do sistema.<br>Só afeta se o processo for iniciado pelo usuário 'root' e 'AllowRoot' estiver desativado.<br>Este parâmetro é suportado desde o**Zabbix 2.4.0**.|
|UnavailableDelay|não|1-3600|60|Periodicidade de verificação de disponibilidade durante o período de [indisponibilidade](/pt/manual/appendix/items/unreachability#unavailable_host), em segundos.|
|UnreachableDelay|não|1-3600|15|Periodicidade de verificação de acessibilidade durante um período de [inacessibilidade](/pt/manual/appendix/items/unreachability#unreachable_host), em segundos.|
|UnreachablePeriod|não|1-3600|45|Após quantos segundos de [indisponibilidade](/pt/manual/appendix/items/unreachability#unreachable_host) o host será tratado como indisponível.|
|VMwareCacheSize|não|256K-2G|8M|Tamanho da memória compartilhada para dados do VMware.<br>Uma verificação interna **zabbix\[vmware,buffer,...\]** poderá ser utilizada par amonitorar o uso de cache VMware (veja mais em [verificações internas](/pt/manual/config/items/itemtypes/internal)).<br>Observe que a memória compartilhada não será alocada se não existirem instâncias de coleta VMware configuradas para inicialização.<br>Este parâmetro é suportado desde o Zabbix 2.2.0.|
|VMwareFrequency|não|10-86400|60|Intervalo em segundos entre coletar um dado do serviço do VMware.<br>Este intervalo deverá ser menor do que os intervalos entre coletas de itens do VMware.<br>Este parâmetro é suportado desde o Zabbix 2.2.0.|
|VMwarePerfFrequency|não|10-86400|60|Intervalo em segundos entre a coleta de dados de performance e dados simples do VMware.<br>Este intervalo deverá ser menor do que os intervalos entre coletas de itens do VMware.<br>Este parâmetro é suportado desde o Zabbix 2.2.9, 2.4.4|
|VMwareTimeout|não|1-300|10|Tempo máximo de espera para coletar um item do VMware (vCenter ou ESX hypervisor).<br>Este parâmetro é suportado desde o Zabbix 2.2.9, 2.4.4|

::: noteclassic
O Zabbix suporta arquivos de configuração somente no formato
UTF-8 sem [BOM](https://en.wikipedia.org/wiki/Byte_order_mark).\
\
Comentários inciam com "\#" e só são suportados no início das
linhas.
:::
