Skip to main content

​
SNMP

A integração SNMP lê e escreve valores em qualquer dispositivo que tenha um agente SNMP, nas versões v1, v2c e v3. É baseada nas plataformas snmp do Home Assistant, mas toda a configuração é feita pela interface e já vem com perfis prontos para nobreaks. Ela serve para:
  • Nobreaks APC/Schneider com Network Management Card e modelos que seguem a UPS-MIB (RFC 1628), como Eaton, NHS, SMS e Vertiv;
  • Switches e roteadores, por exemplo para acompanhar uptime, tráfego e status de portas;
  • Impressoras, PDUs e sensores de ambiente: qualquer valor exposto por OID.
Roda apenas em um edge local (home). O agente SNMP responde em UDP 161 na rede local, então o edge precisa estar na mesma rede do dispositivo.

​
Configurar

1

Adicione a integração

Vá em Configurações → Integrações → Adicionar → SNMP e selecione um edge local.
2

Conexão

Informe Nome, Host, Porta (padrão 161), Versão e, em v1/v2c, a Community (padrão public). Escolha um Perfil e o Intervalo de leitura, que por padrão é de 30 segundos.
3

Credenciais SNMPv3 (opcional)

Em v3, informe usuário, protocolo de autenticação (MD5, SHA, SHA-2) e protocolo de privacidade (DES, AES-128 ou AES-256), junto com as chaves. Cada chave precisa ter no mínimo 8 caracteres.
4

Entidades

O Portal testa a conexão e mostra o nome e o modelo do dispositivo. Nesse passo você pode adicionar entidades por OID, e cada OID é lido na hora para confirmar que existe. Também dá para concluir e usar apenas as entidades do perfil.
Quando a community ou as credenciais estão erradas, o SNMP não devolve erro: o dispositivo simplesmente não responde. Por isso, um timeout geralmente significa community, versão ou porta incorretas, ou SNMP desabilitado no dispositivo.

​
Perfis

Cada modelo expõe só uma parte dos OIDs do perfil, então o Portal cria apenas as entidades que respondem na primeira leitura. Os botões do perfil APC só funcionam com uma community de escrita ou um usuário v3 com permissão de escrita.

​
Habilitar o SNMP na Network Management Card da APC

  1. Acesse a interface web da placa (http://<ip-do-nobreak>).
  2. Abra Configuration → Network → SNMPv1 → Access e marque Enable SNMPv1 access. Para v3, use SNMPv3 → Access.
  3. Em SNMPv1 → Access Control, configure uma community com acesso Read (ou Write+ para os botões) e o NMS IP/Host Name do edge. Também é possível usar 0.0.0.0 para permitir qualquer origem.
  4. Salve. Algumas versões de firmware pedem reiniciar a placa (Control → Network → Reboot Management Interface).

​
Tipos de entidade

Os OIDs usam a notação numérica, por exemplo 1.3.6.1.2.1.1.3.0. Nomes da MIB como SNMPv2-MIB::sysUpTime.0 não são aceitos. Valores escalares quase sempre terminam em .0. O tipo do valor escrito segue a RFC 1902 (Integer, Unsigned32, Gauge32, Counter32, Counter64, TimeTicks, OctetString, IpAddress, ObjectIdentifier). O padrão é Integer, como no Home Assistant. Cada entidade expõe nos atributos o host, o oid e, quando há tradução, o raw_value (valor cru) e as options possíveis.

​
Limitações

  • Sem switch.toggle: use switch.turn_on e switch.turn_off.
  • Sem templates: no lugar dos templates Jinja do Home Assistant, use multiplicador, deslocamento, casas decimais e tradução de valores.
  • Sem traps: o Portal consulta o dispositivo no intervalo configurado.
  • Se o dispositivo ficar inacessível, todas as entidades passam a unavailable até a próxima leitura bem-sucedida.

​
Reconfigurar

Em Configurações → Integrações → SNMP → Reconfigurar é possível alterar host, porta, versão, credenciais, perfil e intervalo, além de adicionar ou remover entidades manuais. Deixe os campos de community e chaves em branco para manter os valores atuais. As entidades mantêm o mesmo ID mesmo se o host mudar, e as que saírem da configuração são removidas automaticamente.