Zabbix template for PaperCut NG and PaperCut MF monitoring

Overview

The template to monitor PaperCut MF and PaperCut NG by Zabbix 6.x using HTTP agent.

Setup

See Zabbix templates importing for basic instructions on how to import a template.

1. Create a new host
2. Set/change the host macros required for PaperCut authentication:

{$PAPERCUT_AUTH_KEY}
{$PAPERCUT_PORT}

3. Link the template to host created early

Zabbix configuration

No specific Zabbix configuration is required

Macros used

Name	Description	Default
{$PAPERCUT_AUTH_KEY}	PaperCut authentication key. (see http://localhost:9191/app?service=page/OptionsAdvanced on PaperCut server)
{$PAPERCUT_PORT}	Port on which PaperCut is listening.	9191
{$PAPERCUT.NODATA_TIMEOUT}	Timeout after which no data trigger will be executed.	30m

Template links

There are no template links in this template.

Discovery rules

Name	Description	Type	Key and additional info
PaperCut device discovery	Discovery of all printer devices from PaperCut	Dependent_item	papercut.device.discovery Preprocessing: - JSONPath: $.devices - DISCARD_UNCHANGED_HEARTBEAT: 6h
PaperCut printer discovery	Discovery of all printers from PaperCut	Dependent_item	papercut.printer.discovery Preprocessing: - JSONPath: $.printers - DISCARD_UNCHANGED_HEARTBEAT: 6h

Items collected

Name	Description	Type	Key and additional info
PaperCut API: Devices		HTTP_Agent	papercut.api.devices
PaperCut API: Monitoring		HTTP_Agent	papercut.api
PaperCut API: Printers		HTTP_Agent	papercut.api.printers
PaperCut Database Active Connections		Dependent_item	papercut.database.activeConnections Preprocessing: - JSONPath: $.database.activeConnections
PaperCut Database Max Connections		Dependent_item	papercut.database.maxConnections Preprocessing: - JSONPath: $.database.maxConnections
PaperCut Database Status		Dependent_item	papercut.database.status Preprocessing: - JSONPath: $.database.status
PaperCut Devices Count		Dependent_item	papercut.devices.total Preprocessing: - JSONPath: $.devices.count
PaperCut Devices in Error		Dependent_item	papercut.devices.inErrorCount Preprocessing: - JSONPath: $.devices.inErrorCount
PaperCut Devices in Error Percentage		Dependent_item	papercut.devices.inErrorPercentage Preprocessing: - JSONPath: $.devices.inErrorPercentage
PaperCut Disk Space Free		Dependent_item	papercut.system.diskspace.free Preprocessing: - JSONPath: $.applicationServer.systemMetrics.diskSpaceFreeMB - Custom multiplier: 1024000
PaperCut DiskSpace Used		Dependent_item	papercut.system.diskspace.used Preprocessing: - JSONPath: $.applicationServer.systemMetrics.diskSpaceUsedPercentage
PaperCut Held Jobs Count		Dependent_item	papercut.printers.heldJobCountTotal Preprocessing: - JSONPath: $.printers.heldJobCountTotal
PaperCut Held Jobs Count Max		Dependent_item	papercut.printers.heldJobsCountMax Preprocessing: - JSONPath: $.printers.heldJobsCountMax
PaperCut JVM Memory Used Percentage		Dependent_item	papercut.system.jvmMemoryUsed Preprocessing: - JSONPath: $.applicationServer.systemMetrics.jvmMemoryUsedPercentage
PaperCut printed pages in the last 60 minutes		HTTP_Agent	papercut.api.stats.recentPagesCount Preprocessing: - JSONPath: $.recentPagesCount
PaperCut Printers Count		Dependent_item	papercut.printers.total Preprocessing: - JSONPath: $.printers.count
PaperCut Printers in Error		Dependent_item	papercut.printers.inErrorCount Preprocessing: - JSONPath: $.printers.inErrorCount
PaperCut Printers in Error Percentage		Dependent_item	papercut.printers.inErrorPercentage Preprocessing: - JSONPath: $.printers.inErrorPercentage
PaperCut Uptime		Dependent_item	papercut.system.uptimeHours Preprocessing: - JSONPath: $.applicationServer.systemMetrics.uptimeHours
PaperCut Valid License		Dependent_item	papercut.license.valid Preprocessing: - JSONPath: $.license.valid
PaperCut Valid License Remaining Days		Dependent_item	papercut.license.upgradeAssuranceRemainingDays Preprocessing: - JSONPath: $.license.upgradeAssuranceRemainingDays - Custom multiplier: 86400
PaperCut Version		Dependent_item	papercut.system.version Preprocessing: - JSONPath: $.applicationServer.systemInfo.version
Percentage Active Connections		Calculated	papercut.database.activeConnections.percentage
Device {#DEVICE_NAME}: Status		Dependent_item	papercut.device.status["{#DEVICE_NAME}"] Preprocessing: - JSONPath: $.devices[?(@.name == "{#DEVICE_NAME}")].state.status.first()
Device {#DEVICE_NAME}: Status Description		Dependent_item	papercut.device.status.description["{#DEVICE_NAME}"] Preprocessing: - JSONPath: $.devices[?(@.name == "{#DEVICE_NAME}")].state.statusDescription.first()
Printer {#PRINTER_NAME}: Held Jobs		Dependent_item	papercut.printer.heldjobs["{#PRINTER_NAME}"] Preprocessing: - JSONPath: $.printers[?(@.name == "{#PRINTER_NAME}")].heldJobsCount.first()
Printer {#PRINTER_NAME}: Status		Dependent_item	papercut.printer.status["{#PRINTER_NAME}"] Preprocessing: - JSONPath: $.printers[?(@.name == "{#PRINTER_NAME}")].status.first()

Triggers

Appropriate triggers are associated with the items

Feedback

Please report any issues with the template here in the "Issues" tab.