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.
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 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: <nome_parâmetro>, "<caminho_para_perf_counter>", <período>
Define novo parâmetro <parameter_name> que é um valor médio para contador de desempenho do sistema <caminho_para_perf_counter> para o período de tempo especificado <período> (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 = <chave>, <comando shell>
Note que o comando shell não deve retornar string vazia ou EOL apenas.
Exemplo: UserParameter = system.test, echo 1

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

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" na parte inferior desta página para mais detalhes sobre estas alterações.

O Zabbix suporta arquivos de configuração apenas em codificação UTF-8 sem BOM.

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 (em inglês)