3 Capturador SNMP

Descripción general

Recibir traps SNMP es lo opuesto a consultar dispositivos habilitados para SNMP.

En este caso, la información es enviada desde un dispositivo habilitado para SNMP a snmptrapd y es recopilada o "atrapada" por el servidor Zabbix o el proxy Zabbix desde un archivo.

Normalmente, los traps se envían ante algún cambio de condición y el agente se conecta al servidor en el puerto 162 (a diferencia del puerto 161 en el lado del agente que se utiliza para consultas). El uso de traps puede detectar algunos problemas breves que ocurren entre el intervalo de consulta y que pueden pasar desapercibidos por los datos de consulta.

La recepción de traps SNMP en Zabbix está diseñada para funcionar con snmptrapd y uno de los mecanismos para pasar los traps a Zabbix: ya sea un script Bash o Perl o SNMPTT.

El flujo de trabajo para recibir un trap:

1. snmptrapd recibe un trap
2. snmptrapd pasa el trap al script receptor (Bash, Perl) o SNMPTT
3. El receptor analiza, formatea y escribe el trap en un archivo
4. El SNMP trapper de Zabbix lee y analiza el archivo de traps
5. Para cada trap, Zabbix encuentra todos los ítems "SNMP trapper" con interfaces de host que coinciden con la dirección del trap recibido. Tenga en cuenta que solo el "IP" o "DNS" seleccionado en la interfaz del host se utiliza durante la coincidencia.
6. Para cada ítem encontrado, el trap se compara con la expresión regular en snmptrap[regexp]. El trap se establece como el valor de todos los ítems coincidentes. Si no se encuentra ningún ítem coincidente y existe un ítem snmptrap.fallback, el trap se establece como el valor de este.
7. Si el trap no se estableció como valor de ningún ítem, Zabbix por defecto registra el trap no coincidente. (Esto se configura mediante "Registrar traps SNMP no coincidentes" en Administración > General > Otros.)

Notas sobre la conmutación por error de HA

Durante el cambio de nodo de alta disponibilidad (HA), Zabbix continuará procesando después del último registro dentro de la última marca de tiempo ISO 8601; Si no se encuentra el mismo registro, solo se utilizará la marca de tiempo para identificar la última posición.

Configuración de traps SNMP

Este tipo de elemento requiere la siguiente configuración en la interfaz.

1. Crear una interfaz SNMP para su host

• En Recopilación de datos > Hosts, cree/edite el host y, en el campo Interfaces, añada el tipo de interfaz "SNMP", especificando la dirección IP o DNS.
  
  La dirección de cada trap recibida se comparará con las direcciones IP y DNS de todas las interfaces SNMP para encontrar los hosts correspondientes.

2. Configurar el elemento

• En Recopilación de datos > Hosts, cree/edite el elemento necesario.
• En el campo Clave, utilice una de las claves de trap SNMP:

• Establezca el Tipo de información en "Registro" para que se analicen las marcas de tiempo. Otros formatos como "Numérico" también son aceptables, pero pueden requerir un manejador de traps personalizado.

1 Configuración de la supervisión de trampas SNMP

Configuración del servidor/proxy Zabbix

Para leer los traps, el servidor o proxy Zabbix debe configurarse para iniciar el proceso SNMP trapper y apuntar al archivo de traps que está siendo escrito por SNMPTT o un receptor de traps Bash/Perl. Para ello, edite el archivo de configuración (zabbix_server.conf o zabbix_proxy.conf):

StartSNMPTrapper=1
       SNMPTrapperFile=[ARCHIVO DE TRAPS]

Configuración del receptor de traps Bash

Requisitos: solo snmptrapd.

Se puede utilizar un script receptor de traps Bash para pasar traps al servidor Zabbix desde snmptrapd usando el archivo trapper. Para configurarlo, agregue la opción traphandle al archivo de configuración de snmptrapd (snmptrapd.conf), vea el ejemplo.

Configuración del receptor de capturas de Perl

Requisitos: Perl, Net-SNMP compilado con --enable-embedded-perl (hecho por defecto desde Net-SNMP 5.4)

Un receptor de trampas Perl (busque misc/snmptrap/zabbix_trap_receiver.pl) se puede utilizar para pasar trampas al servidor Zabbix directamente desde snmptrapd. A configurarlo:

• agregue el script Perl al archivo de configuración snmptrapd (snmptrapd.conf), por ejemplo:

perl hacer "[RUTA COMPLETA AL SCRIPT DEL RECEPTOR PERL]";

• configurar el receptor, por ejemplo:

$SNMPTrapperFile = '[ARCHIVO TRAMPA]';
       $DateTimeFormat = '[FORMATO DE FECHA Y HORA]';

Los modificadores de expresiones regulares "/l" y "/a" son mutuamente excluyentes en (eval 2) línea 1, al final de la línea
       El modificador Regexp "/l" no puede aparecer dos veces en (eval 2) línea 1, al final de la línea

Configuración de SNMPTT

Al principio, snmptrapd debe configurarse para utilizar SNMPTT.

Cuando SNMPTT esté configurado para recibir las capturas, configure snmptt.ini:

1. habilite el uso del módulo Perl del paquete NET-SNMP:

net_snmp_perl_enable = 1

2. registre las trampas en el archivo de trampas que Zabbix leerá:

log_enable = 1
       log_file = [ARCHIVO TRAMPA]

3. establezca el formato de fecha y hora:

formato_fecha_hora = %Y-%m-%dT%H:%M:%S%z

::: nota de advertencia El paquete "net-snmp-perl" se eliminó en RHEL 8.0-8.2; Se volvió a agregar en RHEL 8.3. Para obtener más información, consulte el conocido problemas. :::

Ahora formatee las trampas para que Zabbix las reconozca (edite snmptt.conf):

1. Cada instrucción FORMAT debe comenzar con "ZBXTRAP [dirección]", donde [dirección] se comparará con las direcciones IP y DNS de SNMP interfaces en Zabbix. P.ej.:

EVENTO coldStart .1.3.6.1.6.3.1.1.5.1 "Eventos de estado" Normal
       FORMAT ZBXTRAP $aA Dispositivo reinicializado (inicio en frío)

2. Vea más sobre el formato de captura SNMP a continuación.

::: nota importante No utilices trampas desconocidas: Zabbix no podrá reconocerlas. Las trampas desconocidas se pueden manejar definiendo un evento general en snmptt.conf:

EVENTO general .* "Evento general" Normal

:::

Formato de captura SNMP

Todos los receptores de capturas Perl personalizados y la configuración de capturas SNMPTT deben formatee la trampa de la siguiente manera:

[marca de tiempo] [la trampa, parte 1] ZBXTRAP [dirección] [la trampa, parte 2]

dónde

• [timestamp] - la marca de tiempo en formato "%Y-%m-%dT%H:%M:%S%z"
• ZBXTRAP - encabezado que indica que una nueva trampa comienza en esta línea
• [dirección] - Dirección IP utilizada para encontrar el host para esta trampa

Tenga en cuenta que "ZBXTRAP" y "[dirección]" se eliminarán del mensaje. durante el procesamiento. Si la trampa tiene otro formato, Zabbix podría analizar las trampas inesperadamente.

Trampa de ejemplo:

2024-01-11T15:28:47+0200 .1.3.6.1.6.3.1.1.5.3 Localhost normal de "Eventos de estado" - ZBXTRAP 192.168.1.1 Enlace inactivo en la interfaz 2. Estado de administrador: 1. Estado operativo: 2

Esto dará como resultado la siguiente trampa para la interfaz SNMP con IP=192.168.1.1:

2024-01-11T15:28:47+0200 .1.3.6.1.6.3.1.1.5.3 "Eventos de estado" normales
       localhost - Enlace inactivo en la interfaz 2. Estado de administración: 1. Estado operativo: 2

Requisitos del sistema

Compatibilidad con archivos grandes

Zabbix tiene "soporte de archivos grandes" para archivos de captura SNMP. El tamaño máximo de archivo que Zabbix puede leer es 2^63 (8 EiB). Tenga en cuenta que el sistema de archivos puede imponer un límite inferior en el tamaño del archivo.

Rotación de registros

Zabbix no proporciona ningún sistema de rotación de registros; eso debe manejarse por el usuario La rotación de registros primero debe cambiar el nombre del archivo antiguo y solo luego elimínelo para que no se pierdan trampas:

1. Zabbix abre el archivo de captura en la última ubicación conocida y va a paso 3
2. Zabbix verifica si el archivo actualmente abierto ha sido rotado por comparando el número de inodo con el número de inodo del archivo trap definido. Si no hay ningún archivo abierto, Zabbix restablece la última ubicación y va al paso 1.
3. Zabbix lee los datos del archivo abierto actualmente y establece el nueva ubicacion.
4. Los nuevos datos se analizan. Si este fue el archivo girado, el archivo es cierra y vuelve al paso 2.
5. Si no hubo datos nuevos, Zabbix duerme durante 1 segundo y vuelve al paso 2.

Sistema de archivos

Debido a la implementación del archivo trampa, Zabbix necesita que el sistema de archivos soportar inodos para diferenciar archivos (la información es adquirida por un llamada stat()).

Ejemplos de configuración utilizando diferentes versiones del protocolo SNMP

Este ejemplo utiliza snmptrapd y un script receptor en Bash para pasar traps al servidor Zabbix.

Configuración:

1. Configure Zabbix para iniciar el receptor de traps SNMP y establezca el archivo de traps. Añada a zabbix_server.conf:

StartSNMPTrapper=1
       SNMPTrapperFile=/var/lib/zabbix/snmptraps/snmptraps.log

2. Descargue el script Bash en /usr/sbin/zabbix_trap_handler.sh:

curl -o /usr/sbin/zabbix_trap_handler.sh https://raw.githubusercontent.com/zabbix/zabbix-docker/7.0/Dockerfiles/snmptraps/alpine/conf/usr/sbin/zabbix_trap_handler.sh

Si es necesario, ajuste la variable ZABBIX_TRAPS_FILE en el script. Para usar el valor por defecto, cree primero el directorio padre:

mkdir -p /var/lib/zabbix/snmptraps

3. Añada lo siguiente a snmtrapd.conf (consulte el ejemplo funcional)

traphandle default /bin/bash /usr/sbin/zabbix_trap_handler.sh

4. Cree un ítem SNMP TEST (tenga en cuenta los requisitos de configuración iniciales):
   

   Tipo: SNMP trap
   Tipo de información: Log Interfaz del host: SNMP 127.0.0.1
   Clave: snmptrap["linkUp"]
   Formato de hora del log: yyyyMMdd.hhmmss

Tenga en cuenta que se utiliza el formato de fecha y hora ISO 8601.

5. A continuación, configuraremos snmptrapd para la versión del protocolo SNMP elegida y enviaremos traps de prueba utilizando la utilidad snmptrap.

SNMPv1, SNMPv2

Los protocolos SNMPv1 y SNMPv2 se basan en la autenticación mediante "community string". En el ejemplo siguiente usaremos "secret" como community string. Debe establecerse el mismo valor en los emisores de traps SNMP.

Tenga en cuenta que, aunque todavía se utiliza ampliamente en entornos de producción, SNMPv2 no ofrece ningún cifrado ni autenticación real del emisor. Los datos se envían como texto plano y, por lo tanto, estas versiones del protocolo solo deben usarse en entornos seguros, como redes privadas, y nunca deben usarse en redes públicas o de terceros.

La versión 1 de SNMP ya no se utiliza realmente hoy en día, ya que no admite contadores de 64 bits y se considera un protocolo heredado.

Para habilitar la aceptación de traps SNMPv1 o SNMPv2 debe añadir la siguiente línea a snmptrapd.conf. Sustituya "secret" por la community string SNMP configurada en los emisores de traps SNMP:

authCommunity log,execute,net secret

A continuación, podemos enviar un trap de prueba utilizando snmptrap. Usaremos el OID común "link up" en este ejemplo:

snmptrap -v 2c -c secret localhost '' linkUp.0

SNMPv3

SNMPv3 resuelve los problemas de seguridad de SNMPv1/v2 y proporciona autenticación y cifrado. Puede utilizar los métodos de autenticación MD5 o múltiples SHA y DES/múltiples AES como cifrado.

Para habilitar la aceptación de SNMPv3 añada las siguientes líneas a snmptrapd.conf:

createUser -e 0x8000000001020304 traptest SHA mypassword AES
       authuser log,execute traptest

snmptrap -v 3 -n "" -a SHA -A mypassword -x AES -X mypassword -l authPriv -u traptest -e 0x8000000001020304 localhost 0 linkUp.0

Verificación

En ambos ejemplos verá líneas similares en su /var/lib/zabbix/snmptraps/snmptraps.log:

2024-01-30T10:04:23+0200 ZBXTRAP 127.0.0.1
       UDP: [127.0.0.1]:56585->[127.0.0.1]:162
       DISMAN-EVENT-MIB::sysUpTimeInstance = 2538834
       SNMPv2-MIB::snmpTrapOID.0 = IF-MIB::linkUp.0

El valor del ítem en Zabbix será:

2024-01-30 10:04:23 2024-01-30 10:04:21 
       
       2024-01-30T10:04:21+0200 UDP: [127.0.0.1]:56585->[127.0.0.1]:162
       DISMAN-EVENT-MIB::sysUpTimeInstance = 2538834
       SNMPv2-MIB::snmpTrapOID.0 = IF-MIB::linkUp.0

Ejemplo con Perl:

2024-01-30T11:42:54+0200 ZBXTRAP 127.0.0.1
       PDU INFO:
         receivedfrom                   UDP: [127.0.0.1]:58649->[127.0.0.1]:162
         notificationtype               TRAP
         version                        1
         community                      public
         errorstatus                    0
         transactionid                  1
         requestid                      2101882550
         messageid                      0
         errorindex                     0
       VARBINDS:
         DISMAN-EVENT-MIB::sysUpTimeInstance type=67 value=Timeticks: (457671) 1:16:16.71
         SNMPv2-MIB::snmpTrapOID.0      type=6  value=OID: IF-MIB::linkUp.0

Ver también

• Artículo del blog de Zabbix sobre capturas SNMP
• Configuración de snmptrapd (documentación oficial de net-snmp)
• Configuración de snmptrapd para recibir notificaciones SNMPv3 (documentación oficial de net-snmp)