Hermetry puede leer conmutadores, routers, SAI, servidores, impresoras y otros equipos con un agente SNMP. El poller de la plataforma pide al agente los OID que mapea el perfil de tu dispositivo y guarda las respuestas como telemetría y atributos del dispositivo. No se necesita ningún archivo MIB: asignas OID numéricos a claves.
Qué está soportado
| Elemento | Soporte |
|---|---|
| Versiones | SNMPv3 (recomendado) y SNMPv2c (desactivado hasta que un administrador del espacio de trabajo lo active) |
| Seguridad SNMPv3 | authPriv (por defecto) o authNoPriv; noAuthNoPriv no se ofrece |
| Autenticación SNMPv3 | SHA-256 (por defecto), SHA-512, SHA-384, SHA-224, SHA-1 (heredado) |
| Cifrado SNMPv3 | AES-128 |
| Dónde se ejecuta el poller | En la nube. El agente debe ser accesible en una dirección pública, directamente o a través de tu VPN o túnel. |
| Traps | No se reciben. La nube no tiene escucha de traps. |
| Sondeo in situ por una pasarela con licencia | En desarrollo |
| Archivos MIB | No se usan. Solo OID numéricos. |
Paso 1: crear el perfil
- En Perfiles de dispositivo, selecciona Nuevo perfil y elige SNMP como Transporte. La regla de conexión es Solo última vez vista.
- Abre la pestaña SNMP del perfil y construye el mapeo (paso 4). Las plantillas integradas en la referencia de plantillas SNMP muestran OID y claves listos para equipos habituales.
Paso 2: añadir el dispositivo y su endpoint
Añádelo con Dispositivos > Nuevo dispositivo > Dispositivo de red, elige el protocolo SNMP y un endpoint nuevo. Los pasos están en Endpoints de protocolo. Campos del endpoint SNMP:
| Campo | Por defecto | Notas |
|---|---|---|
| Agente | — | Nombre de host o dirección IP pública en la que la nube alcanza al agente |
| Puerto UDP | 161 | 1 a 65,535 |
| Versión SNMP | SNMPv3 (recomendado) | O SNMPv2c (comunidad en texto plano) |
| Comunidad | — | Solo v2c. Secreto, «Se envía en texto plano con cada solicitud.» |
| Usuario | — | Solo v3 |
| Nivel de seguridad | Autenticación y cifrado (authPriv) | O Solo autenticación (authNoPriv) |
| Autenticación | SHA-256 | Solo v3 |
| Contraseña de autenticación | — | Solo v3. Secreto, de al menos 8 caracteres |
| Cifrado | AES-128 | v3 con authPriv |
| Contraseña de cifrado | — | v3 con authPriv. Secreto, de al menos 8 caracteres |
| Nombre de contexto | vacío | Opcional. «La mayoría de los agentes usan el contexto vacío.» |
| Cómo llega la nube al agente | A través de una VPN o túnel (recomendado) | O Directamente por internet |
La prueba de conexión lee el grupo system (sysDescr, sysObjectID, sysUpTime, sysName). Un agente que no responde ni a sysUpTime ni a sysObjectID falla la prueba.
Avisos mostrados con una prueba (no la hacen fallar): «SNMPv2c: la cadena de comunidad viaja en texto plano.», «SNMPv2c directamente por internet: la cadena de comunidad la atraviesa en texto plano.», «authNoPriv: los mensajes están firmados pero no cifrados.», «La autenticación SHA-1 es heredada.»
Paso 3 (solo v2c): activar SNMPv2c
SNMPv2c envía su comunidad en claro, por lo que el sondeo v2c desde la nube está desactivado para todos los espacios de trabajo hasta que un administrador lo active. Guardar un endpoint v2c mientras está desactivado se rechaza: «El sondeo SNMPv2c desde la nube está desactivado para este espacio de trabajo. Usa SNMPv3, guarda el endpoint desactivado o pide a un administrador del espacio de trabajo que active v2c más abajo.»
- Debajo del rechazo, selecciona Activar SNMPv2c para este espacio de trabajo.
- Lee el aviso, marca «Entiendo que la cadena de comunidad viaja en texto plano.» y selecciona Activar.
- Guarda o vuelve a activar el endpoint. Activar v2c no activa por sí mismo ningún endpoint.
Un endpoint v2c con Directamente por internet también necesita su propia confirmación: «Entiendo que la cadena de comunidad atraviesa internet en texto plano».
Desactivar de nuevo el v2c en la nube desactiva a la vez todos los endpoints v2c del espacio de trabajo; su sondeo se detiene en la siguiente actualización del poller. Volver a activarlo más tarde no reactiva nada: activa cada endpoint de nuevo. Ambos cambios quedan registrados en el registro de auditoría.
Paso 4: asignar OID a claves
La pestaña SNMP del perfil, Mapeo SNMP, dice «Qué OID lee la plataforma de los dispositivos de este perfil y con qué claves los almacena.»
Valores (escalares): un OID, una clave, leídos en cada sondeo.
| Campo | Significado |
|---|---|
| OID | Numérico, por ejemplo 1.3.6.1.2.1.1.3.0 para sysUpTime.0 |
| Clave | Empieza por una letra; letras, dígitos y _ . : -, como máximo 96 caracteres |
| Se almacena como | Telemetría (una serie temporal) o Atributo (el último valor) |
| Tipo | Automático, Gauge / entero, Counter32, Counter64, TimeTicks (segundos), Texto, Enumeración, Dirección IP |
| Tasa por segundo | Para contadores: el cambio por segundo. La primera muestra tras un inicio se omite; se gestiona un desbordamiento de 32 bits. No para atributos. |
| Escala | Un multiplicador, por ejemplo 0.1 para convertir décimas en unidades. No 0. |
| Unidad | Como máximo 16 caracteres |
| Valores y sus etiquetas | Para una enumeración, uno por línea: 1=up. Como máximo 64 valores. |
Tablas: columnas recorridas. Cada fila de la tabla se convierte en una clave por columna, <clave>.<fila>.
| Campo | Significado |
|---|---|
| Nombre | Una etiqueta para ti (por ejemplo ifTable); no la usa la plataforma |
| Filas identificadas por | El índice de fila (el sufijo del OID) o El valor de otra columna (por ejemplo ifName, para que las claves se lean if.in_bps.eth0) |
| Límite de filas | De 1 a 256 filas, por defecto 64. Las filas adicionales se descartan y se notifican. |
| Columnas | De 1 a 16 columnas, cada una con los campos de valor anteriores. OID de columna es la columna sin el índice de fila. |
Ajustes de sondeo: Tiempo de espera (ms) de 200 a 10,000 (por defecto 2,000), Reintentos de 0 a 3 (por defecto 1), Filas por solicitud masiva de 1 a 50 (por defecto 10). «El intervalo de sondeo es el intervalo esperado del perfil»; consulta Intervalos de sondeo, retroceso y cuota.
Selecciona Guardar. El mapeo se comprueba antes de guardarse:
| Límite | Valor |
|---|---|
| Valores | 200 filas |
| Tablas | 8 |
| Claves de telemetría que puede producir un mapeo (todas las tablas llenas) | 200 por dispositivo |
| Atributos | 50 por dispositivo |
| OID o claves duplicados | No permitidos |
El editor muestra «Este mapeo produce hasta {telemetry} claves de telemetría y {attributes} atributos por dispositivo.» Reduce el límite de filas de una tabla o elimina columnas cuando se supere.
Eliminar un valor o una tabla deja de leerlo en el siguiente sondeo; el historial almacenado se conserva.
Sondeo de prueba
En la pestaña SNMP, Sondeo de prueba pide a un dispositivo de este perfil los OID con las credenciales almacenadas de su endpoint. No se guarda nada.
- Elige el Dispositivo (uno conectado a través de un endpoint SNMP).
- Elige Grupo system, Valores de este mapeo, o escribe OID (numéricos, uno por línea, como máximo el número mostrado).
- Selecciona Ejecutar sondeo de prueba. La respuesta lista OID, Tipo SNMP, Valor bruto y a qué se Asigna. Selecciona Añadir al mapeo en una fila para añadirla (guarda después).
Ejecutar un sondeo de prueba requiere el permiso para gestionar endpoints de protocolo. Los sondeos de prueba tienen límite de frecuencia («Demasiados sondeos de prueba. Inténtalo de nuevo en {seconds} s.»).
Traps
La lista Traps de la pestaña SNMP sirve para la asignación de traps en las pasarelas licenciadas en planta, que está en desarrollo. La nube no recibe traps. Para recibir alertas rápidamente, sondee los OID de estado correspondientes y añada una regla de alarma sobre sus claves.
Solución de problemas
| El sondeo de prueba indica | Solución |
|---|---|
| «El agente no respondió a tiempo (compruebe la dirección, el puerto y el cortafuegos o la VPN).» | Permita las direcciones del sondeador a UDP 161 (o a su puerto). |
| «Error de autenticación (compruebe el usuario y las claves).» | Usuario v3 o contraseña de autenticación incorrectos. |
| «El agente no pudo descifrar la solicitud (compruebe la contraseña de cifrado).» | Contraseña de cifrado incorrecta. |
| «El agente no conoce este usuario SNMPv3.» | Cree el usuario en el agente. |
| «El agente rechazó la solicitud por estar fuera de su ventana de tiempo.» | Vuelva a intentarlo; compruebe el reloj del agente. |
| «No such object» / «No such instance» | El agente no tiene ese OID. Compruebe el OID y el índice de fila. |
| «SNMPv2c desde la nube está desactivado para esta cuenta. Un administrador del espacio de trabajo puede activarlo.» | Consulte el paso 3. |