Una de las cosas que más me interesa monitorizar son las impresoras, tanto para llevar un control histórico del gasto como para recibir avisos de que queda poca tinta/tóner e ir encargando con repuestos tiempo. Para las impresoras HP y Epson que tenemos en los centros ya hay templates de monitorización que han compartido los compañeros, pero tengo por mi parte varias impresoras Brother láser color (DCP-9020CDW, HL-4140CN y alguna más) para las cuales el número de templates que se encuentran es bastante escaso. En la página de templates oficial de Zabbix aparecen apenas 3 plantillas, todas para láser monocromo, que se pueden importar (algunas con errores que hay que corregir editando a mano XML, pues son un poco antiguas), pero no nos dan toda la información que queremos sobre las impresoras láser en color.
Me ha tocado investigar un poco para crear una plantilla mezcla de las 3 existentes más items nuevos para obtener los datos que faltaban. Esta es la parte divertida de nuestro trabajo, no todo iba a ser azotar usuarios. No ha sido todo nuevo, puesto que las impresoras son interrogadas usando el protocolo SNMP y ya tenía experiencia al haberlo utilizado hace bastante tiempo para otra entrada del blog.
AVISO: tochazo inside.
1. Uso de snmpwalk para interrogar impresoras.
Para preguntar sobre toda la información que comparte de forma pública una impresora usamos el comando:
# snmpwalk -v 2c -c public 172.a.b.c
iso.3.6.1.2.1.1.1.0 = STRING: "Brother NC-8500h, Firmware Ver.1.15 (15.10.15),MID 8CE-403,FID 2"
iso.3.6.1.2.1.1.2.0 = OID: iso.3.6.1.4.1.2435.2.3.9.1
iso.3.6.1.2.1.1.3.0 = Timeticks: (9993270) 1 day, 3:45:32.70
iso.3.6.1.2.1.1.4.0 = STRING: "contacto@gmail.es"
iso.3.6.1.2.1.1.5.0 = STRING: "BN_SALAPROFESORES"
iso.3.6.1.2.1.1.6.0 = STRING: "Sala de Profesores"
iso.3.6.1.2.1.1.7.0 = INTEGER: 72
iso.3.6.1.2.1.1.8.0 = Timeticks: (0) 0:00:00.00
iso.3.6.1.2.1.1.9.1.2.1 = OID: iso.3.6.1.6.3.1
iso.3.6.1.2.1.1.9.1.2.2 = OID: iso.3.6.1.6.3.10.3.1.1
iso.3.6.1.2.1.1.9.1.2.3 = OID: iso.3.6.1.6.3.11.3.1.1
iso.3.6.1.2.1.1.9.1.2.4 = OID: iso.3.6.1.6.3.15.2.1.1
iso.3.6.1.2.1.1.9.1.2.5 = OID: iso.3.6.1.6.3.16.2.1.1
iso.3.6.1.2.1.1.9.1.3.1 = STRING: "The MIB Module from SNMPv2 entities"
iso.3.6.1.2.1.1.9.1.3.2 = STRING: "SNMP Management Architecture MIB"
iso.3.6.1.2.1.1.9.1.3.3 = STRING: "Message Processing and Dispatching MIB"
iso.3.6.1.2.1.1.9.1.3.4 = STRING: "USM User MIB"
iso.3.6.1.2.1.1.9.1.3.5 = STRING: "VACM MIB"
.......................
.......................
.......................
Literalmente: "The physical location of this node (e.g., 'telephone closet, 3rd floor'). If the location is unknown, the value is the zero-length string", es decir, la ubicación física de la impresora tal como está definida en su configuración. El valor de este campo se obtiene con:
# snmpwalk -v 2c -c public 172.a.b.c iso.3.6.1.2.1.1.6
iso.3.6.1.2.1.1.6.0 = STRING: "Sala de Profesores"
2. Problemática con las impresoras Brother.
Hasta aqui todo sería estupendo si todas las impresoras respetasen los OID estándar. Con las HP y las Epson no hay problema, pero mis Brother son rebeldes. La mayoría de los OID (ubicación, status, páginas impresas, número de serie, etc) se ajustan al estándar definido y vale el mismo template que para cualquier otra impresora, pero aquellos que deben decirme el nivel de tóner restante mienten o son inexactos.
El estado de los consumibles se encuentra en la rama iso.3.6.1.2.1.43.11, prtMarkerSupplies. Vamos a husmear dentro (añado comentarios explicando el significado de las ramas):
# snmpwalk -v 2c -c public 172.19.231.51 iso.3.6.1.2.1.43.11
iso.3.6.1.2.1.43.11.1.1.2.1.1 = INTEGER: 1 --- prtMarkerSuppliesMarkerIndex(2)
iso.3.6.1.2.1.43.11.1.1.2.1.2 = INTEGER: 1
iso.3.6.1.2.1.43.11.1.1.2.1.3 = INTEGER: 1
iso.3.6.1.2.1.43.11.1.1.2.1.4 = INTEGER: 1
iso.3.6.1.2.1.43.11.1.1.2.1.5 = INTEGER: 1
iso.3.6.1.2.1.43.11.1.1.2.1.6 = INTEGER: 1
iso.3.6.1.2.1.43.11.1.1.2.1.7 = INTEGER: 1
iso.3.6.1.2.1.43.11.1.1.2.1.8 = INTEGER: 1
iso.3.6.1.2.1.43.11.1.1.2.1.9 = INTEGER: 1
iso.3.6.1.2.1.43.11.1.1.2.1.10 = INTEGER: 1
iso.3.6.1.2.1.43.11.1.1.3.1.1 = INTEGER: 1 --- prtMarkerSuppliesColorantIndex(3)
iso.3.6.1.2.1.43.11.1.1.3.1.2 = INTEGER: 2
iso.3.6.1.2.1.43.11.1.1.3.1.3 = INTEGER: 3
iso.3.6.1.2.1.43.11.1.1.3.1.4 = INTEGER: 4
iso.3.6.1.2.1.43.11.1.1.3.1.5 = INTEGER: 0
iso.3.6.1.2.1.43.11.1.1.3.1.6 = INTEGER: 0
iso.3.6.1.2.1.43.11.1.1.3.1.7 = INTEGER: 0
iso.3.6.1.2.1.43.11.1.1.3.1.8 = INTEGER: 0
iso.3.6.1.2.1.43.11.1.1.3.1.9 = INTEGER: 0
iso.3.6.1.2.1.43.11.1.1.3.1.10 = INTEGER: 0
iso.3.6.1.2.1.43.11.1.1.4.1.1 = INTEGER: 3 --- prtMarkerSuppliesClass(4)
iso.3.6.1.2.1.43.11.1.1.4.1.2 = INTEGER: 3
iso.3.6.1.2.1.43.11.1.1.4.1.3 = INTEGER: 3
iso.3.6.1.2.1.43.11.1.1.4.1.4 = INTEGER: 3
iso.3.6.1.2.1.43.11.1.1.4.1.5 = INTEGER: 4
iso.3.6.1.2.1.43.11.1.1.4.1.6 = INTEGER: 3
iso.3.6.1.2.1.43.11.1.1.4.1.7 = INTEGER: 3
iso.3.6.1.2.1.43.11.1.1.4.1.8 = INTEGER: 3
iso.3.6.1.2.1.43.11.1.1.4.1.9 = INTEGER: 3
iso.3.6.1.2.1.43.11.1.1.4.1.10 = INTEGER: 3
iso.3.6.1.2.1.43.11.1.1.5.1.1 = INTEGER: 3 --- prtMarkerSuppliesType(5) : tipo de consumible
iso.3.6.1.2.1.43.11.1.1.5.1.2 = INTEGER: 3
iso.3.6.1.2.1.43.11.1.1.5.1.3 = INTEGER: 3
iso.3.6.1.2.1.43.11.1.1.5.1.4 = INTEGER: 3
iso.3.6.1.2.1.43.11.1.1.5.1.5 = INTEGER: 4
iso.3.6.1.2.1.43.11.1.1.5.1.6 = INTEGER: 1
iso.3.6.1.2.1.43.11.1.1.5.1.7 = INTEGER: 9
iso.3.6.1.2.1.43.11.1.1.5.1.8 = INTEGER: 9
iso.3.6.1.2.1.43.11.1.1.5.1.9 = INTEGER: 9
iso.3.6.1.2.1.43.11.1.1.5.1.10 = INTEGER: 9
iso.3.6.1.2.1.43.11.1.1.6.1.1 = STRING: "Black Toner Cartridge" --- prtMarkerSuppliesDescription(6) : descripción del consumible.
iso.3.6.1.2.1.43.11.1.1.6.1.2 = STRING: "Cyan Toner Cartridge"
iso.3.6.1.2.1.43.11.1.1.6.1.3 = STRING: "Magenta Toner Cartridge"
iso.3.6.1.2.1.43.11.1.1.6.1.4 = STRING: "Yellow Toner Cartridge"
iso.3.6.1.2.1.43.11.1.1.6.1.5 = STRING: "Waste Toner Box"
iso.3.6.1.2.1.43.11.1.1.6.1.6 = STRING: "Belt Unit"
iso.3.6.1.2.1.43.11.1.1.6.1.7 = STRING: "Black Drum Unit"
iso.3.6.1.2.1.43.11.1.1.6.1.8 = STRING: "Cyan Drum Unit"
iso.3.6.1.2.1.43.11.1.1.6.1.9 = STRING: "Magenta Drum Unit"
iso.3.6.1.2.1.43.11.1.1.6.1.10 = STRING: "Yellow Drum Unit"
iso.3.6.1.2.1.43.11.1.1.7.1.1 = INTEGER: 13 --- prtMarkerSuppliesSupplyUnit(7) : unidad de medida del consumible.
iso.3.6.1.2.1.43.11.1.1.7.1.2 = INTEGER: 13
iso.3.6.1.2.1.43.11.1.1.7.1.3 = INTEGER: 13
iso.3.6.1.2.1.43.11.1.1.7.1.4 = INTEGER: 13
iso.3.6.1.2.1.43.11.1.1.7.1.5 = INTEGER: 13
iso.3.6.1.2.1.43.11.1.1.7.1.6 = INTEGER: 7
iso.3.6.1.2.1.43.11.1.1.7.1.7 = INTEGER: 7
iso.3.6.1.2.1.43.11.1.1.7.1.8 = INTEGER: 7
iso.3.6.1.2.1.43.11.1.1.7.1.9 = INTEGER: 7
iso.3.6.1.2.1.43.11.1.1.7.1.10 = INTEGER: 7
iso.3.6.1.2.1.43.11.1.1.8.1.1 = INTEGER: -2 --- prtMarkerSuppliesMaxCapacity(8) : máxima capacidad del consumible.
iso.3.6.1.2.1.43.11.1.1.8.1.2 = INTEGER: -2
iso.3.6.1.2.1.43.11.1.1.8.1.3 = INTEGER: -2
iso.3.6.1.2.1.43.11.1.1.8.1.4 = INTEGER: -2
iso.3.6.1.2.1.43.11.1.1.8.1.5 = INTEGER: -2
iso.3.6.1.2.1.43.11.1.1.8.1.6 = INTEGER: 50000
iso.3.6.1.2.1.43.11.1.1.8.1.7 = INTEGER: 15000
iso.3.6.1.2.1.43.11.1.1.8.1.8 = INTEGER: 15000
iso.3.6.1.2.1.43.11.1.1.8.1.9 = INTEGER: 15000
iso.3.6.1.2.1.43.11.1.1.8.1.10 = INTEGER: 15000
iso.3.6.1.2.1.43.11.1.1.9.1.1 = INTEGER: -3 --- prtMarkerSuppliesLevel(9) : nivel actual del consumible.
iso.3.6.1.2.1.43.11.1.1.9.1.2 = INTEGER: -3
iso.3.6.1.2.1.43.11.1.1.9.1.3 = INTEGER: -3
iso.3.6.1.2.1.43.11.1.1.9.1.4 = INTEGER: -3
iso.3.6.1.2.1.43.11.1.1.9.1.5 = INTEGER: -3
iso.3.6.1.2.1.43.11.1.1.9.1.6 = INTEGER: 48217
iso.3.6.1.2.1.43.11.1.1.9.1.7 = INTEGER: 4556
iso.3.6.1.2.1.43.11.1.1.9.1.8 = INTEGER: 4556
iso.3.6.1.2.1.43.11.1.1.9.1.9 = INTEGER: 4556
iso.3.6.1.2.1.43.11.1.1.9.1.10 = INTEGER: 4556
- prtMarkerSuppliesType, nodo iso.3.6.1.2.1.43.11.1.1.5: tipos de consumible. Por ejemplo, el valor 3 equivale a "tóner".
- prtMarkerSuppliesDescription, nodo iso.3.6.1.2.1.43.11.1.1.6: descripción del consumible. Por ejemplo "Magenta Toner Cartridge".
- prtMarkerSuppliesSupplyUnit, nodo iso.3.6.1.2.1.43.11.1.1.7: unidades de medida del consumible. Por ejemplo, el valor 13 equivale a "decígramos".
- prtMarkerSuppliesMaxCapacity, nodo iso.3.6.1.2.1.43.11.1.1.8: valor máximo de capacidad del consumible: puede ser la cantidad de tóner o tinta que cabe en el cartucho, o el número máximo de páginas que tiene de vida útil un tambor/cinta de arrastre.
- prtMarkerSuppliesLevel, nodo iso.3.6.1.2.1.43.11.1.1.9: nivel actual del consumible: puede ser la cantidad de tóner o tinta que resta en el cartucho (un %, un número estimado de páginas, etc), o el número de páginas que le quedan por imprimir a un tambor/cinta de arrastre.
Con estos indicadores se puede controlar cuanto consumible queda... en teoría. En el caso de las impresoras Brother el contenido de las ramas prtMarkerSuppliesMaxCapacity y prtMarkerSuppliesLevel no dan datos reales sobre los niveles de tóner, aunque si del estado de otros consumibles: almacén de tóner, cinta de arrastre y tambores. En ellas prtMarkerSuppliesMaxCapacity siempre tiene el valor -2 y prtMarkerSuppliesLevel lo he visto con únicamente dos valores distintos: -3 (hay toner) y 0 (no hay tóner), lo cual es muy poco informativo. En Internet se habla de otros posibles valores asociados a varios estados ("full", "almost empty", "empty" or "absent) pero en mis pruebas esos valores nunca han aparecido.
Cusiosamente, casi todos los otros parámetros estándar de impresoras si que están implementados para las Brother. Por ejemplo, hrPrinterStatus con los valores de estado de la impresora: other(1), unknown(2), idle(3), printing(4), warmup(5).
Buscando una solución encontré un parámetro llamado prtAlertcode en la rama iso.3.6.1.2.1.43.18.1.1.7 que nos devuelve un código de alerta si pasa algo en la impresora. Como se ve en el enlace anterior hay un buen número de códigos, incluido el 1104 que significa markerTonerAlmostEmpty: queda poco tóner. No nos dice el color, pero puede servir para alertar si no nos queda más remedio.
Evidentemente, con esta información es imposible poder monitorizar con detalle el nivel de los consumibles y planificar su adquisión. Pero esto no puede quedar aquí: si vamos al interface web o el panel de la impresora Brother vemos que si que conocen y muestran esos niveles. Es obvio que tiene que haber alguna manera de interrogar a la impresora para obtenerlos.
3. Buscando e interpretando los OID privados.
Mirando con mas detalle me encontré que hay ciertas ramas "ocultas" o privadas que dependen del fabricante del dispositivo y que no salen haciendo un snmpwalk normal. El nodo sysObjectID, con OID iso.3.6.1.2.1.1.2 contiene "The vendor's authoritative identification of the network management subsystem contained in the entity". En caso de las Brother su contenido es:
# snmpwalk -v 2c -c public 172.a.b.c 1.3.6.1.2.1.1.2
iso.3.6.1.2.1.1.2.0 = OID: iso.3.6.1.4.1.2435.2.3.9.1
# snmpwalk -v 2c -c public 172.a.b.c 1.3.6.1.4.1.2435
.....
.....
.....
En https://oidref.com/ podemos perdernos husmeando dentro de esa rama. Yo he ido al grano, buscando valores que me interesaban para su monitorización con Zabbix, por ejemplo el nodo brBackLightColor, que tiene 4 posibles valores: 0:Off/1:Green/2:Orange/3:Red. Básicamente sirven para indicarnos el color que muestra led del panel de la impresora, 0 o 1 significa que bien, y 2 o 3 que hay problemas. Los templates de Zabbix que encontré para impresoras Brother monocromo usaban brBackLightColor en conjunción con prtAlertCode (visto anteriormente) para avisar de forma rudimentaria de que quedaba poca tinta.
Otra rama que me ha venido bien es brPrintPages, iso.3.6.1.4.1.2435.2.3.9.4.2.1.5.5.52.1.3, que muestra desglosadas las páginas impresas en B/N y en color.
Pero no olvidemos que la meta es saber los niveles de los 4 tóneres de color. No hallaba información alguna hasta que encontré pistas en este enlace, y sobre todo en este otro, donde se muestra un programa que lee los niveles reales de tóner de una Brother color. Los datos se leen por SNMP mediante este conjunto de scripts en Python. Indagando en el código veo que los niveles de tinta se sacan de la rama iso.3.6.1.4.1.2435.2.3.9.4.2.1.5.5.8.0, llamada brInfoMaintenance. ¿Qué hay allí?:
# snmpwalk -v 2c -c public 172.a.b.c iso.3.6.1.4.1.2435.2.3.9.4.2.1.5.5.8
iso.3.6.1.4.1.2435.2.3.9.4.2.1.5.5.8.0 = Hex-STRING: 76 01 04 00 00 00 01 77 01 04 00 00 00 01 78 01
04 00 00 00 01 7F 01 04 00 00 00 01 68 01 04 00
00 00 01 55 01 04 00 00 00 01 31 01 04 00 00 00
01 32 01 04 00 00 00 02 33 01 04 00 00 00 01 34
01 04 00 00 00 01 70 01 04 00 00 01 F4 82 01 04
00 00 00 0A 71 01 04 00 00 22 60 83 01 04 00 00
00 5A 72 01 04 00 00 19 64 84 01 04 00 00 00 46
6F 01 04 00 00 25 1C 81 01 04 00 00 00 64 79 01
04 00 00 0C 1C 7A 01 04 00 00 0C 1C 7B 01 04 00
00 0C 1C 80 01 04 00 00 0C 1C 69 01 04 00 00 25
E4 73 01 04 00 00 28 FA 74 01 04 00 00 28 FA 75
01 04 00 00 28 FA 7E 01 04 00 00 28 FA 54 01 04
00 00 00 01 35 01 04 00 00 00 01 6A 01 04 00 00
21 34 6D 01 04 00 00 26 AC FF
4. Extrayendo información de brInfoMaintenance
Bueno, pues ahi dentro está la información. Y alguien ha hecho ingeniería inversa para extraerla. Tras leer dicha página comprendo que, para las impresoras que tengo, la información se organiza en septetos de bytes, asi que formateo la salida del comando para que salga en grupos de 7 valores::
# snmpwalk -v 2c -c public 172.a.b.c iso.3.6.1.4.1.2435.2.3.9.4.2.1.5.5.8.0 | tr -d "\n" | cut -c54- | fold -w 21
76 01 04 00 00 00 01
77 01 04 00 00 00 01
78 01 04 00 00 00 01
7F 01 04 00 00 00 01
68 01 04 00 00 00 01
55 01 04 00 00 00 01
31 01 04 00 00 00 01
32 01 04 00 00 00 02
33 01 04 00 00 00 01
34 01 04 00 00 00 01
70 01 04 00 00 01 F4
82 01 04 00 00 00 0A
71 01 04 00 00 22 60
83 01 04 00 00 00 5A
72 01 04 00 00 19 64
84 01 04 00 00 00 46
6F 01 04 00 00 25 1C
81 01 04 00 00 00 64
79 01 04 00 00 0C 1C
7A 01 04 00 00 0C 1C
7B 01 04 00 00 0C 1C
80 01 04 00 00 0C 1C
69 01 04 00 00 25 E4
73 01 04 00 00 28 FA
74 01 04 00 00 28 FA
75 01 04 00 00 28 FA
7E 01 04 00 00 28 FA
54 01 04 00 00 00 01
35 01 04 00 00 00 01
6A 01 04 00 00 21 34
6D 01 04 00 00 26 AC
FF
"11": VAL_DRUM_COUNT
"31": VAL_BLACK_TONER_STATUS
"32": VAL_CYAN_TONER_STATUS
"33": VAL_MAGENTA_TONER_STATUS
"34": VAL_YELLOW_TONER_STATUS
"41": VAL_DRUM_REMAIN
"63": VAL_DRUM_STATUS
"69": VAL_BELT_REMAIN
"6a": VAL_FUSER_REMAIN
"6b": VAL_LASER_REMAIN
"6c": VAL_PF_MP_REMAIN
"6d": VAL_PF_1_REMAIN
"6f": VAL_BLACK_TONER_REMAIN
"70": VAL_CYAN_TONER_REMAIN
"71": VAL_MAGENTA_TONER_REMAIN
"72": VAL_YELLOW_TONER_REMAIN
"73": VAL_CYAN_DRUM_COUNT
"74": VAL_MAGENTA_DRUM_COUNT
"75": VAL_YELLOW_DRUM_COUNT
"7e": VAL_BLACK_DRUM_COUNT
"79": VAL_CYAN_DRUM_REMAIN
"7a": VAL_MAGENTA_DRUM_REMAIN
"7b": VAL_YELLOW_DRUM_REMAIN
"80": VAL_BLACK_DRUM_REMAIN
"81": VAL_BLACK_TONER
"82": VAL_CYAN_TONER
"83": VAL_MAGENTA_TONER
"84": VAL_YELLOW_TONER
"a1": VAL_BLACK_TONER_REMAIN
"a2": VAL_CYAN_TONER_REMAIN
"a3": VAL_MAGENTA_TONER_REMAIN
"a4": VAL_YELLOW_TONER_REMAIN
71 01 04 00 00 23 F0
"6f": VAL_BLACK_TONER_REMAIN
"70": VAL_CYAN_TONER_REMAIN
"71": VAL_MAGENTA_TONER_REMAIN
"72": VAL_YELLOW_TONER_REMAIN
5. El template Zabbix final.
Bueno, pues el template debe extraer el churro hexadecimal de iso.3.6.1.4.1.2435.2.3.9.4.2.1.5.5.8.0, buscar los códigos 6F, 70, 71 y 72 para cada cartucho de tóner y extraer el nivel en cada uno.
La manera mas sencilla que he encontrado es crear un item que lee la secuencia hexadecimal completa por SNMP y luego hace un preprocessing con Javascript (me encanta ese lenguaje) que busca el código identificador del cartucho en cuestión, extrae los dos bytes con el valor, los convierte de hexadecimal a decimal y lo divide por 100 para obtener el valor que será el mostrado por el item. El código para el tóner Cyan sería:
var pos = value.indexOf("70 01 04 00 00");
var res=0;
if (pos >=0 ) {
res=value.substring(pos+15, pos+20);
res=parseInt(res.replace(" ", ""),16)/100;
};
return res;
<item>
<name>Brother Info Maintenance Cyan</name>
<type>SNMP_AGENT</type>
<snmp_oid>1.3.6.1.4.1.2435.2.3.9.4.2.1.5.5.8.0</snmp_oid>
<key>brInfoMaintenanceCyan</key>
<delay>15m</delay>
<units>%</units>
<applications>
<application>
<name>Supplies</name>
</application>
</applications>
<preprocessing>
<step>
<type>JAVASCRIPT</type>
<params>
var pos = value.indexOf("70 01 04 00 00");
var res=0;
if (pos >=0 ) {
res=value.substring(pos+15, pos+20);
res=parseInt(res.replace(" ", ""),16)/100;
};
return res;
</params>
</step>
</preprocessing>
<triggers>
<trigger>
<expression>{last()}<=10</expression>
<name>Cyan Ink Low at {HOST.NAME}</name>
<priority>AVERAGE</priority>
<manual_close>YES</manual_close>
</trigger>
</triggers>
</item>
Finalmente, incluyo enlace Template_Brother_Laser_Printers.xml con el template Zabbix final para impresoras Brother Láser Color, en formato XML listo para ser importado y leer bien todos los niveles de tóner, junto con varios valores más adicionales que me ha parecido interesante mantener o añadir. Algo me dice que este será el template Zabbix mas enrevasado que nunca escribiré.
Estamos que no paramos con Marte. Los camaradas de la República Popular de China ha aterrizado con la discreción que le caracteriza su rover Zhurong. Parece ser que para la civilización China a la primera va la vencida. Todavía no hay imágenes directas, pero esto nos sirve como adelanto:
Esperamos ansiosos las imágenes del rover trabajando.
