O que é SNMP
SNMP (Simple Network Management Protocol) é a língua que roteadores, switches, impressoras, nobreaks e servidores usam para contar como estão. Um programa pergunta, o equipamento responde.
Gerente
Zabbix, PRTG, LibreNMS, um script seu. Fica no seu computador ou servidor.Agente
Um pequeno serviço dentro do equipamento. Ele lê os dados e devolve o valor do OID pedido.MIB
O dicionário. Um arquivo de texto que dá nome e descrição a cada OID. Sem a MIB o SNMP funciona igual, você só vê números.OID
O endereço de um dado. Uma sequência de números separados por ponto, lida da esquerda para a direita.Portas
UDP 161 para perguntas e respostas.UDP 162 para avisos (traps) que o equipamento manda sozinho.Versões
Três versões em uso. A árvore de OIDs é a mesma nas três. O que muda é a segurança e a eficiência.
| Versão | Como autentica | Criptografia | Quando usar |
|---|---|---|---|
| v1 | Community (uma palavra em texto puro) | Nenhuma | Só em equipamento antigo que não tem outra. |
| v2c | Community (texto puro) | Nenhuma | A mais comum em rede interna. Traz GetBulk e contadores de 64 bits. |
| v3 | Usuário e senha (MD5/SHA) | DES/AES | Sempre que o tráfego sai da rede confiável. |
public (leitura) e private (escrita). Troque as duas.Operações
São poucas. Com Get e GetNext você já faz quase tudo.
Get
Pede o valor de um OID exato. Precisa do endereço completo, com o final.GetNext
Pede o próximo OID depois do informado. É assim que se descobre o que existe.GetBulk
Vários GetNext em um pacote só (v2c e v3). Muito mais rápido em tabelas.Set
Altera um valor: nome, descrição de porta, desligar uma interface. Exige permissão de escrita.Trap / Inform
O equipamento avisa sozinho (porta caiu, reiniciou). O Inform pede confirmação, o Trap não.Walk
Não é do protocolo. É a ferramenta repetindo GetNext até sair do ramo pedido. Lista tudo o que há embaixo.O que é o OID
OID quer dizer Object Identifier. Pense num endereço: país, cidade, rua, número. Cada número do OID desce um nível na árvore, da esquerda para a direita.
Duas escritas, mesmo dado
1.3.6.1.2.1.1.5.0
iso.org.dod.internet.mgmt.mib-2.system.sysName.0
SNMPv2-MIB::sysName.0
O equipamento só entende os números. Os nomes vêm da MIB, no seu computador.
Ordem de leitura
O agente guarda tudo em ordem numérica, número por número.1.3.6.1.2.1.1.9 vem antes de 1.3.6.1.2.1.2. É por isso que o GetNext consegue percorrer a árvore inteira sem conhecer nada antes.A árvore, ao vivo
Clique nos ramos para abrir. À direita aparece o OID montado, o que ele significa e o comando para consultar.
Existe um padrão?
Sim, até certo ponto. A árvore tem três zonas, e só as duas primeiras seguem uma sequência igual para todos.
1.3.6.1
O começo de praticamente todo OID de SNMP. Nunca muda.1.3.6.1.2.1
A MIB-2. Nome, tempo ligado, interfaces, tráfego, IP. O mesmo OID serve num Cisco, num MikroTik e numa impressora.1.3.6.1.4.1.N
O ramo do fabricante.N é o número dele. Daí para baixo, cada empresa organiza do jeito dela.Dentro do ramo do fabricante não há sequência universal. Dois modelos da mesma marca podem até usar sub-ramos diferentes. O que existe é o costume de dividir em produtos (identifica o modelo) e mibs (os dados), e o fabricante publica isso num arquivo de MIB.
O final: .0 ou índice
A dúvida mais comum. O último número do OID diz qual exemplar do dado você quer.
Dado único → termina em .0
O equipamento tem um nome só, então ésysName.0. Sem o .0 o Get falha com "No Such Instance".Dado repetido → termina no índice
Há várias interfaces, então cada uma tem um número.ifDescr.3 é a descrição da interface de índice 3.Uma tabela SNMP é lida por coluna. O formato é sempre tabela . entrada(1) . coluna . índice:
| Índice | ifDescr · coluna 2 | ifOperStatus · coluna 8 | ifInOctets · coluna 10 |
|---|---|---|---|
| 1 | …2.2.1.2.1 = "lo" | …2.2.1.8.1 = 1 (up) | …2.2.1.10.1 |
| 2 | …2.2.1.2.2 = "ether1" | …2.2.1.8.2 = 1 (up) | …2.2.1.10.2 |
| 3 | …2.2.1.2.3 = "ether2" | …2.2.1.8.3 = 2 (down) | …2.2.1.10.3 |
Achar o OID do seu equipamento
O caminho que funciona para qualquer marca. Os comandos são do pacote Net-SNMP (Linux, macOS e Windows). Troque public e o IP pelos seus.
Confirme que o SNMP responde
Leia o ramo system. Se voltar texto, a comunicação está certa.
$ snmpwalk -v2c -c public 192.168.0.1 1.3.6.1.2.1.1 .1.3.6.1.2.1.1.1.0 = STRING: "RouterOS RB750Gr3" .1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.14988.1 .1.3.6.1.2.1.1.5.0 = STRING: "roteador-sala"
Leia o sysObjectID: ele diz quem fabricou
O valor de 1.3.6.1.2.1.1.2.0 já é um OID, e aponta para dentro do ramo do fabricante. No exemplo, 1.3.6.1.4.1.14988 é a MikroTik. Esse é o ramo onde ficam os dados exclusivos do aparelho.
Liste tudo o que o fabricante publica
Faça um walk no ramo dele e guarde num arquivo. Use -On para ver números em vez de nomes.
$ snmpbulkwalk -v2c -c public -On 192.168.0.1 1.3.6.1.4.1.14988 > fabricante.txt $ snmpbulkwalk -v2c -c public -On 192.168.0.1 1.3.6.1 > tudo.txt # a árvore inteira
Procure pelo valor, não pelo nome
Você sabe o que quer ver: a temperatura é 47, o nível de toner é 80, o nome da porta é "sfp1". Procure esse valor no arquivo. A linha que tiver o valor mostra o OID.
$ grep -i "sfp1" tudo.txt # Linux / macOS > findstr /i "sfp1" tudo.txt # Windows
Sem valor conhecido? Compare antes e depois
Salve um walk, mude algo no equipamento (desconecte um cabo, imprima uma página, ligue uma carga) e salve outro. As linhas que mudaram são os OIDs daquele dado.
$ snmpbulkwalk -v2c -c public -On 192.168.0.1 1.3.6.1 > antes.txt # ... mude algo no equipamento ... $ snmpbulkwalk -v2c -c public -On 192.168.0.1 1.3.6.1 > depois.txt $ diff antes.txt depois.txt # Windows: fc antes.txt depois.txt
Baixe a MIB do fabricante para ter os nomes
O site do fabricante costuma ter um pacote de MIBs do modelo. Com ela carregada, os números viram nomes e cada OID ganha descrição e unidade.
$ snmptranslate -On SNMPv2-MIB::sysName.0 # nome → número .1.3.6.1.2.1.1.5.0 $ snmptranslate -Td .1.3.6.1.2.1.1.5 # número → descrição completa $ snmptranslate -Tp -m ALL .1.3.6.1.4.1.14988 # desenha a árvore do fabricante
Prefere tela em vez de terminal? Um MIB Browser faz o mesmo com cliques: abre a árvore, mostra a descrição e consulta o equipamento.
Confirme com um Get
Com o OID em mãos, teste direto. Lembre do final: .0 para dado único, o índice para linha de tabela.
$ snmpget -v2c -c public 192.168.0.1 1.3.6.1.2.1.1.5.0 $ snmpget -v3 -l authPriv -u monitor -a SHA -A "senhaAuth" -x AES -X "senhaPriv" 192.168.0.1 1.3.6.1.2.1.1.5.0
OIDs mais usados
Todos da parte padronizada, então valem para a maioria dos equipamentos. Os que terminam em .x são colunas de tabela: troque o x pelo índice.
| Nome | OID | O que devolve |
|---|
Fabricantes
Cada empresa recebe um número (PEN, Private Enterprise Number) na IANA. Ele vem logo depois de 1.3.6.1.4.1. A lista completa é pública, no registro "Private Enterprise Numbers" da IANA.
Decodificador
Cole um OID. Cada número é explicado, do começo ao fim.
Tipos e contadores
O valor que volta tem um tipo. Dois deles pedem atenção na hora de fazer conta.
| Tipo | O que é | Exemplo |
|---|---|---|
| INTEGER | Número inteiro, muitas vezes um código (1 = up, 2 = down). | ifOperStatus |
| OCTET STRING | Texto ou bytes (um MAC vem assim). | sysDescr |
| OBJECT IDENTIFIER | Um OID como valor. | sysObjectID |
| Gauge32 | Valor que sobe e desce: velocidade, temperatura, uso. | ifSpeed |
| Counter32 | Só cresce, e volta a zero ao chegar em 4.294.967.295. | ifInOctets |
| Counter64 | Contador de 64 bits. Na prática não dá a volta. | ifHCInOctets |
| TimeTicks | Tempo em centésimos de segundo. | sysUpTime |
| IpAddress | Endereço IPv4. | ipAdEntAddr |
Tráfego não vem pronto
O contador guarda o total de bytes desde que ligou. Para ter a velocidade, leia duas vezes e faça a conta:
bits/s = (leitura2 − leitura1) × 8 ÷ segundos
Link rápido? Use 64 bits
Em 1 Gbit/s um Counter32 dá a volta em cerca de 34 segundos, e o gráfico sai errado. PrefiraifHCInOctets e ifHCOutOctets.Erros comuns
| Mensagem | Causa provável | O que fazer |
|---|---|---|
| Timeout: No Response | SNMP desligado, community errada, firewall ou IP sem permissão. | Ative o SNMP, confira a community e libere a UDP 161 para o seu IP. |
| No Such Instance | O objeto existe, mas o final está errado. | Acrescente .0 ou o índice certo. |
| No Such Object | O equipamento não tem esse OID. | Faça um walk no ramo para ver o que ele oferece. |
| Unknown Object Identifier | Você usou um nome e a MIB não está carregada. | Use o OID numérico ou instale a MIB. |
| End of MIB | O walk chegou ao fim da árvore. | Não é erro. O ramo pedido acabou. |
| Authentication failure | Na v3: usuário, senha ou algoritmo diferentes do equipamento. | Confira nível (authPriv), SHA/MD5 e AES/DES. |
Troque a community
public é a primeira que qualquer scanner tenta.