Documentation
Table of Contents
3 Áú»¢¶Ä²© Agent (UNIX)
Os valores padr?o aqui descrito refletem os padr?es dos bin¨¢rios, n?o dos arquivos de configura??o fornecidos.
Os par?metros suportados por um arquivo de configura??o do Áú»¢¶Ä²© Agent (zabbix_agentd.conf):
| Par?metro | °¿²ú°ù¾±²µ²¹³Ù¨®°ù¾±´Ç | Range | Padr?o | Descri??o |
|---|---|---|---|---|
| Alias | n?o | Defina um apelido para a chave do item. Pode ser utilizado para substituir chaves longas e complexas por uma menor. M¨²ltiplos par?metros Alias poder?o estar presentes. M¨²ltiplos par?metros Alias com a mesma chave n?o s?o permitidos. Chaves diferentes de Alias poder?o referenciar a mesma chave de item. Por exemplo, para recuperar o ID do usu¨¢rio 'zabbix': Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,^zabbix:.:([0-9]+),,,,\1] pode ser encurtado para 'zabbix.userid' . |
||
| AllowRoot | n?o | 0 | Permite que o agente seja executado com permiss?es do usu¨¢rio 'root'. Se desabilitado e o agente for iniciado pelo 'root', o agente ir¨¢ tentar alternar seu permissionamento para o usu¨¢rio 'zabbix'. N?o tem efeito se for iniciado por um usu¨¢rio comum. 0 - n?o permite 1 - permite |
|
| BufferSend | n?o | 1-3600 | 5 | N?o guardar dados mais antigos que N segundos no buffer. |
| BufferSize | n?o | 2-65535 | 100 | Quantidade m¨¢xima de valores armazenados no buffer. O agente ir¨¢ enviar todos os valores para o Áú»¢¶Ä²© Server/Proxy caso o buffer encha. |
| DebugLevel | n?o | 0-5 | 3 | Define o n¨ªvel de depura??o: 0 - informa??es b¨¢sicas sobre inicia??o/parada de processos Áú»¢¶Ä²© 1 - informa??es cr¨ªticas 2 - informa??es de erro 3 - avisos 4 - depura??o (produz muita informa??o) 5 - depura??o estendida (produz MUITO MAIS informa??o) |
| EnableRemoteCommands | n?o | 0 | Permite a execu??o de comandos remotos enviados pelo Áú»¢¶Ä²© Server. 0 - n?o permitido 1 - permitido |
|
| HostMetadata | n?o | 0-255 characters | Par?metro opcional que define os metadados do host. Os metadados s?o utilizados apenas pelo processo de autorregistro (agente ativo). Se n?o for definido, o valor ser¨¢ obtido pelo par?metro HostMetadataItem. O uso de caracteres n?o UTF-8 ou maior que o permitido impedir¨¢ a carga do agente. Suportado desde o Áú»¢¶Ä²© 2.2.0. |
|
| HostMetadataItem | n?o | Define o item utilizado para a defini??o do metadado do Áú»¢¶Ä²© agent. Esta op??o s¨® ¨¦ utilizada se o par?metro HostMetadata n?o for definido. Suporta par?metros de usu¨¢rio, contadores de performance e apelidos. Suporta system.run[] em substitui??o de EnableRemoteCommands. Os metadados s?o utilizados apenas pelo processo de autorregistro (agente ativo). Durante o processo de autorregistro o agente ir¨¢ registrar uma mensagem de aviso se o valor retornado for maior que 255 characteres. O valor retornado pelo item dever¨¢ estar codificado em UTF-8 ou ser¨¢ ignorado. Suportado desde o Áú»¢¶Ä²© 2.2.0. |
||
| Hostname | n?o | Definido pelo par?metro HostnameItem | ?nico e sens¨ªvel ao caso. °¿²ú°ù¾±²µ²¹³Ù¨®°ù¾±´Ç para verifica??es ativas e precisa ser exatamente igual ao 'hostname' configurado na interface web do Áú»¢¶Ä²©. Caracteres permitidos: alfanum¨¦ricos, '.', ' ', '_' e '-'. Tamanho m¨¢ximo: 64 |
|
| HostnameItem | n?o | system.hostname | Par?metro opcional que define qual item ser¨¢ utilizado para retornar o 'hostname'. Esta op??o s¨® ¨¦ utilizada se o par?metro Hostname n?o for definido. N?o suporta par?metros de usu¨¢rio, contadores de performance e apelidos, mas suporta system.run[] em substitui??o do EnableRemoteCommands. Suportado desde o Áú»¢¶Ä²© 1.8.6. |
|
| Include | n?o | Voc¨º pode incluir arquivos individuais de configura??o ou todos os arquivos de determinado diret¨®rio. Para incluir somente os arquivos relevantes de determinado diret¨®rio, poder¨¢ ser utilizados padr?es de nomes. Por exemplo: /absolute/path/to/config/files/*.conf. O suporte a padr?es de nomes ¨¦ suportado desde o Áú»¢¶Ä²© 2.4.0.Consulte mais em notas especiais sobre limites. |
||
| ListenIP | n?o | 0.0.0.0 | Lista de IPs nos aos quais o agente do Áú»¢¶Ä²© ir¨¢ escutar. Suportado desde o Áú»¢¶Ä²© 1.8.3. |
|
| ListenPort | n?o | 1024-32767 | 10050 | O agente ir¨¢ receber conex?es do servidor a partir desta porta. |
| LoadModule | n?o | M¨®dulo a carregar durante a inicializa??o do servidor. M¨®dulos s?o utilizados para extender as funcionalidades do Áú»¢¶Ä²© Server. Formato: LoadModule=<module.so> Os m¨®dulos precisam estar localizados no diret¨®rio especificado em LoadModulePath. ? 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. O valor padr?o depende de op??es de compila??o. |
||
| LogFile | n?o | Nome do arquivo de log. Se n?o for definido, o syslog ser¨¢ utilizado. |
||
| LogFileSize | n?o | 0-1024 | 1 | Tamanho m¨¢ximo do arquivo de log (em MB). 0 - desabilita a rota??o autom¨¢tica de log. Nota: se o tamanho limite do log for alcan?ado e a rota??o falhar, por qualquer motivo, o log atual ser¨¢ zerado e um novo ser¨¢ iniciado. |
| LogRemoteCommands | n?o | 0 | Ativa o log de comandos executados. 0 - inativo 1 - ativo |
|
| MaxLinesPerSecond | n?o | 1-1000 | 20 | Quantidade m¨¢xima de linhas por segundo que o agente ir¨¢ enviar ao servidor para itens de 'log', 'logrt' e 'eventlog' em modo de verifica??o ativa. O valor informado ser¨¢ sobrescrito pelo par?metro 'maxlines', quando informado nas chaves de item: 'log', 'logrt' ou 'eventlog' .\\Nota: O Áú»¢¶Ä²© processa 4 vezes mais linhas do que o definido em MaxLinesPerSecond para localizar o texto necess¨¢rio nos logs. |
| PidFile | n?o | /tmp/zabbix_agentd.pid | Nome do arquivo de PID. | |
| RefreshActiveChecks | n?o | 60-3600 | 120 | Intervalo entre atualiza??es da lista de verifica??es ativas, em segundos. Observe que ap¨®s uma falha na obten??o da lista, nova tentativa ser¨¢ feita em 60 segundos. |
| Server | sim | Lista separada por v¨ªrgulas contendo os endere?os IP, opcionalmente em nota??o CIDR, ou hostname dos Áú»¢¶Ä²© Server/Proxy. As conex?es de entrada ser?o aceitas apenas nos hosts listados aqui. Se o suporte ao IPv6 estiver ativado, ent?o '127.0.0.1', '::127.0.0.1', '::ffff: 127.0.0.1' ser?o tratados da mesma forma e '::/0' permitir¨¢ qualquer endere?o IPv4 ou IPv6. '0.0.0.0/0' pode ser usado para permitir qualquer endere?o IPv4. Observe que ¡°endere?os IPv6 compat¨ªveis com IPv4¡± (prefixo 0000::/96) s?o suportados, mas obsoletos pelo . Exemplo: Server=127.0.0.1.192.168.1.0/24,::1.2001:db8::/32,zabbix.domain. Espa?os s?o permitidos. | ||
| ServerActive | n?o | (*) | Conjunto IP:porta ou hostname:porta dos Áú»¢¶Ä²© Server/Proxy usados para verifica??es ativas. S?o permitidos diversos endere?os separados por v¨ªrgula e os servidores ser?o tratados de forma independente, em paralelo. N?o s?o permitidos espa?os. Se a porta n?o for definida, ser¨¢ utilizada a padr?o (10051). Endere?os IPv6 com porta definida precisam estar entre aspas, se n?o for definida a porta o uso de aspas ¨¦ opcional. Se este par?metro n?o for definido as verifica??es ativas ser?o desativadas. |
|
| SourceIP | n?o | IP a ser utilizado nas conex?es de sa¨ªda. | ||
| StartAgents | n?o | 0-100 | 3 | Quantidade de inst?ncias pr¨¦-alocadas do zabbix_agentd para as verifica??es passivas. Se definido como '0', ir¨¢ desativar as verifica??es passivas e o agente n?o ir¨¢ escutar nenhuma porta TCP. |
| Timeout | n?o | 1-30 | 3 | Tempo limite ao buscar determinado valor (1-255). O agente n?o ir¨¢ abortar a execu??o de par?metros de usu¨¢rio ao alcan?ar o tempo limite! |
| TLSAccept | n?o | Quais conex?es de entrada ser?o aceitas. Utilizada em verifica??es passivas. M¨²ltiplos valores podem ser definidos, separados por v¨ªrgulas: unencrypted - aceita conex?es sem criptografia (padr?o) psk - aceita conex?es com o uso de TLS e pre-shared key (PSK) cert - aceita conex?es com TLS e certificado |
||
| TLSCAFile | n?o | Caminho completo do arquivo contendo os certificados raiz (CA) para verifica??o dos certificados entre as partes, utilizado para comunica??es criptografadas entre os componentes do Áú»¢¶Ä²©. | ||
| TLSCertFile | n?o | Caminho completo para o arquivo contendo o certificado de agente ou a cadeia de certificados, utilizada para comunica??es criptografadas entre os componentes do Áú»¢¶Ä²©. | ||
| TLSConnect | n?o | Como o agente ir¨¢ se conectar ao Áú»¢¶Ä²© Server/Proxy. Utilizado para verifica??es ativas. Apenas um destes pode ser definido: unencrypted - conectar sem criptografia (padr?o) psk - conectar com o uso de TLS e pre-shared key (PSK) cert - conectar com TLS e certificado |
||
| TLSCRLFile | n?o | Caminho completo para o arquivo contendo os certificados revogados, utilizado para comunica??es criptografadas entre os componentes do Áú»¢¶Ä²©. | ||
| TLSKeyFile | n?o | Caminho completo para o arquivo contendo a chave privada do agente, utilizado para comunica??es criptografadas entre os componentes do Áú»¢¶Ä²©. | ||
| TLSPSKFile | n?o | Caminho completo para o arquivo contendo a PSK do agente, utilizado para comunica??es criptografadas entre os componentes do Áú»¢¶Ä²©. | ||
| TLSPSKIdentity | n?o | Identidade PSK, utilizado para comunica??es criptografadas entre os componentes do Áú»¢¶Ä²©. | ||
| TLSServerCertIssuer | n?o | Emissor de certificado autorizado do server (proxy) | ||
| TLSServerCertSubject | n?o | Destino do certificado permitido pelo server (proxy) | ||
| UnsafeUserParameters | n?o | 0-1 | 0 | Permite que qualquer caractere seja passado como argumentos em par?metros definidos pelo usu¨¢rio. Os caracteres a seguir n?o s?o permitidos: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @ Caracteres de nova linha tamb¨¦m n?o s?o permitidos. |
| User | n?o | zabbix | Modifica os privil¨¦gios para um usu¨¢rio espec¨ªfico, existente no ambiente. S¨® tem efeito se iniciado como 'root' e o par?metro AllowRoot estiver inativo. Suportado desde o Áú»¢¶Ä²© 2.4.0. |
|
| UserParameter | Par?metro de monitora??o definido pelo usu¨¢rio. M¨²ltiplos par?metros UserParameter poder?o estar presentes. Formato: UserParameter=<key>,<shell command> Observe que o comando do shell precisa retornar algo diferente de texto em branco ou EOL. UserParameter=system.test,who|wc -l |
|||
Na vers?o 2.0.0 do agente os par?metros de configura??o relacionados a verifica??es ativas e passivas foram modificados.
Consulte a p¨¢gina listada na se??o "Veja tamb¨¦m" ao final deste manual para maiores detalhes sobre estas modifica??es.
O Áú»¢¶Ä²© suporta arquivos de configura??o no formato UTF-8 sem o .
Coment¨¢rios s?o iniciados com "#" e s¨® s?o suportados no in¨ªcio das linhas.
See also
- .