# 4 Agente Zabbix (Windows) Os parâmetros suportados em um arquivo de configuração do agente Zabbix (Windows) são: |Parâmetro|Obrigatório|Faixa|Padrão|Descrição| |----------|------------|-----|-------|-----------| |Alias|não|<|<|Define um alias para uma chave de item. Ele pode ser utilizado para substituir uma chave de item longa e complexa por outra menor e mais simples.
Vários parâmetros // Alias // podem estar presentes, mas múltiplos parâmetros com a mesma chave // Alias // chave não são permitidos.
Diferentes chaves // Alias // podem fazer referência à mesma chave do item.
Por exemplo, para recuperar o uso do arquivo de paginação do servidor, em percentual:
%% Alias=pg\_usage:perf\_counter\[\\Paging File(\_Total)\\% Usage\] %%
A partir de então a chave mais curta pg\_usage pode ser usada para recuperar dados.
Aliases podem ser utilizados no parâmetro *HostMetadataItem*, mas não no *HostnameItem* ou *Perfcounter*.| |BufferSend|não|1-3600|5|Não manter os dados por mais de N segundos no buffer.| |BufferSize|não|2-65535|100|Número máximo de valores em um buffer de memória. O agente irá enviar todos os dados coletados para o servidor ou proxy Zabbix se o buffer estiver cheio.| |DebugLevel|não|0-4|3|Especifica o nível de depuração:
0 - informações básicas sobre início e parada de processos Zabbix
1 - informações críticas
2 - informações sobre erros
3 - avisos
4 - depuração (produz grande quantidade de informações)
| |EnableRemoteCommands|não|<|0|Indica se comandos remotos do servidor Zabbix são permitidos
0 - não permite
1 - permite| |HostMetadata|não|0-255 caracteres|<|Parâmetro opcional que define metadados de um host. Metadados de um host são usados somente no processo de auto-registro de host (agente ativo).
Se não definido, o valor será adquirido a partir de HostMetadataItem.
Um agente irá emitir um erro e não iniciar se o valor especificado estiver acima do limite ou não for uma string UTF-8.
Esta opção é suportada na versão 2.2.0 ou superior.| |HostMetadataItem|não|<|<|Parâmetro opcional que define um item //agente Zabbix // usado para a obtenção de metadados do host. Esta opção só é utilizada quando HostMetadata não estiver definido.
Suporta userParameters e aliases. Suporta *system.run\[\]* independentemente de // EnableRemoteCommands // estar definido ou não.
Metadados do host são usados somente no processo de auto-registro de host (agente ativo).
Durante um pedido de registo automático o agente irá registrar um mensagem de aviso se o valor retornado pelo item especificado estiver acima do limite de 255 caracteres.
O valor retornado pelo item deve ser uma string UTF-8, caso contrário ele será ignorado.
Esta opção é suportada na versão 2.2.0 e superior.| |Hostname|não|<|Definido por HostnameItem|Nome do host único e sensível à caixa.
É necessário para verificações ativas e deve coincidir com o nome do host como configurado no servidor.
Caracteres permitidos: '.', ' ', '\_' e '-'.
Comprimento máximo: 64| |HostnameItem|não|<|system.hostname|Parâmetro opcional que define um item // agente Zabbix // usado para obter o nome do host. Esta opção só é utilizada quando HostMetadata não estiver definido.
Não suporta UserParameters ou apelidos, mas suporta *system.run\[\]* independentemente de // EnableRemoteCommands // estar habilitado ou não.
Esta opção é suportada na versão 1.8.6 e superior.
Veja também uma [descrição mais detalhada](/pt/manual/appendix/install/windows_agent#configuration).| |Include|não|<|<|Pode-se incluir arquivos individuais ou todos os arquivos em um diretório no arquivo de configuração
Para incluir apenas arquivos relevantes no diretório especificado, o caractere curinga asterisco é suportado para batimento de padrões. Por exemplo: '' /caminho/absoluto/para/arquivos/de/configuração/\*.conf ''. O batimento de padrões é suportado desde o \*\* Zabbix 2.4.0 \*\*
Ver [notas especiais](Special_notes_include) sobre as limitações.| |ListenIP|não|<|0.0.0.0|O agente vai ouvir na interface especificada.| |ListenPort|não|1024-32767|10050|O agente vai aguardar nesta porta por conexões do servidor.| |LogFile|não|<|<|Nome do arquivo de log
Se não for definido, o Log de Eventos do Windows será usado.| |LogFileSize|não|0-1024|1|Tamanho máximo do arquivo de log em MB
0 - desativar a rotação automática de log
// Nota //: Se o limite de tamanho do arquivo de log é atingido e rotação arquivo falhar, por qualquer razão, o arquivo de log existente será truncado e reiniciado do zero.| |LogRemoteCommands|não|<|0|Habilitar o log de comandos shell executados (como avisos).
0 - desativado
1 - habilitado| |MaxLinesPerSecond|não|1-1000|100|Número máximo de novas linhas que o agente enviará por segundo ao servidor ou proxy Zabbix ao processar verificações ativas 'log', 'logrt' e 'eventlog'.
O valor fornecido será sobreescrito pelo parâmetro 'MaxLines' fornecido na chave de item "log", "logrt" ou 'eventlog'.| |PerfCounter|não|<|<|Sintaxe: , "",
Define novo parâmetro que é um valor médio para contador de desempenho do sistema para o período de tempo especificado (em segundos).
Por exemplo, se você deseja receber o número médio de interrupções do processador por segundo para a última hora, você pode definir um novo parâmetro "interrupções" da seguinte forma:
PerfCounter = interrupções, "\\processador(0)\\interrupções / s ", 60
Note as aspas duplas em torno do caminho do contador de desempenho.
O nome do parâmetro ("interrupções") deve ser usado como chave do item ao criar um item.
As amostras para o cálculo do valor médio serão coletadas a cada segundo.
Você pode executar "typeperf -qx" para obter a lista de todos os contadores de desempenho disponíveis no Windows.| |RefreshActiveChecks|não|60-3600|120|Indica a frequência de atualização da lista de verificações ativas, em segundos.
Note que, depois de não conseguir atualizar verificações ativas, a próxima atualização será tentada após 60 segundos.| |Server|não|<|<|Lista de endereços IP (ou nomes de host), delimitados por vírgula, de servidores Zabbix. Espaços são permitidos desde a versão Zabbix 2.2.
Conexões de entrada só serão aceitas a partir dos hosts listados aqui.
Observe que deve ser possível resolver hostname→ endereço IP e endereço IP → hostname.
Se o suporte a IPv6 estiver habilitado, então '127.0.0.1', '::127.0.0.1' e '::ffff:127.0.0.1' são tratados igualmente.| |ServerActive|<|não|<|Lista de portas (ou hostname:: porta) de servidores Zabbix para verificações ativas. Espaços não são permitidos.
Se a porta não for especificada, a padrão será usada.
Endereços IPv6 devem ser colocados entre colchetes se a porta for especificada.
Se a porta não for especificada, colchetes para endereços IPv6 são opcionais.
Se esse parâmetro não for especificado, as verificações ativas serão desativadas.| |SourceIP|não|<|<|Endereço IP de origem para as conexões de saída.| |StartAgents|não|0-63 (\*)|3|Número de instâncias pré-disparadas de zabbix\_agentd que processam verificações passivas.
Se definido como 0, desabilita verificações passivas e o agente não vai ouvir em porta TCP alguma.
O limite superior era 16 antes da versão 1.8.5.| |Timeout|não|1-30|3|Não gastar mais do que "timeout" segundos no processamento.| |UnsafeUserParameters|não|0-1|0|Permitir que quaisquer caracteres sejam passados como argumentos para parâmetros definidos pelo usuário.
0 - não permite
1 - permite| |UserParameter|<|<|<|Parâmetro de monitoramento definido pelo usuário. Pode haver vários parâmetros definidos pelo usuário
Formato: UserParameter = ,
Note que o comando shell não deve retornar string vazia ou EOL apenas.
Exemplo: UserParameter = system.test, echo 1| ::: noteclassic (\*) O número de servidores ativos listados em ServerActive mais o número de instâncias pré-disparadas para verificações passivas deve ser inferior a 64. ::: ::: noteclassic No agente Zabbix 2.0.0 os parâmetros de configuração relacionados com verificações ativas foram alterados.\ Veja a seção ["Veja também"](#see_also) na parte inferior desta página para mais detalhes sobre estas alterações. ::: ::: noteclassic O Zabbix suporta arquivos de configuração apenas em codificação UTF-8 sem [BOM](https://en.wikipedia.org/wiki/Byte_order_mark).\ \ Comentários começando com "\#" são suportados apenas no início da linha. ::: ### Veja também 1. [Diferenças na configuração do agente Zabbix para verificações ativas e passivas a partir da versão 2.0.0](http://blog.zabbix.com/multiple-servers-for-active-agent-sure/858) (em inglês)