CIRCUITO
CARIOCA TI · DOCUMENTAÇÃO
♙
Zabbix · Coleta

Monitoramento SNMP

SNMPv2c/v3, OIDs, MIBs, walk/get, descoberta e coleta eficiente para switches, roteadores, OLTs, rádios e UPS.

zabbix://snmp
$ branch: 7.4
$ topic: Monitoramento SNMP
$ mode: production
$ method: evidence-first_
SNMPv2c Simples e muito utilizado em redes internas controladas.
SNMPv3 Autenticação e, opcionalmente, criptografia.
OID Identificador do objeto que será consultado.
MIB Descrição estruturada dos objetos e seus nomes.
01 · CONCEITO

Como a coleta funciona

O equipamento executa um agente SNMP. O Zabbix Server ou Proxy consulta esse agente utilizando OIDs. O retorno pode representar estado operacional, descrição de interface, contadores de tráfego, temperatura, potência, CPU, memória ou qualquer informação disponibilizada pela MIB do fabricante.

Zabbix Server / Proxy → UDP 161 → Equipamento SNMP → OID → Valor
02 · VERSÕES

v2c ou v3?

SNMPv2c

Usa uma community como credencial. É simples, compatível com praticamente todo equipamento gerenciável e comum em redes de gerenciamento isoladas.

SNMPv3

Adiciona usuário, níveis de segurança, autenticação e privacidade. Para ambientes onde segurança é requisito, deve ser a primeira opção quando o equipamento oferece suporte adequado.

03 · TESTE

Teste antes de cadastrar no Zabbix

Instale as ferramentas Net-SNMP no servidor ou em uma estação de administração. Validar o equipamento fora do Zabbix separa problemas de rede/credencial dos problemas de configuração do próprio Zabbix.

# Debian / Ubuntu
apt install -y snmp

# Testar SNMPv2c
snmpwalk -v2c -c MINHA_COMMUNITY 192.0.2.10 .

# Consultar apenas sysName
snmpget -v2c -c MINHA_COMMUNITY 192.0.2.10 1.3.6.1.2.1.1.5.0
Não use public como community real de produção e não exponha UDP/161 indiscriminadamente. Restrinja a origem das consultas ao Zabbix Server/Proxy ou à rede de gerenciamento.
04 · OIDs E MIBs

O que realmente estamos consultando?

Um OID identifica um objeto na árvore SNMP. Alguns são padronizados e funcionam em fabricantes diferentes; outros ficam na árvore enterprise do fabricante. Para monitoramento de interfaces, IF-MIB e IF-MIB::ifXTable são especialmente importantes.

ObjetoOID / MIBUso
sysName1.3.6.1.2.1.1.5.0Nome do equipamento
sysUpTime1.3.6.1.2.1.1.3.0Tempo de atividade SNMP
ifDescr1.3.6.1.2.1.2.2.1.2Descrição da interface
ifOperStatus1.3.6.1.2.1.2.2.1.8Estado operacional
ifHCInOctets1.3.6.1.2.1.31.1.1.1.6Contador 64-bit de entrada
ifHCOutOctets1.3.6.1.2.1.31.1.1.1.10Contador 64-bit de saída
05 · ZABBIX

Cadastrar um equipamento SNMP

Em Data collection → Hosts, crie o host e adicione uma interface SNMP. Informe IP ou DNS, porta 161, versão e credenciais. Você pode vincular um template compatível ou criar os itens manualmente.

1
Criar host
2
Adicionar interface SNMP
3
Definir versão e credencial
4
Vincular template ou criar itens
5
Salvar
6
Validar Latest data
06 · SNMPv3

Segurança no SNMP

O Zabbix suporta os níveis noAuthNoPriv, AuthNoPriv e AuthPriv. Dependendo da biblioteca Net-SNMP instalada, há suporte a diferentes algoritmos de autenticação e privacidade.

# Exemplo conceitual de teste AuthPriv
snmpwalk -v3 \
  -l authPriv \
  -u USUARIO_SNMP \
  -a SHA \
  -A 'SENHA_AUTENTICACAO' \
  -x AES \
  -X 'SENHA_PRIVACIDADE' \
  192.0.2.10 .1.3.6.1.2.1.1

As opções precisam corresponder exatamente à configuração do equipamento. Em SNMPv3, credencial ou protocolo incorreto normalmente resulta em erro ou timeout.

07 · ITEM SNMP

Criando uma coleta manual

No host, crie um item do tipo SNMP agent. Nas versões atuais, get[OID] é indicado para buscar um valor e walk[OID] para percorrer uma árvore/tabela. Esses formatos trabalham de forma assíncrona e são preferíveis ao formato legado de OID único.

# Um valor
get[1.3.6.1.2.1.1.5.0]

# Uma tabela
walk[1.3.6.1.2.1.31.1.1.1]

# Vários ramos no mesmo walk
walk[ifDescr,ifType,ifPhysAddress]
08 · INTERFACES

Transformando contadores em tráfego

Os contadores ifHCInOctets e ifHCOutOctets são acumulativos. Para obter taxa, o item precisa de pré-processamento Change per second. Para exibir bits por segundo, multiplique o resultado por 8 ou configure o tratamento equivalente no template.

Counter64 → Change per second → × 8 → bit/s
09 · LOW-LEVEL DISCOVERY

Não cadastre 100 interfaces manualmente

A descoberta de baixo nível permite descobrir entidades SNMP e gerar automaticamente itens, triggers e gráficos a partir de protótipos. Em versões atuais, um item mestre walk[] pode coletar uma tabela e itens dependentes podem extrair os dados, reduzindo requisições repetidas.

# Exemplo de item mestre
walk[ifDescr,ifName,ifAlias,ifOperStatus,ifHCInOctets,ifHCOutOctets]
10 · REDES / ISP

O que vale monitorar

DisponibilidadeICMP + disponibilidade da interface SNMP.
InterfacesStatus administrativo/operacional, descrição, alias e velocidade.
TráfegoEntrada, saída, utilização percentual e capacidade.
ErrosErrors, discards e alterações anormais.
HardwareCPU, memória, temperatura, fontes e fans quando disponíveis.
ÓpticoTX/RX e alarmes quando a MIB do fabricante disponibilizar.
OLTUplinks, PONs, estados e métricas específicas da MIB do fabricante.
OperadorasAgrupe links por operadora e use dependências/correlação para distinguir falha massiva de falha isolada.
11 · FABRICANTES

Padronizado primeiro, vendor-specific depois

Cisco, MikroTik, Huawei, Datacom, Ubiquiti e fabricantes de OLT normalmente expõem parte das informações por MIBs padrão e parte por MIBs proprietárias. A melhor estratégia é usar IF-MIB e objetos padronizados para o básico e recorrer à árvore enterprise do fabricante somente para métricas específicas.

12 · TROUBLESHOOTING

Quando o SNMP fica vermelho

TimeoutTeste ping, rota, ACL/firewall, UDP 161 e se o agente SNMP está habilitado.
No responseConfirme versão SNMP, community/usuário e IP autorizado no equipamento.
No Such ObjectOID pode não existir naquele modelo, firmware ou contexto.
Valor estranhoVerifique tipo do dado, MIB, unidade, multiplicador e pré-processamento.
Tráfego incorretoPrefira contadores 64-bit em links rápidos e aplique Change per second.
SNMPv3 falhaConfira security name, nível, autenticação, privacidade e Engine ID.
13 · BOAS PRÁTICAS

Evite transformar SNMP em carga desnecessária

Use templates, macros e descoberta; escolha intervalos coerentes; prefira get[]/walk[] quando aplicável; aproveite itens dependentes; não monitore OIDs sem utilidade operacional; filtre interfaces irrelevantes; e teste o impacto antes de reduzir intervalos de coleta em centenas de equipamentos.

14 · GET[] E WALK[] ASSÍNCRONOS

No Zabbix 7.4, prefira a coleta SNMP moderna

A documentação oficial recomenda get[OID] para valor único e walk[OID1,OID2,...] para árvores/tabelas. Esses formatos são assíncronos e normalmente oferecem melhor escalabilidade que o OID síncrono legado. O número de SNMP pollers assíncronos é controlado por StartSNMPPollers, e a concorrência por poller pode chegar ao limite definido por MaxConcurrentChecksPerPoller.

15 · BULK REQUESTS

Reduza round trips sem sobrecarregar o equipamento

Em SNMPv2/v3, walk[] usa GetBulk para reduzir transmissões. O parâmetro Max repetitions da interface controla quantos OIDs podem retornar em uma resposta bulk. Valores muito altos podem provocar timeout em agentes SNMP frágeis; ajuste por família de equipamento.

16 · WALK + DEPENDENT ITEMS

Uma tabela SNMP pode alimentar dezenas de métricas

MASTER ITEM
walk[ifName,ifAlias,ifOperStatus,ifHCInOctets,ifHCOutOctets]

        │
        ├──► LLD de interfaces
        ├──► status por interface
        ├──► RX por interface
        ├──► TX por interface
        └──► alias / metadados

Benefício:
menos consultas SNMP repetidas
+ mesma fotografia temporal da tabela.
17 · CONTADORES DE 64 BITS

Links rápidos exigem IF-MIB::ifHC*

Para interfaces de alta velocidade, prefira ifHCInOctets e ifHCOutOctets (Counter64) quando suportados. Contadores de 32 bits podem dar wrap rapidamente em links rápidos. Para converter contador acumulado em taxa, adicione preprocessing Change per second.

18 · ÍNDICES DINÂMICOS

ifIndex é endereço da tabela, não identidade operacional

Índices podem mudar após reboot, atualização ou alteração de configuração. Sempre que possível, baseie a descoberta em atributos mais estáveis como ifName, ifAlias, serial ou identificadores do fabricante e use o índice apenas para endereçar a tabela.

19 · SNMPv3 ENGINE ID

Engine ID duplicado quebra a segurança e a coleta

Em SNMPv3, o snmpEngineID precisa ser único por dispositivo. Equipamentos que não persistem corretamente engineBoots podem ter mensagens descartadas como antigas após reboot. Em casos desse tipo, o Zabbix 7.4 oferece snmp_cache_reload no Server/Proxy para limpar o estado SNMP mantido em cache.

zabbix_server -R snmp_cache_reload
# ou
zabbix_proxy -R snmp_cache_reload
20 · COMBINED REQUESTS

Alguns dispositivos não lidam bem com requisições agrupadas

O Zabbix pode combinar checks SNMP compatíveis em uma mesma solicitação. Em equipamentos com implementação SNMP defeituosa, respostas parciais podem produzir erros ou até picos falsos em cálculos por segundo. A opção Use combined requests pode ser desabilitada por interface nesses casos. Os formatos assíncronos get[] e walk[] são uma alternativa moderna.

21 · TROUBLESHOOTING EM CAMADAS

Não comece pelo template

1. Rede UDP/161 alcançável a partir do Server/Proxy correto.
2. Versão v1, v2c ou v3 corresponde ao dispositivo.
3. Credencial Community ou security/auth/privacy válidos.
4. OID Objeto existe e é acessível nesse firmware/modelo.
5. Índice Entidade correta foi localizada.
6. Zabbix Item, interface, timeout e preprocessing corretos.
22 · REFERÊNCIAS TÉCNICAS

Base factual

Conteúdo revisado com base na documentação oficial Zabbix 7.4 sobre SNMP agent, SNMPv3, get[], walk[], requisições bulk, combined requests, SNMP cache e discovery de OIDs. Os exemplos de engenharia e recomendações operacionais são síntese editorial própria.

23 · PRÓXIMO PASSO

Organizar hosts e templates

Com SNMP funcionando, o próximo passo é estruturar grupos, hosts, macros, templates e herança para que o ambiente continue administrável quando passar de dezenas para centenas ou milhares de dispositivos.

Hosts e templates →
Atualização editorial 2026

Linha Zabbix 7.4

Na linha 7.4, walk[OID] e get[OID] usam processamento assíncrono e são recomendados sobre o formato OID legado para melhor escala; ajuste timeout e MaxConcurrentChecksPerPoller conforme o ambiente.

Recursos e limites sensíveis à versão devem ser confirmados contra o patch exato instalado antes de mudanças em produção.