sysDescr 1.3.6.1.2.1.1.1.0  ///  sysUpTime 1.3.6.1.2.1.1.3.0  ///  sysName 1.3.6.1.2.1.1.5.0  ///  ifDescr 1.3.6.1.2.1.2.2.1.2  ///  ifOperStatus 1.3.6.1.2.1.2.2.1.8  ///  ifHCInOctets 1.3.6.1.2.1.31.1.1.1.6  ///  hrProcessorLoad 1.3.6.1.2.1.25.3.3.1.2  ///  enterprises 1.3.6.1.4.1  ///  linkDown 1.3.6.1.6.3.1.1.5.3  ///  UDP 161 · UDP 162  /// 
Manual
de campo
Rede · Monitoramento · Protocolo

SNMP &
o tal do OID

1iso
3org
6dod
1internet
2mgmt
1mib-2
1system
5sysName
0instância

Todo equipamento de rede guarda seus dados numa árvore numerada. O OID é o endereço de um dado nessa árvore. Este manual mostra como o protocolo funciona, como ler um OID e como achar o OID certo no seu equipamento.

Aprenda curso passo a passo,
com exercícios e simulador
→
01

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.

quem pergunta

Gerente

Zabbix, PRTG, LibreNMS, um script seu. Fica no seu computador ou servidor.
GET → UDP 161
← RESPONSE
← TRAP · UDP 162
quem responde

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.
02

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ãoComo autenticaCriptografiaQuando usar
v1Community (uma palavra em texto puro)NenhumaSó em equipamento antigo que não tem outra.
v2cCommunity (texto puro)NenhumaA mais comum em rede interna. Traz GetBulk e contadores de 64 bits.
v3Usuário e senha (MD5/SHA)DES/AESSempre que o tráfego sai da rede confiável.
Community é a "senha" das versões 1 e 2c. O padrão de fábrica costuma ser public (leitura) e private (escrita). Troque as duas.
03

Operações

São poucas. Com Get e GetNext você já faz quase tudo.

ler

Get

Pede o valor de um OID exato. Precisa do endereço completo, com o final.
ler

GetNext

Pede o próximo OID depois do informado. É assim que se descobre o que existe.
ler

GetBulk

Vários GetNext em um pacote só (v2c e v3). Muito mais rápido em tabelas.
escrever

Set

Altera um valor: nome, descrição de porta, desligar uma interface. Exige permissão de escrita.
aviso

Trap / Inform

O equipamento avisa sozinho (porta caiu, reiniciou). O Inform pede confirmação, o Trap não.
truque

Walk

Não é do protocolo. É a ferramenta repetindo GetNext até sair do ramo pedido. Lista tudo o que há embaixo.
04

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.

Raiz comum1.3.6.1iso.org.dod.internet. Igual em todo equipamento do mundo.
Ramo.2.1mgmt.mib-2, a parte padronizada.
Objeto.1.5system.sysName, o nome do equipamento.
Instância.0Qual exemplar. Aqui só existe um.

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.
05

A árvore, ao vivo

Clique nos ramos para abrir. À direita aparece o OID montado, o que ele significa e o comando para consultar.

06

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.

sempre igual

1.3.6.1

O começo de praticamente todo OID de SNMP. Nunca muda.
padrão mundial

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.
cada um faz o seu

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.
Regra prática: procure primeiro na MIB-2. Só desça ao ramo do fabricante quando o dado for específico do aparelho, como temperatura, nível de toner, sinal óptico ou carga da bateria.

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.

07

O final: .0 ou índice

A dúvida mais comum. O último número do OID diz qual exemplar do dado você quer.

escalar

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".
tabela

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:

ÍndiceifDescr · coluna 2ifOperStatus · coluna 8ifInOctets · 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
O índice nem sempre é 1, 2, 3. Pode pular números, e em algumas tabelas é composto: um IP (.192.168.0.1), um MAC ou dois números juntos. Descubra os índices com um walk na coluna de descrição, e não suponha a ordem.
08

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.

1

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"
2

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.

3

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
4

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
5

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
6

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.

7

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
09

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.

NomeOIDO que devolve
10

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.

11

Decodificador

Cole um OID. Cada número é explicado, do começo ao fim.

12

Tipos e contadores

O valor que volta tem um tipo. Dois deles pedem atenção na hora de fazer conta.

TipoO que éExemplo
INTEGERNúmero inteiro, muitas vezes um código (1 = up, 2 = down).ifOperStatus
OCTET STRINGTexto ou bytes (um MAC vem assim).sysDescr
OBJECT IDENTIFIERUm OID como valor.sysObjectID
Gauge32Valor que sobe e desce: velocidade, temperatura, uso.ifSpeed
Counter32Só cresce, e volta a zero ao chegar em 4.294.967.295.ifInOctets
Counter64Contador de 64 bits. Na prática não dá a volta.ifHCInOctets
TimeTicksTempo em centésimos de segundo.sysUpTime
IpAddressEndereç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. Prefira ifHCInOctets e ifHCOutOctets.
13

Erros comuns

MensagemCausa provávelO que fazer
Timeout: No ResponseSNMP 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 InstanceO objeto existe, mas o final está errado.Acrescente .0 ou o índice certo.
No Such ObjectO equipamento não tem esse OID.Faça um walk no ramo para ver o que ele oferece.
Unknown Object IdentifierVocê usou um nome e a MIB não está carregada.Use o OID numérico ou instale a MIB.
End of MIBO walk chegou ao fim da árvore.Não é erro. O ramo pedido acabou.
Authentication failureNa 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.

Só leitura

Para monitorar não é preciso escrita. Deixe o Set desligado.

Limite por IP

Aceite consultas só do servidor de monitoramento. Fora da rede interna, use v3.