Printers

check_printer – All in one printer check suitable for most devices

Write a Review

Description:

This plugin can monitor printers of multiple vendors (HP, Kyocera, Ricoh, Nec, Lexmark, NRG …). It supports private mibs of Ricoh and Kyocera. Can read papertray status, toner/ink status, hardware part status, internal counters and alert status. For Kyocera it can read accounting/Kostenstellen too. Provides perfdata.

This plugin is written in php and requires php_snmp

Current Version

Last Release Date

2015-04-10

Compatible With

Owner

Oliver Skibbe

Website

http://oskibbe.blogspot.com

Download URL

https://github.com/riskersen/Monitoring/blob/master/Printer/check_printer

Copy Page Link Recommend Contact Owner Login to Add to Favorites
Project Notes
*UPDATED* - Added kyocera 13XX Support - Added Ricoh Support (thanks to Sebastian Puschhof) The plugin was developed by the security company ciphron. It was tested with several hundred printers. For more information in german visit: Nagios überwacht Papierfächer, Toner, Tinte und Kostenstellen bei Druckern. Last update: Oliver Skibbe (oliskibbe (at) gmail.com) Commandline (with german comments): check_printer ip community snmpversion command SNMPversion -> 1 or v2c -> counter num Gibt verschiedenen Counter des Druckers aus. Counter 2-num sind Ricoh spezifisch. Counter 1 ist immer Lifetimecounter fuer gedruckte Seiten. Liefert perfdata. Status ist immer OK wenn Counter existiert ansonsten UNKNOWN. -> toner/ink num warn max Gibt den Status des Toners bzw der Tinte aus. Liefert Fuellstand als perfdata wenn moeglich. Wenn der Drucker falsche Maximalwerte fuer Patronen/Toner liefert (z.b. HP Businessink) kann mit max der richtige Wert angegeben werden (meist 100). warn gibt die Schwelle zwischen ok und warning an (0.0 bis 1.0; default: 0.2 = 20%) -> paper num warn Gibt den Status des Papiertrays num aus. Liefert Fuellstand als perfdata wenn moeglich. warn gibt die Schwelle zwischen ok und warning an (0.0 bis 1.0; default: 0.2 = 20%) -> hardware num Gibt Status der Komponente num aus (z.b. CPU, RAMDISK). Liefert perfdata wenn moeglich (Bedeutung oft ungewiss). -> parts num Gibt den Status des Druckerteiles num aus (Bsp: Rear Unit). -> alerts Gibt alle wichtigen Druckermeldungen aus. Ignoriert soweit moeglich unwichtige Meldungen (z.b. Energiesparmodus oder Aufwaermphase). Gibt bei jeder Meldung Status=warning. Bei Meldungen die trained bzw fieldservice erfordern oder servity gleich critical ist wird Status=critical zurueckgegeben. -> accounting pw num warn Gibt den Status der Kostenstelle 1-num aus (Kyocera). Kostenstellen koennen per "KM Net for Accounting" oder im Druckermenu durch gedrueckt halten von OK und Druck auf Menu erstellt werden. Passwort setzt sich zusammen aus Druckernummer (4stellig) und wird dann mit 0 auf 15 Stellen aufgefuellt. (bsp FS-2000 => 200000000000000) warn gibt die Schwelle zwischen ok und warning an (0.0 bis 1.0; default: 0.2 = 20%) Liefert perfdata Examples: check_printer ip community snmpversion command num Num depends on your printer, some printer do have some extra covers or have a ssd so please try to set num for yourself correctly (mostly there are more than one counter) Papertray: # paper tray 2 $ check_printer 192.168.123.1 public 1 paper 2 # alerts $ check_printer 192.168.123.1 public 1 alerts OK - ( 5 3 10 1 0 1001) ( 5 3 10 1 0 1001) # pagecounts, just iterate through the argument after counter $ check_printer 192.168.123.1 public 1 counter 1 OK - Total: 95 | pagecount=95; # hardware parts $ check_printer 192.168.123.1 public 1 hardware 1 OK - FS-2100DN Status=2 | data=2; # hardware parts $ check_printer 192.168.123.1 public 1 parts 1 OK - Top Cover Status=4
Reviews (11) Add a Review
Brother MFC-J5945DW
by thomash, October 31, 2023

My Brother MFC seems tobe incompatible. It supports SNMP 1 and 2c but the results are weired. Papertray is always critical and Ink is also always critical. There seems to be no way to get the expected results. I have about 500 MFCs. Thats the check line for Paper Tray: /etc/naemon/libexec/check_drucker.php 10.xx.xx.xx internal v2c paper 3 results are -2 or -3 Counter works perfect, and so is SNMP-Alive and Hardware. For Hardware it says OK - Brother MFC-J5945DW Status=2. Not really sure what status 2 meens, but as long as Status is ok, I guess it is. Any idea what could cause the problem?


code explanation
by vini0712, May 31, 2016

Hello, yet don't probe this script, but you can find the code description for each one in RFC1759


Works like a charm ... almost ;)
by marcelbpunkt, May 31, 2016

Hi there, I'm using this plugin for toner/ink and alert checks on a handful of Kyocera printers. Toner states are working just fine. Now to the big, noisy "however" ;) When there is an alert on a Kyocera FS-4100DN printer (e.g. "toner low"), it does not return "toner low", but a cryptic warning code like "WARNING - warning codes: 1104,( 4 6 5 1 0 503) ( 5 4 11 1 0 1104)". If I understand it right, 1104 should stand for "toner low" (at least that's what the printer display says) while 503 could be one of the "ok codes" which are ignored ("sleep mode" and the like). No idea whatsoever what all the other numbers are about. Does anyone by chance know of sth like an alert code table on the internet? I have not yet been able to find anything in the manuals or by googling. Thanks a lot in advance!


Great Plugin - great support!
by mklugt, April 30, 2015

Had some issues with my HP LaserJet 400 MFP M425dn and my HP LaserJet 400 color M451dn, contacted the owner and got great support - everything works like a charm now. I absolutely recommend this plugin!


Great Printer Check
by Spik31, October 31, 2014

This is a great plugin, you can use php5-snmp package to run the plugin. Does a good amount of detail for the checks, so it may need multiple check commands defined so that you can get the full status of the printer!


Syntax?
by slobis, November 30, 2013

Can someone please post examples of the syntax for this plugin? I had tried every combo I can think of and all I get is the damn help text everytime.


check_printer error
by pretorians, December 31, 2012

Guys,I got below error.Please help me. Error: Service check command 'check_printer' specified in service 'check' for host 'l3_ricoh' not defined anywhere!


If only it....
by notverynick, June 30, 2012

So this is the best plugin I can find, we use Ricoh, this plugin rocks. However... What I need to know is, will the printer print if I hit print. Currently the printer can be in a state where it will not print yet the plugin returns either warning or even ok. For example this morning one of mine has a lever out of place and this was treated as a warning when no jobs would print. So Essentially I'd love to see this wonderful plugin updated :) I'd actually like: OK - will print (as much info as you'd like to give) Warning - unecessary Critical - won't print (info) Regardless of my comments this IS the number 1 printer plugin :)


Really good!
by Luiso, February 29, 2012

I've test all the scripts of this webpage, and in my opinion is the best. It informs about all the important things that happens in the printers. Goo job. And thanks!


Perfect in HP and Canon
by maniattico, November 30, 2010

This plugin is perfect on my HP and Canon printers, however I cannot change the value of toner/ink level :(


best ever seen
by hoedlmoser, July 31, 2010

best check_print ever seen!


Add a Review

You must be logged in to submit a review.

Thank you for your review!

Your review has been submitted and is pending approval.

Recommend

To:


From:


Thank you for your recommendation!

Your recommendation has been sent.

Page Sections
Project Overview Project Notes Reviews
Project Stats
Rating
4.3 (21)
Favorites
8
Views
176,442