O fluxo de comunicação de uma 'trap SNMP' é o inverso do de uma coleta.
Para este tipo de item o dispositivo monitorado inicia a comunicação enviando um 'trap' que é coletado pelo processo 'Zabbix Trapper' que está presente o Zabbix Server e no Zabbix Proxy.
Normalmente as 'traps' são enviadas quando determinada condição ocorre, a partir desta mudança o Agente SNMP se conecta ao servidor SNMP (no caso o Zabbix Trapper) usando a porta 162 (para as consultas SNMP é utilizada a porta 161). Usando 'traps' você poderá detectar problemas logo que ocorrerem, sem ter que aguardar uma eventual fila de coletas.
O recebimento de 'traps SNMP' no zabbix foi desenvolvido para funcionar em conjunto com o snmptrapd chamando um script perl ou SNMPTT.
O 'workflow' de um recebimento de trap:
". (Que pode ser habilitado através da opção "Registrar traps SNMP não correspondentes" disponível em Administração
→ Geral
→ Outros
.)
A configuração dos campos a seguir é específica para itens deste tipo:
Em Configuração → Hosts, no campo Interface do Host defina uma interface com o IP ou DNS correto. O endereço de cada trap recebida é comparada com o IP ou com o DNS de todas as interfaces SNMP para localizar os hosts correspondentes.
Utilize uma das chaves de trap SNMP no campo Chave do item:
Chave | ||
---|---|---|
Descrição | Valor retornado | Comentários |
snmptrap[regexp] | ||
Captura qualquer trap SNMP que corresponda com um endereço definido pela expressão regular informada no campo regexp | Trap SNMP | Este item só pode ser definido em interfaces SNMP. Este item é suportado desde o Zabbix 2.0.0. Observação: A partir do Zabbix 2.0.5, macros de usuário e expressões globais são suportadas para este tipo de item. |
snmptrap.fallback | ||
Captura todas as traps SNMP de um determinado IP que não tenha sido recebida por nenhum item snmptrap[] daquela interface | Trap SNMP | Este item só pode ser definido em interfaces SNMP. Este item é suportado desde o Zabbix 2.0.0. |
Expressões regulares de várias linhas não são suportadas neste momento.
Defina o Tipo da informação para 'Log' para que os registros de hora sejam processados. Observe que qualquer outro formato, tal qual o numérico, também são aceitáveis mas requerem um gerenciador de trap personalizado.
Para a monitoração de trap SNMP, você primeiro deverá configura-la.
Para receber as traps, o Zabbix Server/Proxy deverá estar configurado para iniciar o processo de SNMP trapper e apontado para o arquivo de traps que estará sendo alimentado pelo SNMPTT ou pelo 'perl trap receiver'. Para fazer isso, edite o arquivo de configuração (zabbix_server.conf ou zabbix_proxy.conf):
Se o parâmetro do systemd PrivateTmp tiver sido definido é improvável que funcione no /tmp.
Primeiramente o 'snmptrapd' precisa estar configurado para utilizar o SNMPTT.
Para uma melhor performance, o SNMPTT precisa estar configurado como um daemon utilizando o snmptthandler-embedded para enviar as traps. Veja mais intruções sobre configuração do SNMPTT neste endereço:
http://snmptt.sourceforge.net/docs/snmptt.shtml
Quando o SNMPTT estiver apto a receber as 'traps', ajuste-o para registrar as traps:
Agora formate as traps de forma a possibilitar que o Zabbix as reconheça (edite o arquivo snmptt.conf):
Não utilize traps 'não esperadas' - o Zabbix não estará apto a reconhece-las. Traps não esperadas podem ser tratadas ao definir um evento geral no snmptt.conf
:
EVENT general .* "General event" Normal
Perl trap receiver
Requerimentos: Perl, pacote Net-SNMP compilado com --enable-embedded-perl (já é padrão no Net-SNMP 5.4)
'Perl trap receiver' (olhe em misc/snmptrap/zabbix_trap_receiver.pl) poderá ser utilizado para encaminhar as traps para o Zabbix Server/Proxy diretamente a partir do snmptrapd. Para configurar:
Se o nome do script não estiver entre aspas, o snmptrapd irá se recusar a iniciar com mensagens similares a estas:
Tanto os 'perl trap receivers' quanto o 'SNMPTT trap configuration' precisam formatar a trap conforme o padrão a seguir: [timestamp] [the trap, part 1] ZBXTRAP [address] [the trap, part 2], onde
Observe que o "ZBXTRAP" e o "[address]" serão removidos da mensagem durante o processamento. Se a trap utilizar outro formato, o Zabbix pode analisa-las de forma inesperada.
Exemplo de trap:
11:30:15 2011/07/27 .1.3.6.1.6.3.1.1.5.3 Normal "Status Events" localhost - ZBXTRAP 192.168.1.1 Link down on interface 2. Admin state: 1. Operational state: 2
Esta trap será enviada para um host com a interface SNMP com IP=192.168.1.1:
11:30:15 2011/07/27 .1.3.6.1.6.3.1.1.5.3 Normal "Status Events" localhost - Link down on interface 2. Admin state: 1.
O Zabbix não provê rotação de logs que possa ser gerida pelo usuário. A rotação de logs primeiro irá renomear o arquivo antigo e após isso apaga-lo para garantir que nenhuma trap será perdida, conforme processo a seguir:
O tamanho máximo de um arquivo de log para o Zabbix é de 2GB. O arquivo de log precisa ser rotacionado antes deste limite.
Devido à forma de implementação, o Zabbix precisa que o sistema de arquivos suporte inodes para diferenciar os arquivos (a informação é obtida através da função stat()
).
Este exemplo utiliza o snmptrapd + SNMPTT para enviar traps ao Zabbix Server:
Teste o funcionamento:
Este exemplo simples utiliza o SNMPTT como traphandle. Para melhor performance em ambientes de produção, utilize um script Perl para encaminhar as traps do snmptrapd ao SNMPTT ou diretamente ao Zabbix.