Documentation
Table of Contents
4 Áú»¢¶Ä²© Agent (Windows)
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 no Windows:
| 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 a utiliza??o de arquivo de pagina??o em percentual de um servidor: Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage] pode ser encurtado para pg_usage.Apelidos podem ser utilizados para o HostMetadataItem mas n?o para o par?metro HostnameItem ou PerfCounter. |
||
| 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. Consulte o manual de configura??o do agente windows para maiores detalhes. |
|
| 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 | Sobe o agente em uma interface espec¨ªfica. M¨²ltiplos IPs podem ser informados, e devem ser separados por ponto e v¨ªrgula. Suportado desde o Áú»¢¶Ä²© 1.8.3. | |
| ListenPort | n?o | 1024-32767 | 10050 | O agente ir¨¢ receber conex?es do servidor a partir desta porta. |
| LogFile | n?o | Nome do arquivo de log. | ||
| LogType | n?o | arquivo | Tipo de sa¨ªda de log: file - grava o log no arquivo definido pelo par?metro LogFile, system - grava no log de eventos do Windows, console - apresenta os dados na saida normal. Suportado desde o Áú»¢¶Ä²© 3.0.0. |
|
| 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' . |
| PerfCounter | n?o | Sintaxe: <parameter_name>,"<perf_counter_path>",<period> Define um novo par?metro <parameter_name> com a m¨¦dia de valor de determinado contador de performance <perf_counter_path> em um tempo espec¨ªfico de tempo (in seconds). Por exemplo, se voc¨º quer receber a m¨¦dia de interrup??es de processador por segundo no ¨²ltimo minuto, voc¨º pode definir um novo par?metro "interrupts": PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60 Observe o uso de aspas duplas ao redor do caminho do contador de performance. O nome do par?metro (interrupts) ser¨¢ utilizado como chave do item durante sua cria??o. As amostras utilizadas para o c¨¢lculo da m¨¦dia ser?o coletadas uma vez por segundo. Voc¨º pode executar "typeperf -qx" para obter uma lista com todos os contadores de performance dispon¨ªveis no Windows. |
||
| 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 de contendo os endere?os IP (ou nomes de DNS) dos Áú»¢¶Ä²© Server/Proxy permitidos. Conex?es a partir de outros IPs ser?o rejeitadas. Espa?os s?o permitidos desde o Áú»¢¶Ä²© 2.2. Observe que os nomes 'hostnames' precisam ser resolvidos como hostname¡úendere?o IP e como endere?o IP¡úhostname. If se o suporte a IPv6 estiver ativo, os endere?os '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' ser?o tratados de igual forma. |
||
| 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-63 (*) | 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 | sim, se o certificado TLS ou os par?metros PSK estiverem definidos (mesmo para conex?o n?o criptografada), outras situa??es: 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. Suportado desde o Áú»¢¶Ä²© 3.0.0. |
||
| 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 Áú»¢¶Ä²©. Suportado desde o Áú»¢¶Ä²© 3.0.0. | ||
| 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 Áú»¢¶Ä²©. Suportado desde o Áú»¢¶Ä²© 3.0.0. | ||
| TLSConnect | sim, se o certificado TLS ou os par?metros PSK estiverem definidos (mesmo para conex?o n?o criptografada), outras situa??es: 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. Suportado desde o Áú»¢¶Ä²© 3.0.0. |
||
| TLSCRLFile | n?o | Caminho completo para o arquivo contendo os certificados revogados, utilizado para comunica??es criptografadas entre os componentes do Áú»¢¶Ä²©. Suportado desde o Áú»¢¶Ä²© 3.0.0. | ||
| TLSKeyFile | n?o | Caminho completo para o arquivo contendo a chave privada do agente, utilizado para comunica??es criptografadas entre os componentes do Áú»¢¶Ä²©. Suportado desde o Áú»¢¶Ä²© 3.0.0. | ||
| TLSPSKFile | n?o | Caminho completo para o arquivo contendo a PSK do agente, utilizado para comunica??es criptografadas entre os componentes do Áú»¢¶Ä²©. Suportado desde o Áú»¢¶Ä²© 3.0.0. | ||
| 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. |
| 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. Exemplo: UserParameter=system.test,echo 1 |
|||
(*) A quantidade de servidores ativos no par?metro ServerActive somados ¨¤ quantidade de inst?ncias pr¨¦-alocadas para verifica??es passivas, definidas pelo par?metro StartAgents dever¨¢ ser inferior a 64.
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
- .