Home Directory Plugins Hardware Printers SNMP Printer Check

Search Exchange

Search All Sites

Nagios Live Webinars

Let our experts show you how Nagios can help your organization.

Contact Us

Phone: 1-888-NAGIOS-1
Email: sales@nagios.com


Remember Me

SNMP Printer Check Popular

56 votes
Current Version
Last Release Date
Compatible With
  • Nagios 3.x
  • Nagios 4.x
check_snmp_printerVersion 3.141592 Script
check_snmp_printerVersion 4.0 Script
check_snmp_printer_versions.txtVersion History
Network Monitoring Software - Download Nagios XI
Log Management Software - Nagios Log Server - Download
Netflow Analysis Software - Nagios Network Analyzer - Download
SNMP Printer Check
Universal printer check. Check for specific consumables or report on all. Query model/serial #, event messages, tray status and much more!

Originally based on Monitoring Solutions' check_snmp_printer, this provides friendly output, quick execution and thorough pre-flight checking.
*** LATEST CHANGES: SNMP v3 checking supported, with improvements to code and error handling. Also simplified output some and added ability to pass long style options (--).

---> IMPORTANT NOTE: Because snmp v3 checking uses -x for selecting a privacy protocol, -x is no longer the option for passing a check type. Instead, I've changed it to the more sensible -t option. This means your service command definitions need to be updated before you can use this plugin!!!

I liked the original plugin but wanted to be able to report the status of all consumables. For some devices this output can get huge. When only 1 component is empty, it becomes a challenge to find what needs to be replaced in the output. So this script was born.

I added checks for user input and better feedback for improper parameters. The same goes for SNMP status - before any code is executed, this is tested.

Usage for SNMP v1/2c:
check-snmp_printer -H {host/IP} -t {type of check} [-C {SNMP community}] [-S] [-w] [-c]

Usage for SNMP v3:
check-snmp_printer -v 3 -H {host/IP} -t {type of check} -u {user} -x {protocol} -X {password} -a {protocol} -A {password} -l {security mode} [-S] [-w] [-c]

Check type can be one of the following:
CONSUM {"string" | TEST | ALL}
TRAY {number(s) | TEST | ALL}

The CONSUM option gives results for all consumable names that match the string passed. For instance, you can pass "CONSUM Toner" and see all toner levels (no staple cartridges or imaging units). Similarly, "CONSUM Black" will show you the Black imaging unit and Black toner levels all at once. The ALL option gives all consumable status at once, and TEST will show you which CONSUMABLES can be monitored.

CONSUMX reports on consumables that match the eXact string passed to it. This helps alleviate problems when a "unique" string is not possible. For example, "CONSUMX Black Toner" would give an error unless the FULL description of the consumable (from a CONSUM TEST) is "Black Toner". Any consumable named "Black Toner1" or "Black Toner Cartridge" would be overlooked.

TRAY can be passed a number or list of numbers (comma-separated) as a parameter. The ALL parameter reports all tray statuses and TEST lets you know which trays the device has. In addition to generic status, the tray function tries to calculate paper remaining as a % of capacity (if possible), although this only works as good as the sensors on the device (and often only returns values at fixed intervals, such as 25%, 50%, 75%, etc.)

DEVICE, DISPLAY, MESSAGES, MODEL and STATUS report information about the printer's hardware devices, physical display, event log messages, model/serial or overall status (respectively).

If you want the output for consumables to contain multiple lines, pass the following argument:
-S "n"

Then you need to edit your service notifications. Just after the $SERVICEOUTPUT$ macro, you will need to add "n$LONGSERVICEOUTPUT$". E-mails will finally contain lines 2 and up of the output.

Reviews (43)
byrendicott, April 12, 2013
1 of 1 people found this review helpful
Great script!

To avoid the "WARNING: No SNMP response from -C! Make sure host is up and SNMP is configured properly." message make sure that you add the additional $ after "$HOSTADDRESS" in the command definition. The OP was missing it and it fixed my problem.

The following line in the OP:
command_line $USER1$/check_snmp_printer -H $HOSTADDRESS -C $ARG1$ -x $ARG2 -w $ARG3$ -c

Should be:
command_line $USER1$/check_snmp_printer -H $HOSTADDRESS$ -C $ARG1$ -x $ARG2 -w $ARG3$ -c
byfibercool, March 12, 2013
Any idea why im getting the consumables names in HEX instead in ascii format, for example like this:

Consumables you may Monitor:
42 6C 61 63 6B 20 43 61 72 74 72 69 64 67 65 20
43 45 32 35 35 41 00

I'm getting same thing with different HP models.
bymilda, January 29, 2013
Printer Oki C5700 returns same names of consumables without colour:

SNMPv2-SMI::mib- = STRING: "Toner Cartridge OKI DATA CORP"
SNMPv2-SMI::mib- = STRING: "Toner Cartridge OKI DATA CORP"
SNMPv2-SMI::mib- = STRING: "Toner Cartridge OKI DATA CORP"
SNMPv2-SMI::mib- = STRING: "Toner Cartridge OKI DATA CORP"
SNMPv2-SMI::mib- = STRING: "Image Drum Unit OKI DATA CORP"
SNMPv2-SMI::mib- = STRING: "Image Drum Unit OKI DATA CORP"
SNMPv2-SMI::mib- = STRING: "Image Drum Unit OKI DATA CORP"
SNMPv2-SMI::mib- = STRING: "Image Drum Unit OKI DATA CORP"

Colours are named in MarkerColorantTable:
SNMPv2-SMI::mib- = STRING: "black"
SNMPv2-SMI::mib- = STRING: "cyan"
SNMPv2-SMI::mib- = STRING: "magenta"
SNMPv2-SMI::mib- = STRING: "yellow"
byrdc_scase, October 8, 2012
Thank you Jason for the plugin. It is making my job alot easier!
Great work on this. I'm having an issue monitoring a Xerox DocuColor 242 though. The reported toner levels fluctuate wildly every few minutes. Here is an example from CONSUM ALL:

Black Toner [K] Cartridge is at 253% - OK!
Black Drum Cartridge is at 55% - OK!
Black Toner [K1] Cartridge is at 1084% - OK!
Black Toner [K2] Cartridge is at 884% - OK!
| Black Toner [K] Cartridge=253;20;5; Black Drum Cartridge=55;20;5; Black Toner [K1] Cartridge=1084;20;5; Black Toner [K2] Cartridge=884;20;5;

Black Toner [K] Cartridge is at 15% - WARNING!
Black Drum Cartridge is at 17% - WARNING!
Black Toner [K1] Cartridge is at 1590% - OK!
Black Toner [K2] Cartridge is at 1071% - OK!
| Black Toner [K] Cartridge=15;20;5; Black Drum Cartridge=17;20;5; Black Toner [K1] Cartridge=1590;20;5; Black Toner [K2] Cartridge=1071;20;5;

This is for all consumables. Actual levels for K1 and K2 are 20% and 100%.

All other checks work. Tray levels look correct. Tray 5 says to refill it with .5 x .5 paper but it is set to 8.5x11.

byeby, September 23, 2012
Like the command layout of this one especially the custom warn/crit levels on the command line. Worked great with the lexmark printers we have. Haven't ran into any issues yet.

One thing that should be noted. On gentoo the bc and xxd binaries aren't present which this script uses. I'm guessing this was the problem the one star reviewer encountered. bc is in portage and the pentoo overlay has xxd. Once I installed both of these the script ran fine. Would be good to note some of the system binaries it uses in the description.
I wrote a little change in check_page_count function:

function check_page_count(){
PAGE_COUNT=$(snmpget -v1 -Ovq -c $COMMUNITY $HOST_NAME 2>/dev/null)

if [ "$PAGE_COUNT" -lt "$WARNING" ]; then
if [ "$PAGE_COUNT" -ge "$WARNING" ] && [ "$PAGE_COUNT" -lt "$CRITICAL" ]; then
if [ "$PAGE_COUNT" -ge "$CRITICAL" ]; then


So far so good. The only issue i'm running into is with the STATUS check. I setup services for three of my printers and i'm getting weird results. Nagios is giving me the following:

WARNING: Printer status is idle

When i do an SNMPwalk on 2 of that printer i get the following:

INTEGER: idle(3)

Looking at the script it appears i should be getting an OK: but i'm getting a WARNING: instead.

Here is my check command definition:

define command {
command_name check_snmp_printer
command_line $USER1$/check_snmp_printer -H $HOSTADDRESS$ -C $ARG1$ -x $ARG2$ -w $ARG3$ -c $ARG4$

And my service command:

define service {
service_description Status
check_command check_snmp_printer!public!STATUS!!
host_name media-stats-printer
event_handler_enabled 0
use generic-service
contact_groups +admins

Any advice would be greatly appreciated.

I really like this plugin! But could you first check if the printer reports a maximum capacity before dividing through it? On our Sharp MX-2300N there is no such value, therefore the script tries to divide by 0 for a few times.
bygarazh317, December 19, 2011
Hi! I tried to use this plugin on freesd 7.4 but i have that error UNKNOWN: check_snmp_printer: No usable 'xxd' binary in '/sbin:/bin:/usr/sbin:/usr/bin:/usr/games:/usr/local/sbin:/usr/local/bin:/root/bin'
bystijns, November 18, 2011
very nice plugin. However, there is a small bug: When a unknown tray or consumable is requested, the status information shows an error ("UNKNOWN - OID not found! Your printer may not support checking this consumable. Use the CONSUM TEST option to determine which consumables may be monitored.")
but: the status itself is "OK".

and 2 suggestions / feature requests:
-Can you refer to a tray or consumable by it's index in addition to it's name? I have a Brother B/W printer that returns 2 times a "black toner cartridge", one that is empty and another one with the correct information. But I can't point to the right one because they are named the same. And of course, the faulty one is the first one so that's the one CONSUMX returns.

-Can you exclude a certain tray or consumable together with the ALL statement? The manual paper tray is usually empty so will always return Critical. Excluding one is easier than specifying all but one tray.
byoricalco, November 15, 2011
thanks! your plug-in is just what I was searching for, but still I wanted to ask if you could please put the service definition for TRAY? it would be really useful. Also, are the service definitions you put for toner and model compatible with the 2.1 POSIX version or just the with the 3.14159 version?
if I have ubuntu is it recommendable to update or does the service definitions work either way? sorry if I'm making obvious questions its just that I am both an ubuntu and nagios noob and there is just too much I don't understand...
byzavisha, November 13, 2011
Looks great but i've got one problem with this.
define service{
use generic-service
host_name hp1536dnf
service_description Toner Supply
check_command check_snmp_printer!!public!CONSUM!20!10
normal_check_interval 10
retry_check_interval 1

define command{
command_name check_snmp_printer
command_line $USER1$/check_snmp_printer -H $HOSTADDRESS -C $ARG1$ -x $ARG2 -w $ARG3$ -c $ARG4$

Nagios shows "WARNING: No SNMP response from -C! Make sure host is up and SNMP is configured properly."

Please, help
byzoemu, October 12, 2011
0 of 2 people found this review helpful
Owner's reply

Please provide comments with your rating so I can know how to help you or what might be wrong with the plugin.

byHuerres, August 18, 2011
First of all give you many thanks for this excellent plugin. It is valid for many items of our printers.

I have a little problem. My commands.cfg I add:
#'check_printer' command definition
define command{
command_name check_printer
command_line $USER1$/check_printer -H $HOSTADDRESS$ -p $ARG1$ $ARG2$ $ARG3$
After this I add this to my printers.cfg:
define service{
use generic-service
host_name ljpm1217nfwmfp
service_description PS
check_command check_printer!-H -C public -x "STATUS" -w WARNING -x CRITICAL -S / |-V|-h
normal_check_interval 1
retry_check_interval 1

But the Nagios webpage return me a "null". Can you help me please?

Thanks a lot,
Owner's reply

As I noted in our e-mail correspondence, your syntax for running the command is incorrect. Please consult the documentation for more help, but the commands I provided you in e-mail should work.

Works well for 3 different brand network printers.
I had to make the following changes to get the plugin to run:
1. dos2unix
2. set bash as shell
3.put quotes around MARKER_COLOR to eliminate grep error messages
4.new line after here doc terminator

$ diff -b ../../Downloads/firefox/check_snmp_printer_args.sh /usr/lib/nagios/plugins/check_snmp_printer_args.sh
if $(echo "$MARKER_NAME" | grep -vqi "$MARKER_COLOR"); then
> )
Owner's reply

#1 should not be needed with the latest versions of the plugin, but yes I have received a few complaints about dos2unix before. That's what happens when I don't have a Linux workstation at my company :)

#2 is needed for Ubuntu machines, yes. All other distros use BASH or an interpreter that works with the plugin.

#3 should be fixed already in the latest version of the plugin.

I will have to investigate #4 but have not heard other complains about this.

bydceola, April 28, 2011
2 of 2 people found this review helpful
Any chance someone can share their service definition and command definition lines for this? I'm having trouble configuring them correctly.
Owner's reply

Your command definition should look like this:

define command {
command_name check_printer
command_line $USER1$/check_printer $HOSTADDRESS$ $ARG1$ $ARG2$

by3mwhite, February 4, 2011
Any chance on us getting the config commands?

define service{
use generic-service
host_name SharpAr-m257
service_description PING
check_command check_ping!3000.0,80%!5000.0,100%
normal_check_interval 10
retry_check_interval 1

define command{
command_name check_local_users
command_line $USER1$/check_users -w $ARG1$ -c $ARG2$
bye314, November 29, 2010
Nice script, very useful.
byydduj, October 28, 2010
I tried to use 'iconv' to convert from UTF-8 to ASCII with no success.

Try: 'strings check_snmp_printer.sh > check_snmp_printer-ASCII.sh'

'file' now reports:
check_snmp_printer-ASCII.sh: POSIX shell script text executable
Owner's reply

Thanks for the note, is UTF format a problem for Linux? My CentOS server has never had a problem with it.

Unfortunately, I do most of my work, including file upload, on a Windows box. I do not have a Linux workstation at work and do no get to work on the plugin outside of work.

Page 2 of 3