Zabbix Documentation 4.0

3.04.04.45.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


pt:manual:config:items:itemtypes:snmp

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:snmp [2015/11/11 12:36]
spaww
pt:manual:config:items:itemtypes:snmp [2017/10/06 14:12] (current)
Line 39: Line 39:
   shell> snmpwalk -v 2c -c public <host IP> .   shell> snmpwalk -v 2c -c public <host IP> .
  
 +O '​2c'​ utilizado no comando se refere à versão do SNMP, caso seu dispositivo trabalhe, por exemplo, com a primeira versão do protocolo você pode substitui-lo por '​1',​ para indicar que o '​snmpwalk'​ deverá utilizar esta versão do protocolo. ​
  
-FIXME **This page is not fully translatedyetPlease help completing the translation.**\\ //(remove this paragraph once the translation is finished)//+Você deverá ter como resultado uma lista contendo os nomes dos OIDsseus tipos e último valor de cada umÉ possível que o nome de comunidade configurada no dispositivo seja outro que não o '​public',​ neste caso você deverá descobrir o nome correto e utiliza-lo
  
-As '​2c'​ here stands for SNMP versionyou may also substitute it with '​1'​to indicate SNMP Version 1 on the device.  +Você pode recorrer a esta lista para localizar qual nome de OID que você deseja monitorarpor exemplose você desejar monitorar o volume em bytes que é recebido pela terceira porta do dispositivovocê poderia utilizar o nome de OID ''​IF-MIB::​ifInOctets.3''​, conforme o exemplo a seguir:
- +
-This should give you a list of SNMP strings and their last value. If it doesn'​t then it is possible that the SNMP '​community'​ is different from the standard '​public'​ in which case you will need to find out what it is.  +
- +
-You can then go through the list until you find the string you want to monitore.g. if you wanted to monitor the bytes coming in to your switch on port 3 you would use the ''​IF-MIB::​ifInOctets.3'' ​string from this line:+
  
   IF-MIB::​ifInOctets.3 = Counter32: 3409739121   IF-MIB::​ifInOctets.3 = Counter32: 3409739121
  
-You may now use the **snmpget** ​command to find out the numeric ​OID for '​IF-MIB::​ifInOctets.3':​+Agora utilizaremos o comando ​**snmpget** ​para descobrir o número associado ao nome de OID selecionado ('​IF-MIB::​ifInOctets.3'​):
  
   shell> snmpget -v 2c -c public -On 10.62.1.22 IF-MIB::​ifInOctets.3   shell> snmpget -v 2c -c public -On 10.62.1.22 IF-MIB::​ifInOctets.3
  
-Note that the last number in the string is the port number you are looking to monitorSee also: [[pt:​manual:​config:​items:​itemtypes:​snmp:​dynamicindex|Dynamic indexes]].+Observe que o último número neste nome de OID é o número da porta que você deseja monitorarMais detalhes em [[pt:​manual:​config:​items:​itemtypes:​snmp:​dynamicindex|índices dinâmicos do SNMP]].
  
-This should give you something like the following:+O resultado do comando deve ser algo similar ao texto a seguir:
  
   .1.3.6.1.2.1.2.2.1.10.3 = Counter32: 3472126941   .1.3.6.1.2.1.2.2.1.10.3 = Counter32: 3472126941
  
-Againthe last number in the OID is the port number.+Novamenteo último número no OID é o número da porta. 
 + 
 +<​note>​Alguns fabricantes,​ como a 3COM, preferem nomear as suas portas começando no número 100, exemplos: porta 1 = porta 101, porta 3 = porta 103. A CISCO (e a maioria dos fornecedores) usa uma sequência simples, exemplo: ​port 3 = 3.</​note>​ 
 + 
 +<note tip>​Alguns dos OIDs mais utilziados são [[pt:​manual:​config:​items:​itemtypes:​snmp:​special_mibs|traduzidos automaticamente para a representação numérica]] de forma nativa no Zabbix.</​note>​
  
-<​note>​3COM seem to use port numbers in the hundredse.g. port 1 = port 101port 3 = port 103but Cisco use regular numbers, e.gport 3 = 3.</​note>​+No último exemplo o tipo do valor recebido é "​Counter32"​que corresponde internamente ao tipo ASN_COUNTERA lista completa de tipos suportados é: ASN_COUNTERASN_COUNTER64ASN_UINTEGERASN_UNSIGNED64,​ ASN_INTEGER,​ ASN_INTEGER64,​ ASN_FLOAT, ASN_DOUBLE, ASN_TIMETICKS,​ ASN_GAUGE, ASN_IPADDRESS,​ ASN_OCTET_STR ​ASN_OBJECT_ID (desde o Zabbix 2.2.8 ou 2.4.3). Estes tipos correspondem,​ respectivamente,​ à: "​Counter32",​ "​Counter64",​ "​UInteger32",​ "​INTEGER",​ "​Float",​ "​Double",​ "​Timeticks",​ "​Gauge32",​ "​IpAddress",​ "OCTET STRING",​ "​OBJECT IDENTIFIER"​ na saida do **snmpget**,​ mas também podem ser apresentados como "​STRING",​ "​Hex-STRING",​ "​OID"​ ou outro.
  
-<note tip>Some of the most used SNMP OIDs are [[pt:​manual:​config:​items:​itemtypes:​snmp:​special_mibs|translated automatically to a numeric representation]] by Zabbix.</​note>​+== Passo 3 ==
  
-In the last example above value type is "​Counter32",​ which internally corresponds to ASN_COUNTER type. The full list of supported types is ASN_COUNTER,​ ASN_COUNTER64,​ ASN_UINTEGER,​ ASN_UNSIGNED64,​ ASN_INTEGER,​ ASN_INTEGER64,​ ASN_FLOAT, ASN_DOUBLE, ASN_TIMETICKS,​ ASN_GAUGE, ASN_IPADDRESS,​ ASN_OCTET_STR and ASN_OBJECT_ID (since 2.2.8, 2.4.3). These types roughly correspond to "​Counter32",​ "​Counter64",​ "​UInteger32",​ "​INTEGER",​ "​Float",​ "​Double",​ "​Timeticks",​ "​Gauge32",​ "​IpAddress",​ "OCTET STRING",​ "​OBJECT IDENTIFIER"​ in **snmpget** output, but might also be shown as "​STRING",​ "​Hex-STRING",​ "​OID"​ and other, depending on the presence of a display hint. +Criar o item de monitoração.
-== Step 3 == +
-Create an item for monitoring.+
  
-So, now go back to Zabbix ​and click on //Items// for the SNMP host you created earlierDepending on whether you used a template ​or not when creating your host, you will have either ​list of SNMP items associated with your host or just an empty list. We will work on the assumption that you are going to create the item yourself using the information you have just gathered using snmpwalk ​and snmpget, so click on //Create ​item//​. ​In the new item formenter the item 'Name'. Make sure the '​Host ​interface' field has your switch/​router in it and change the '​Type'​ field to "​SNMPv* agent"Enter the community ​(usually ​public) ​and enter the textual or numeric ​OID that you retrieved earlier into the 'SNMP OID' fieldfor example: .1.3.6.1.2.1.2.2.1.10.3+Volte ao Zabbix ​e clique no link //Itens// da linha do Host SNMP que você criou mais cedoDependendo da associação que você fez, ou não fez, com algum template ​você poderá visualizar uma lista com ou sem itens. Neste tutorial estamos trabalhando assumindo que você criará manualmente os itens partir das informações conseguidas pelo 'snmpwalk' e 'snmpget'. Clique em //Criar item//​. ​No formulário de novo item, infomre o nome e se certifique que o campo 'Interface do host' ​está com a configuração da interface ​SNMP cadastradaInforme o nome de comunidade ​(normalmente 'public'e o número do OID que se deseja monitorarpor exemplo: .1.3.6.1.2.1.2.2.1.10.3
  
-Enter the SNMP '​Port'​ as 161 and the 'Key' ​as something meaningfule.g. SNMP-InOctets-Bps. ​Choose a custom multiplier if you want one and enter an 'Update interval' ​and 'History storage period' ​if you want them to be different from the padrão. ​Set the 'Type of information' ​to //Numeric ​(float)// and the 'Store value' ​to Delta (importantotherwise you will get cumulative values from the SNMP device instead of the latest change).+Infome a porta SNMP como sendo a 161 'chave' ​como algo significativopor exemplo: ​SNMP-InOctets-Bps. ​Informe o multiplicador que se deseja trabalhar, além de informar o 'Intervalo de atualizações' ​e o 'Período de retenção do histórico' ​se você desejar usar um valor diferente do padrão. ​Defina o 'Tipo de informação' ​para //Numérico ​(fracionário)// e o campo 'Armazenar valor' ​para "Delta (alterações por segundo)"​ (isso é importantesem esta configuração você terá o acumulado de valores e não é isso que se deseja).
  
-{{:manual:​config:​items:​itemtypes:​snmpv3_item.png|}}+{{manual:​config:​items:​itemtypes:​snmpv3_item.png|}}
  
-Now save the item and go to //Monitoring// -> //Latest data// for your SNMP data!+Agora salve o item e acesse ​//Monitoramento// -> //Dados recentes// para visualizar a coleta de dados!
  
-Take note of specific options available for SNMPv3 ​items:+Observe que existem opções específicas para o SNMPv3:
  
 ^Parâmetro^Descrição^ ^Parâmetro^Descrição^
-|//Context name//  |Enter context name to identify ​item on SNMP subnet.\\ //Context name// is supported for SNMPv3 items Desde o Zabbix 2.2.\\ ​User macros are resolved in this field.  |   +|//Nome do contexto//  |Informe o nome para identificar o item na subrede ​SNMP.\\ //Suportado desde o Zabbix 2.2.\\ ​Macros de usuário são aceitas neste campo.  |   
-|//Security name//  |Enter security name.\\ User macros are resolved in this field.  |  +|//Nome de segurança//  |Infomre o nome de segurança.\\ Macros de usuário são aceitas neste campo.  |  
-|//Security level// |Select security level:\\ **noAuthNoPriv** - no authentication nor privacy protocols are used\\ **AuthNoPriv** - authentication protocol is usedprivacy protocol is not\\ **AuthPriv** - both authentication and privacy protocols are used  |  +|//Nível de segurança// |Selecione o nível de segurança:\\ **noAuthNoPriv** - não será utilizado nenhum protocolo de privacidade ou autenticação\\ **AuthNoPriv** - protocolo de autenticação será utilizadode privacidade não\\ **AuthPriv** - ambos os protocolos serão utilizados ​ |  
-|//Authentication protocol//  |Select authentication protocol ​- //​MD5// ​or //​SHA//​. ​ |  +|//Protocolo de autenticação//  |Selecione o tipo de protocolo de autenticação ​- //​MD5// ​ou //​SHA//​. ​ |  
-|//Authentication passphrase//  |Enter authentication passphrase.\\ User macros are resolved in this field.  |  +|//Senha autenticação//  |Informe a frase de autenticação.\\ Macros de usuário são aceitas neste campo.  |  
-|//Privacy protocol//  |Select privacy protocol - //DES// or //​AES//​. ​ |  +|//Protocolo de privacidade//  |Select privacy protocol - //DES// or //​AES//​. ​ |  
-|//Privacy passphrase//  |Enter privacy passphrase.\\ User macros are resolved in this field.  | +|//Frase privada//  |Entre om a frase privada.\\ Macros de usuário são aceitas neste campo.  | 
  
-<​note>​Desde o Zabbix 2.2, SHA and AES protocols are supported for SNMPv3 ​authentication and privacyin addition to MD5 and DES supported before that.</​note>​+<​note>​Desde o Zabbix 2.2, os protocolos ​SHA AES são suportados para a autenticação e privacidade ​SNMPv3, ​em adição ao MD5 e ao DES que já eram suportados.</​note>​
  
-== Example ​1 ==+== Exemplo ​1 ==
  
-General example:+Exemplo geral:
  
 ^Parâmetro^Descrição^ ^Parâmetro^Descrição^
-|**Community**  |public ​  |  +|**Comunidade**  |public ​  |  
-|**OID** ​ |1.2.3.45.6.7.8.0 (or .1.2.3.45.6.7.8.0) ​ |  +|**SNMP OID**  |1.2.3.45.6.7.8.0 (ou .1.2.3.45.6.7.8.0) ​ |  
-|**Key**  |<Unique string to be used as reference to triggers>​\\ ​For example, ​"​my_param"​. ​ | +|**Chave**  |<Texto único que será utilizado como referência nas triggers>​\\ ​Por exemplo: ​"​my_param"​. ​ | 
  
-Note that OID can be given in either numeric or string formHoweverin some cases, string OID must be converted to numeric representation. Utility ​snmpget ​may be used for this purpose:+Observe que o **SNMP ​OID** poderá ser o número ou seu nomeEm alguns casos pode ser que o Zabbix não consiga resolver o número a partir do nomepara estas situações recomenda-se utilizar o 'snmpget' para fazer esta resolução antes de configurar o item:
  
   shell> snmpget -On localhost public enterprises.ucdavis.memory.memTotalSwap.0   shell> snmpget -On localhost public enterprises.ucdavis.memory.memTotalSwap.0
-Monitoring of SNMP Parâmetros is possible if <​nowiki>​--with-net-snmp</​nowiki> ​flag was specified while configuring Zabbix sources.+Monitoração através de SNMP só é possível se, durante a configuração do binário do Zabbix Server ou Zabbix Proxy, tiver sido utilizado o parâmetro ​<​nowiki>​--with-net-snmp</​nowiki>​.
  
-== Example ​2 ==+== Exemplo ​2 ==
  
-Monitoring of uptime:+Monitorando o tempo de carga (uptime):
  
 ^Parâmetro^Descrição^ ^Parâmetro^Descrição^
-|**Community**  |public ​  | +|**Comunidade**  |public ​  | 
-|**Oid**  |MIB::​sysUpTime.0 ​ | +|**SNMP OID**  |MIB::​sysUpTime.0 ​ | 
-|**Key**  |router.uptime ​ | +|**Chave**  |router.uptime ​ | 
-|**Value type**  |Float  | +|**Tipo de informação**  |Numérico (fracionário) ​ | 
-|**Units**  |uptime ​ | +|**Unidade**  |uptime ​ | 
-|**Multiplier**  |0.01  |+|**Multiplicador**  |0.01  |
  
-=== Internal workings of bulk processing ​===+=== Funcionamento interno do processamento em lote ===
  
-Starting from 2.2.3 Zabbix Server e Zabbix Proxy query SNMP devices for multiple values in single requestThis affects several types of SNMP items:+A partir do Zabbix ​2.2.3 os processos do Zabbix Server e Zabbix Proxy tem capacidade de solicitar vários dados através de SNMP em uma única requisiçãoEsta característica afeta diversos tipos de itens SNMP:
  
-  * regular ​SNMP items+  * itens SNMP normais
-  * [[pt:​manual:​config:​items:​itemtypes:​snmp:​dynamicindex|SNMP ​items with dynamic indexes]]; +  * [[pt:​manual:​config:​items:​itemtypes:​snmp:​dynamicindex|Itens SNMP com índice dinâmico]]; 
-  * [[pt:​manual:​discovery:​low_level_discovery#​discovery_of_snmp_oids|SNMP ​low-level discovery rules]].+  * [[pt:​manual:​discovery:​low_level_discovery#​discovery_of_snmp_oids|Regras de autobusca ​SNMP]].
  
-All SNMP items on a single interface with identical Parâmetros are scheduled to be queried at the same timeThe first two types of items are taken by pollers in batches of at most 128 items, whereas low-level discovery rules are processed individually, as before.+Todos os itens SNMP, com igual intervalo de coletas, são agendados para serem coletados juntosPara os primeiros dois tipos de itens a fila agrupa até 128 itens ao mesmo tempoenquanto ​as regras de autobusca são processadas de forma individual.
  
-On the lower levelthere are two kinds of operations performed for querying valuesgetting multiple specified objects and walking an OID tree.+No nível mais baixodois tipos de operações são feitas para obter os valoresobter múltiplos objetos e varrer árvore ​OID.
  
-For "getting", ​GetRequest-PDU ​is used with at most 128 variable bindingsFor "walking", ​GetNextRequest-PDU ​is used for SNMPv1 ​and GetBulkRequest ​with "​max-repetitions" ​field of at most 128 is used for SNMPv2 ​and SNMPv3.+Para a ação de "obtenção", ​uma requisição 'GetRequest-PDU' é utilizada com até 128 solicitaçõesPara a "varredura", ​uma requisição "GetNextRequest-PDU" será utilizada com o SNMPv1 ​e uma 'GetBulkRequest' com "​max-repetitions" ​definido como 128 será utilizada com  ​SNMPv2 ​SNMPv3.
  
-Thus, the benefits of bulk processing for each SNMP item type are outlined below:+Os benefícios de se utilizar o processamento em lote de grandes volumes de itens SNMP são listados a seguir:
  
-  * regular ​SNMP items benefit from "getting" ​improvements+  * itens SNMP normais se beneficiam de uma "obtenção" ​otimizada
-  * SNMP items with dynamic indexes benefit from both "getting" ​and "walking" ​improvements: "getting" ​is used for index verification and "walking" ​for building the cache; +  * itens SNMP com índices dinâmicos se beneficiam tanto da "obtenção" ​quanto da "varredura" ​otimizada: "obtenção" ​é utilizada para a verificação de índice e a "varredura" ​para construir o cache; 
-  * SNMP low-level discovery rules benefit from "walking" ​improvements.+  * regras de autobusca ​SNMP se beneficiam da melhoria na "varredura".
  
-Howeverthere is a technical issue that not all devices are capable of returning ​128 values per requestSome always return a proper response, but others either respond with a "tooBig(1)" ​error or do not respond at all once the potential response is over a certain limit.+Entretantoexistem limitações técnicas que fazem com que nem todos os dispositivos sejam capazes de retornar ​128 valores por requisiçãoAlgumas vezes o dispositivo pode retornar com mensagem ​"​(1) ​tooBig" ​ou não responder a todos uma vez que a quantidade é superior ao limite ​do equipamento.
  
-In order to find an optimal number of objects to query for a given device, Zabbix uses the following strategy. It starts cautiously with querying 1 value in a request. If that is successful, it queries 2 values in a request. If that is successful again, it queries 3 values in a request and continues similarly by multiplying the number of queried objects by 1.5, resulting in the following sequence of request sizes: 1, 2, 3, 4, 6, 9, 13, 19, 28, 42, 63, 94, 128.+Para definir o máximo de objetos para se solicitar a um dispositivo o Zabbix ​In order to find an optimal number of objects to query for a given device, Zabbix uses the following strategy: 
 +* A primeira requisição solicita ​valor apenas; 
 +* Se obteve sucessosolicita ​valores; 
 +* Se obteve sucessosolicita ​valores; 
 +* Se obteve sucessosolicita ​valores; 
 +Obtendo sucesso nas tentativas as próximas consultas requisitarãorespectivamente: ​6, 9, 13, 19, 28, 42, 63, 94, 128 (multiplicação do último valor bem sucedido por 1,5).
  
-However, once a device refuses to give proper response ​(for examplefor 42 variables), Zabbix ​does two things.+Uma vez que o dispositivo não consiga dar uma resposta adequada ​uma quantidade de itens simultâneos ​(por exemplo, 42 valores), Zabbix ​faz duas coisas.
  
-Firstfor the current item batch it halves the number of objects in a single request and queries ​21 variablesIf the device is alivethen the query should work in the vast majority of cases, because ​28 variables were known to work and 21 is significantly less than thatHoweverif that still failsthen Zabbix ​falls back to querying values one by oneIf it still fails at this pointthen the device is definitely not responding and request size is not an issue.+Primeiroele reduz o tamanho do lote que falhou pela metade (no caso 21)Se o dispositivo responder de forma adequadaserá feito o ajuste para 28 itens (fator anterior)Entretantose a falha persistirZabbix ​voltará a solicitar os itens 1 por 1Se o dispositivo voltar a falharo problema não será de quantidade de valores simultâneos.
  
-The second thing Zabbix does for subsequent item batches is it starts with the last successful number of variables ​(28 in our exampleand continues incrementing request sizes by until the limit is hitFor example, assuming the largest response size is 32 variables, the subsequent requests will be of sizes 29, 30, 31, 32, and 33. The last request will fail and Zabbix ​will never issue request of size 33 again. From that point on, Zabbix will query at most 32 variables for this device.+A segunda coisa que ele fará para os lotes de itens subsequentes é começar com o último número de valores obtidos com sucesso ​(28 em nosso exemploe continuará solicitando valores somando ​ao limite de requisições simultâneas até encontrar o limiteQuando descobrir o limite exato o Zabbix ​não mais fará estes testes e passará ​trabalhar somente com o limite descoberto neste dispositivo.
  
-If large queries fail with this number of variablesit can mean one of two thingsThe exact criteria that device uses for limiting response size cannot be knownbut we try to approximate that using the number of variablesSo the first possibility is that this number of variables is around the device'​s actual response size limit in the general case: sometimes response is less than the limitsometimes it is greater than that. The second possibility is that UDP packet in either direction simply got lostFor these reasonsif Zabbix ​gets failed queryit reduces the maximum number of variables to try to get deeper into the device'​s comfortable range, but (starting from 2.2.8) ​only up to two times.+Se grandes consultas falharem com esta quantidade de valores solicitadospode significar uma de duas coisasOs critérios exatos que o dispositivo utiliza para limitar ​quantidade de valores não pode ser descobertamas tentamos aproximar o valorAssim a primeira possibilidade é que este é o número de valores simultâneos que representa algo próximo do limite real pois, normalmente, a resposta é menor do que o limiteA segunda possibilidade é que um pacote UDPem qualquer direção, simplesmente se perdeu. Por estas razões o Zabbix ​considera que consulta falhou e reduz o limite de valores simultâneos para tentar trabalhar numa faixa mais confortável para o dispositivo mas, (a partir do 2.2.8) ​somente até duas tentativas.
  
-In the example aboveif a query with 32 variables happens to fail, Zabbix ​will reduce the count to 31. If that happens to failtoo, Zabbix will reduce the count to 30. However, Zabbix ​will not reduce the count below 30, because it will assume that further failures are due to UDP packets getting lost, rather than the device'​s limit.+No exemplo acimase uma consulta com 32 requisições simultâneas falharZabbix ​irá reduzir o contador para 31. Se falhar novamentereduz para 30. EntretantoZabbix ​não irá reduzir de 30 pois entenderá que a falha se deve a perda de pacotes ​UDP e não por limite do dispositivo.
  
-If, however, a device cannot handle bulk requests properly for other reasons and the heuristic described above does not workDesde o Zabbix 2.4 there is a "Use bulk requests" ​setting for each interface ​that allows to disable bulk requests for that device.+Se um dispositivo não conseguir trabalhar com requisições em lote por outras razõeseurística acima não funcionardesde o Zabbix 2.4 existe uma opção chamada ​"Usar requisições em lote" ​em cada interface ​que poderá ser desativada.