Templates SNMP
Um Template SNMP é o catálogo de sensores de um tipo de equipamento — a lista de OIDs que o Sentinela sabe consultar (tráfego por interface, uptime, CPU, status de porta, temperatura etc.). Você cria o template uma vez e depois vincula ao dispositivo (no cadastro ou pelo botão Editar da tela de SNMP); na hora de adicionar sensores, o Sentinela usa o template como cardápio.
Layout da tela
Duas colunas: à esquerda a lista de templates e as ações; à direita o editor do template selecionado.
Coluna esquerda
- + Novo template: começa um template em branco (já preenche um exemplo no editor).
- 📥 Importar (JSON/YAML/XML): converte um arquivo externo (ex.: exportação de outra ferramenta) em template. O sistema pré-processa e mostra quantos sensores foram convertidos para você revisar antes de salvar.
- 🔎 Buscar template: filtra a lista por nome ou fabricante.
- Lista: cada item mostra o nome, a etiqueta do fabricante (se houver) e a quantidade de sensores. Clique para editar.
Coluna direita (editor)
- Nome: identificação do template (ex.: Mikrotik RouterBoard).
- Fabricante (opcional): ex.:
mikrotik— ajuda a filtrar e a sugerir por vendor. - Sensores (JSON): o corpo do template, editável como texto.
- Prévia: logo abaixo do JSON, mostra em "chips" os sensores reconhecidos e o tipo de cada um. Se o JSON estiver inválido, aparece o erro em vermelho.
- 🗑 Excluir (aparece só ao editar um existente), 🔄 Reprocessar (após uma importação que falhou), e Salvar template.
Estrutura do JSON de sensores
O JSON tem a forma { "sensors": [ ... ] }. Campos de cada sensor:
| Campo | Para que serve |
|---|---|
key | Identificador único do sensor dentro do template (ex.: traffic, uptime). |
name | Nome amigável exibido na tela. |
kind | Tipo: traffic (tráfego), status (UP/DOWN), uptime, gauge (valor), counter. |
per_iface | true quando o sensor é por interface — aí você escolhe as portas na hora de adicionar. |
oid | OID único (sensores de valor simples). Ex.: uptime = 1.3.6.1.2.1.1.3.0. |
oid_in / oid_out | OIDs de entrada/saída para tráfego (ex.: contadores de 64 bits de bytes in/out por interface). |
unit | Unidade exibida (ex.: bps, %, °C, s). |
Passo a passo
Criar um template
- Clique em + Novo template (o editor carrega um exemplo com tráfego + uptime).
- Preencha Nome e, se quiser, Fabricante.
- Ajuste o JSON dos sensores (use a prévia para conferir).
- Clique em Salvar template. A mensagem ✓ Salvo confirma.
Importar de arquivo
- Clique em 📥 Importar e selecione o .json/.yaml/.yml/.xml.
- O sistema converte e mostra N sensor(es) convertidos — revise. Se falhar, ajuste o conteúdo no editor e clique em 🔄 Reprocessar.
- Confira a prévia e clique em Salvar template.
Como usar o template depois
Com o template salvo, vá ao cadastro do dispositivo (ou use ✏️ Editar no painel da tela de SNMP) e selecione esse template. Na tela de SNMP, ao clicar em Adicionar, o Sentinela consulta o equipamento e oferece os sensores do template — inclusive as interfaces reais para os sensores per_iface.
Dicas e avisos:
- OIDs errados fazem o sensor ficar sem dados (bloco vermelho). Confira os OIDs com o fabricante ou com um snmpwalk antes de distribuir o template.
- Para tráfego, prefira os contadores de 64 bits (ifHC…) — os de 32 bits estouram rápido em links de alta capacidade e distorcem o gráfico.
- Alterar o JSON de um template já em uso afeta os novos sensores adicionados; sensores já criados nos dispositivos não mudam sozinhos.
- 🗑 Excluir um template não remove os sensores já criados nos dispositivos, mas você perde o cardápio para adicionar novos com ele.