3 Agente Zabbix (UNIX)

Os parâmetros suportados em um arquivo de configuração do agente Zabbix (zabbix_agentd.conf) são:

Parâmetro Obrigatório Intervalo 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 // não são permitidos
Diferentes chaves // Alias // podem fazer referência à mesma chave do item.
Por exemplo, para recuperar o ID do usuário 'zabbix':
%% Alias = zabbix.userid: vfs.file.regexp [/ etc / passwd,
zabbix:.: ([0-9] +) ,,,, \ 1] %%
A partir de então a chave mais curta ** zabbix.userid ** pode ser usada para recuperar dados.
Aliases podem ser utilizados no parâmetro // HostMetadataItem //, mas não no // HostnameItem //.
AllowRoot não 0 Permite que o agente rode como 'root'. Se desabilitada e o servidor for iniciado pelo 'root', o servidor tentará trocar para o usuário 'zabbix'. Não tem efeito se iniciado por um usuário normal.
0 - não permite
1 - permite
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 ou proxy se o buffer estiver cheio.
DebugLevel não 0-5 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)
5 - depuração estendida (atualmente igual ao nível 4, só podendo ser definida via opções de controle em tempo real).
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.
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 Lista, delimitada por vírgulas, de endereços IP onde o agente deve escutar.
Vários endereços IP são suportados desde o Zabbix 1.8.3.
ListenPort não 1024-32767 10050 O agente vai aguardar nesta porta por conexões do servidor.
LoadModule não Módulo para carregar na inicialização do agente. Os módulos são utilizados para estender a funcionalidade do agente
Formato: LoadModule = <module.so>
Os módulos devem estar localizados no diretório especificado pela LoadModulePath
É permitido incluir vários parâmetros LoadModule.
LoadModulePath não Caminho completo para localização de módulos do agente.
Padrão depende das opções de compilação.
LogFile não Nome do arquivo de log.
Se não for definido, o syslog é 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' e 'eventlog'.
O valor fornecido será subrescrito pelo parâmetro 'MaxLines' fornecido na chave de item "log" ou 'eventlog'
Nota//: O Zabbix irá processar quatro vezes mais novas linhas do que o definido em // MaxLinesPerSecond // para buscar a string necessária nos itens de log.
PidFile não /tmp/zabbix_agentd.pid Nome do arquivo com o PID.
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 IP endereço→ 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 especificado, colchetes para endereços IPv6 são opcionais \\. Se esse parâmetro não for especificado, as verificações ativas serão desativados.
SourceIP não Endereço IP de origem para as conexões de saída.
StartAgents não 0-100 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. Suportado desde o Zabbix 1.8.2.
User não Zabbix Reduz privilégios para um usuário específico existente no sistema.
Tem efeito somente se executado como 'root' e AllowRoot estiver desativado
Este parâmetro é suportado desde o ** Zabbix 2.4.0 **.
UserParameter não 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, who|wc -l

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)