Zabbix Documentation 5.2

3.04.05.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.24.4Guidelines

User Tools

Site Tools


pt:manual:config:items:itemtypes:snmptrap

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
pt:manual:config:items:itemtypes:snmptrap [2015/11/13 18:23]
spaww
pt:manual:config:items:itemtypes:snmptrap [2019/10/07 06:35] (current)
Line 74: Line 74:
 == Configurando o ''​Perl trap receiver''​ == == Configurando o ''​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:
 +  * adicione o script perl no arquivo de configuração do '​snmptrapd'​ (snmptrapd.conf),​ Exemplo:\\ perl do %%"​[FULL PATH TO PERL RECEIVER SCRIPT]"​%%;​
 +  * configure o recebedor, exemplo:\\ $SNMPTrapperFile = '[TRAP FILE]';​\\ $DateTimeFormat = '[DATE TIME FORMAT]';​
  
-FIXME **This page is not fully translated, yet. Please help completing the translation.**\\ //(remove this paragraph once the translation is finished)//​ +<note tip>Se o nome do script ​não estiver entre aspassnmptrapd ​irá se recusar a iniciar com mensagens similares a estas:
- +
-Requirements:​ Perl, Net-SNMP compiled with %%--%%enable-embedded-perl (done by default since Net-SNMP 5.4)\\ \\ Perl trap receiver (look for misc/​snmptrap/​zabbix_trap_receiver.pl) can be used to pass traps to Zabbix server directly from snmptrapd. To configure it: +
-  * add the perl script to snmptrapd configuration file (snmptrapd.conf),​ e.g.:\\ perl do %%"​[FULL PATH TO PERL RECEIVER SCRIPT]"​%%;​ +
-  * configure the receiver, e.g:\\ $SNMPTrapperFile = '[TRAP FILE]';​\\ $DateTimeFormat = '[DATE TIME FORMAT]';​ +
- +
-<note tip>If script ​name is not quoted, snmptrapd ​will refuse to start up with messages, similar to these:+
   Regexp modifiers "/​l"​ and "/​a"​ are mutually exclusive at (eval 2) line 1, at end of line   Regexp modifiers "/​l"​ and "/​a"​ are mutually exclusive at (eval 2) line 1, at end of line
   Regexp modifier "/​l"​ may not appear twice at (eval 2) line 1, at end of line   Regexp modifier "/​l"​ may not appear twice at (eval 2) line 1, at end of line
 </​note>​ </​note>​
-== SNMP trap format == 
-All customised perl trap receivers and SNMPTT trap configuration must format the trap in the following way: 
-**[timestamp] [the trap, part 1] ZBXTRAP [address] [the trap, part 2]**, where 
-  * [timestamp] - timestamp used for log items 
-  * ZBXTRAP - header that indicates that a new trap starts in this line 
-  * [address] - IP address used to find the host for this trap 
-Note that "​ZBXTRAP"​ and "​[address]"​ will be cut out from the message during processing. If the trap is formatted otherwise, Zabbix might parse the traps unexpectedly. \\ \\ Example 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\\ This will result in the following trap for SNMP interface with 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.  ​ 
  
 +== Formato do SNMP trap ==
 +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
 +  * [timestamp] - momento de ocorrência do evento
 +  * ZBXTRAP - cabeçalho que indica o início de uma nova linha de trap
 +  * [address] - endereço IP para localizar o host a receber a trap
 +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.  ​
 +
 +=== - Requerimentos de sistema ===
 +
 +== Rotação de logs ==
 +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 Zabbix abre o arquivo de traps na última posição conhecida e vai para o passo 3
 +  - O Zabbix verifica se o arquivo aberto já foi rotacionado ao comparar o número do inode definido para o mesmo. Se não existe arquivo aberto, o Zabbix reseta a informação de última posição conhecida e retorna ao passo 1.
 +  - O Zabbix lê o dado do arquivo aberto e define uma nova localização.
 +  - Os novos dados são analisados. Se era o arquivo rotacionado,​ o arquivo é fechado e retorna ao passo 2.
 +  - Se não existe novo dado, o Zabbix aguarda 1 segundo e retorna ao passo 2.
  
-=== - System requirements ===+<note important>​O tamanho máximo de um arquivo de log para o Zabbix é de 2GB. O arquivo de log precisa ser rotacionado antes deste limite.</​note>​
  
-== Log rotation ​== +== Sistema de arquivos ​== 
-Zabbix ​does not provide any log rotation system - that should be handled by the user. The log rotation should first rename the old file and only later delete it so that no traps are lost:\\ +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()''​).
-  - Zabbix opens the trap file at the last known location and goes to step 3 +
-  - Zabbix checks if the currently opened file has been rotated by comparing the inode number to the define trap file's inode number. If there is no opened file, Zabbix resets the last location and goes to step 1. +
-  - Zabbix reads the data from the currently opened file and sets the new location. +
-  - The new data are parsed. If this was the rotated file, the file is closed and goes back to step 2. +
-  - If there was no new data, Zabbix sleeps for 1 second and goes back to step 2.+
  
-<note important>​The maximum log file size supported by Zabbix ​is 2 gigabytesThe log file must be rotated before reaching this limit.</note>+=== - Exemplo de configuração === 
 +Este exemplo utiliza o snmptrapd + SNMPTT para enviar traps ao Zabbix ​Server: 
 +  - **zabbix_server.conf** - configure o Zabbix para iniciar o SNMP trapper e defina a localização do arquivo ​file:\\ StartSNMPTrapper=1\\ SNMPTrapperFile=/​tmp/​my_zabbix_traps.tmp 
 +  - **snmptrapd.conf** - adicione o SNMPTT como o gerenciador de traps:\\ traphandle default snmptt 
 +  - **snmptt.ini** - configure o arquivo de saída e o formato de hora:\\ log_file = /​tmp/​my_zabbix_traps.tmp\\ date_time_format = %H:%M:%S %Y/%m/%d 
 +  - **snmptt.conf** - defina o formato padrão de trap: \\ EVENT general .* %%"​General event"​%% Normal\\ FORMAT ZBXTRAP $aA $ar 
 +  - Crie um item SNMP TEST:\\ IP da Interface SNMP do Host IP: 127.0.0.1\\ Chave: %%snmptrap["​General"​]%%\\ Formato de hora do log: hh:mm:ss yyyy/MM/dd
  
-== File system == +Teste o funcionamento:​
-Because of the trap file implementation,​ Zabbix needs the file system to support inodes to differentiate files (the information is acquired by a stat() call).+
  
-=== Setup example === +  ​Comando utilizado para enviar uma trap:\\ snmptrap -v 1 -c public 127.0.0.1 '​.1.3.6.1.6.3.1.1.5.3'​ '​0.0.0.0'​ 6 33 '​55'​ .1.3.6.1.6.3.1.1.5.3 ​ s "​teststring000"​ 
-This example uses snmptrapd + SNMPTT to pass traps to Zabbix server. Setup: +  - Que será recebida:\\ 15:48:18 2011/07/26 .1.3.6.1.6.3.1.1.5.3.0.33 Normal %%"​General event"​%% localhost - ZBXTRAP 127.0.0.1 127.0.0.1 
-  - **zabbix_server.conf** - configure Zabbix to start SNMP trapper and set the trap file:\\ StartSNMPTrapper=1\\ SNMPTrapperFile=/​tmp/​my_zabbix_traps.tmp +  - Valor par ao teste do item:\\ 15:48:18 2011/07/26 .1.3.6.1.6.3.1.1.5.3.0.33 Normal %%"​General event"​%% localhost - 127.0.0.1 
-  - **snmptrapd.conf** - add SNMPTT as the trap handler:\\ traphandle default snmptt +<note tip>Este exemplo simples utiliza o SNMPTT ​como **traphandle**. ​Para melhor ​performance ​em ambientes de produçãoutilize um script ​Perl para encaminhar as traps do snmptrapd ​ao SNMPTT ​ou diretamente ao Zabbix.</​note>​
-  - **snmptt.ini** - configure output file and time format:\\ log_file = /​tmp/​my_zabbix_traps.tmp\\ date_time_format = %H:%M:%S %Y/%m/%d +
-  - **snmptt.conf** - define a default trap format: \\ EVENT general .* %%"​General event"​%% Normal\\ FORMAT ZBXTRAP $aA $ar +
-  - Create an SNMP item TEST:\\ Host's SNMP interface IP: 127.0.0.1\\ Key: %%snmptrap["​General"​]%%\\ Log time format: hh:mm:ss yyyy/​MM/​dd +
-This results in: +
-  - Command used to send a trap:\\ snmptrap -v 1 -c public 127.0.0.1 '​.1.3.6.1.6.3.1.1.5.3'​ '​0.0.0.0'​ 6 33 '​55'​ .1.3.6.1.6.3.1.1.5.3 ​ s "​teststring000"​ +
-  - The received trap:\\ 15:48:18 2011/07/26 .1.3.6.1.6.3.1.1.5.3.0.33 Normal %%"​General event"​%% localhost - ZBXTRAP 127.0.0.1 127.0.0.1 +
-  - Value for item TEST:\\ 15:48:18 2011/07/26 .1.3.6.1.6.3.1.1.5.3.0.33 Normal %%"​General event"​%% localhost - 127.0.0.1 +
-<note tip>This simple example uses SNMPTT ​as **traphandle**. ​For better ​performance ​on production systemsuse embedded ​Perl to pass traps from snmptrapd ​to SNMPTT ​or directly to Zabbix.</​note>​+