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