Documentation
Table of Contents
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.