# - \#4 Zabbix Agent (Windows)

::: noteclassic
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 Zabbix Agent
no Windows:

|Parâmetro|Obrigatório|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.<br>Múltiplos parâmetros *Alias* poderão estar presentes. Múltiplos parâmetros *Alias* com a mesma chave não são permitidos.<br>Chaves diferentes de *Alias* poderão referenciar a mesma chave de item.<br>Por exemplo, para recuperar a utilização de arquivo de paginação em percentual de um servidor:<br>Alias=pg\_usage:perf\_counter\[\\Paging File(\_Total)\\% Usage\]<br>pode ser encurtado para `pg_usage`.<br>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 Zabbix Server/Proxy caso o buffer encha.|
|DebugLevel|não|0-5|3|Define o nível de depuração:<br>0 - informações básicas sobre iniciação/parada de processos Zabbix<br>1 - informações críticas<br>2 - informações de erro<br>3 - avisos<br>4 - depuração (produz muita informação)<br>5 - depuração estendida (produz MUITO MAIS informação)|
|EnableRemoteCommands|não|<|0|Permite a execução de comandos remotos enviados pelo Zabbix Server.<br>0 - não permitido<br>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).<br>Se não for definido, o valor será obtido pelo parâmetro *HostMetadataItem*.<br>O uso de caracteres não UTF-8 ou maior que o permitido impedirá a carga do agente.<br>Suportado desde o Zabbix 2.2.0.|
|HostMetadataItem|não|<|<|Define o item utilizado para a definição do metadado do *Zabbix agent*. Esta opção só é utilizada se o parâmetro *HostMetadata* não for definido.<br>Suporta parâmetros de usuário, contadores de performance e apelidos. Suporta *system.run\[\]* em substituição de *EnableRemoteCommands*.<br>Os metadados são utilizados apenas pelo processo de autorregistro (agente ativo).<br>Durante o processo de autorregistro o agente irá registrar uma mensagem de aviso se o valor retornado for maior que 255 characteres.<br>O valor retornado pelo item deverá estar codificado em UTF-8 ou será ignorado.<br>Suportado desde o Zabbix 2.2.0.|
|Hostname|não|<|Definido pelo parâmetro **HostnameItem**|Único e sensível ao caso.<br>Obrigatório para verificações ativas e precisa ser exatamente igual ao 'hostname' configurado na interface web do Zabbix.<br>Caracteres permitidos: alfanuméricos, '.', ' ', '\_' e '-'.<br>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.<br>Não suporta parâmetros de usuário, contadores de performance e apelidos, mas suporta *system.run\[\]* em substituição do *EnableRemoteCommands*.<br>Suportado desde o Zabbix 1.8.6.<br>Consulte o manual de [configuração do agente windows](/pt/manual/appendix/install/windows_agent#configuration) para maiores detalhes.|
|Include|não|<|<|Você pode incluir arquivos individuais de configuração ou todos os arquivos de determinado diretório.<br>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 **Zabbix 2.4.0.**<br>Consulte mais em [notas especiais](special_notes_include) 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 Zabbix 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:<br>*file* - grava o log no arquivo definido pelo parâmetro **LogFile**,<br>*system* - grava no log de eventos do Windows,<br>*console* - apresenta os dados na saida normal.<br>Suportado desde o Zabbix 3.0.0.|
|LogFileSize|não|0-1024|1|Tamanho máximo do arquivo de log (em MB).<br>0 - desabilita a rotação automática de log.<br>*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.<br>0 - inativo<br>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.<br>O valor informado será sobrescrito pelo parâmetro 'maxlines',<br>quando informado nas chaves de item: 'log', 'logrt' ou 'eventlog' .|
|PerfCounter|não|<|<|Sintaxe: <parameter\_name>,"<perf\_counter\_path>",<period><br>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).<br>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":<br>PerfCounter = interrupts,"\\Processor(0)\\Interrupts/sec",60<br>Observe o uso de aspas duplas ao redor do caminho do contador de performance.<br>O nome do parâmetro (interrupts) será utilizado como chave do item durante sua criação.<br>As amostras utilizadas para o cálculo da média serão coletadas uma vez por segundo.<br>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.<br>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 Zabbix Server/Proxy permitidos. Conexões a partir de outros IPs serão rejeitadas. Espaços são permitidos desde o Zabbix 2.2.<br>Observe que os nomes 'hostnames' precisam ser resolvidos como *hostname→endereço IP* e como *endereço IP→hostname*.<br>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 Zabbix Server/Proxy usados para verificações ativas.<br>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.<br>Se a porta não for definida, será utilizada a padrão (10051).<br>Endereços IPv6 com porta definida precisam estar entre aspas, se não for definida a porta o uso de aspas é opcional.<br>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.<br>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:<br>**unencrypted** - aceita conexões sem criptografia (padrão)<br>**psk** - aceita conexões com o uso de TLS e pre-shared key (PSK)<br>**cert** - aceita conexões com TLS e certificado. Suportado desde o Zabbix 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 Zabbix. Suportado desde o Zabbix 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 Zabbix. Suportado desde o Zabbix 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 Zabbix Server/Proxy. Utilizado para verificações ativas. Apenas um destes pode ser definido:<br>**unencrypted** - conectar sem criptografia (padrão)<br>**psk** - conectar com o uso de TLS e pre-shared key (PSK)<br>**cert** - conectar com TLS e certificado. Suportado desde o Zabbix 3.0.0.|
|TLSCRLFile|não|<|<|Caminho completo para o arquivo contendo os certificados revogados, utilizado para comunicações criptografadas entre os componentes do Zabbix. Suportado desde o Zabbix 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 Zabbix. Suportado desde o Zabbix 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 Zabbix. Suportado desde o Zabbix 3.0.0.|
|TLSPSKIdentity|não|<|<|Identidade PSK, utilizado para comunicações criptografadas entre os componentes do Zabbix.|
|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.<br>Os caracteres a seguir não são permitidos:<br>\\ ' " \` \* ? \[ \] { } \~ $ ! & ; ( ) < > \| \# @<br>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.<br>Formato: UserParameter=<key>,<shell command><br>Observe que o comando do shell precisa retornar algo diferente de texto em branco ou EOL.<br>Exemplo: UserParameter=system.test,echo 1|

::: noteclassic
 (\*) 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.
:::

::: noteclassic
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"](#see_also) ao final
deste manual para maiores detalhes sobre estas
modificações.
:::

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

### See also

1.  [Diferenças entre o arquivo de configuração do agente a partir da
    versão
    2.0.0](http://blog.zabbix.com/multiple-servers-for-active-agent-sure/858).