New Question
 
 
PRTG Network Monitor

Intuitive to Use.
Easy to manage.

200.000 administrators have chosen PRTG to monitor their network. Find out how you can reduce cost, increase QoS and ease planning, as well.

Free PRTG
Download >>

 

What is this?

This knowledgebase contains questions and answers about PRTG Network Monitor and network monitoring in general. You are invited to get involved by asking and answering questions!

Learn more

 

Top Tags


View all Tags


How can I monitor my print environment when using PaperCut?

Votes:

4

Your Vote:

Up

Down

PaperCut (www.papercut.com) is an easy to install, simple to use print management solution used by over 50,000 organisations globally. With PaperCut and PRTG Network Monitor, you can easily monitor the health of your entire print environment, including real-time activity that will help you plan future printing resource requirements. End-users will have as wrinkle-free a printing experience as possible because you have avoided potential issues and outages along the way.

How do the templates work?

The PaperCut PRTG templates allow System Administrators to perform health monitoring of their PaperCut printing environment, with a minimal amount of setup. The templates are automatically created by executing a python script ( PaperCut PRTG Template Generator ), which scans your specific PaperCut installation and create sensors for all printers, devices, and critical PaperCut infrastructure. You can then import this template directly into PRTG Network Monitor.

The sensors included in the template monitor the following:

  • Server health status:
    • Overall server health
    • Current number of held jobs
    • Pages printed in the last minute
    • Server errors in the last 10 minutes
    • Server warnings in the last 10 minutes
  • Individual printer health status
  • Individual device health status

For more advanced usage, check out the PaperCut NG System Health Interface reference.

What do I need to get started?

How do I generate the PaperCut PRTG Templates?

Once the PaperCut PRTG Template Generator Script has been downloaded onto your local machine, it can be executed using a command line interface in order to generate the PaperCut PRTG Templates. Ensure that Python 3.1 or greater is installed.

This section describes the steps required to generate PaperCut PRTG Templates:

  1. Obtain the PaperCut Health Monitoring API URL.
  2. Run the PaperCut PRTG Template Generator script.
  3. Import the PaperCut PRTG Templates.

Obtain the PaperCut Health Monitoring API URL

  • In the PaperCut Admin web interface, select Options > Advanced.
  • In the System Health Monitoring area, copy the URL for the PaperCut Health Monitoring API (this is the ‘GET query parameter’).

Run the PaperCut PRTG Template Generator script

Run the PaperCut PRTG Template Generator script (pc-prtg-generator.py) with the first argument being the GET Query Parameter (the Health Monitoring URL) for the PaperCut Health Monitoring API.

E.g. ./pc-prtg-generator.py http://10.100.66.29:9191/api/health?Authorization=LAlwqdy57aE35n2TOyr777778888DaF

The PaperCut PRTG template files are generated in the same directory as the script. Templates are generated according to your setup. For example, if you have no printers or devices, the corresponding printer or device template file will not be generated. Up to three PRTG template files are generated:

  • PaperCut Printers.odt : monitors PaperCut printers in your installation.
  • PaperCut Devices.odt : monitors PaperCut devices in your installation.
  • PaperCut Server.odt : monitors the PaperCut server.

Required Arguments

ArgumentParameterDescription
addressSTRINGGET Query URL for your PaperCut Server Health Monitoring API.

Optional Arguments

ArgumentParameterDescriptionExample
-n
--name
STRING (Default: none)Filter printer and device results by name../pc-prtg-generator.py http://10.100.66.29:9191/api/health?Authorization=LAlwqdy57aE35n2TOyr7BHy3p70CDaFb --name plotterPrinter
-lo
--location
STRING (Default: none)Filter results by the printer/device location./pc-prtg-generator.py http://10.100.66.29:9191/api/health?Authorization=LAlwqdy57aE35n2TOyr7BHy3p70CDaFb --location financeDept
-s
--server
STRING (Default: none)Filter results by the printer server../pc-prtg-generator.py http://10.100.66.29:9191/api/health?Authorization=LAlwqdy57aE35n2TOyr7BHy3p70CDaFb --server pc-Server
-li
--limit
INT (Default: 250)Maximum number of printers/devices to include in the template../pc-prtg-generator.py http://10.100.66.29:9191/api/health?Authorization=LAlwqdy57aE35n2TOyr7BHy3p70CDaFb --limit 50

Importing PaperCut PRTG Templates

  • Copy the following PRTG templates from the script directory to the '''devicetemplates''' folder in the PRTG installation directory: <installation directory>\PRTG Network Monitor\:
    • PaperCut Printers.odt
    • PaperCut Devices.odt
    • PaperCut Server.odt
    • Note: If you have no printers or devices, the corresponding device template file will not be generated.
  • In the PRTG Admin Interface, under the Root group, right-click the PRTG current object (e.g. right-click on “127.0.0.1”); then select Add Device. The '''Root''' group is the highest instance in the object hierarchy of your PRTG setup and is the parent to all other objects.

  • Add a new device
    • Under Sensor Management, select the Automatic Sensor creation using specific device template(s) option.
    • Search the templates for PaperCut, and select the template you wish to use.
    • Click Continue.

  • Repeat the steps for each of the PaperCut PRTG templates.

Your PRTG Network Monitor is now set up for you to monitor your PaperCut printing environment.

For any feedback, or if you have additional questions, contact [email protected] or search the manual and knowledge base articles at www.papercut.com/kb.

papercut printing prtg-template sysadmin

Created on Oct 28, 2016 6:03:03 AM by  papercut_paessler (4) 1

Last change on Nov 3, 2016 5:26:23 AM by  Sebastian Kniege [Paessler Support]



4 Replies

Votes:

0

Your Vote:

Up

Down

Dear papercut_paessler,

Thank you very much for your detailed knowledge page post. We are really thankful for the effort you've put into it. Our customers using PaperCut will mostly appreciate it.



Best,
Sebastian Kniege [Paessler Support]

Created on Oct 28, 2016 8:08:02 AM by  Sebastian Kniege [Paessler Support]



Votes:

0

Your Vote:

Up

Down

No problems,

For any feedback, or if you have additional questions, feel free to contact [email protected] or search the manual and knowledge base articles at www.papercut.com/kb.

Created on Oct 30, 2016 9:20:00 PM by  papercut_paessler (4) 1



Votes:

0

Your Vote:

Up

Down

Does this need to also be carried out on the servers that host a remote probe or is it only required for the primary probe host? (This was answered by looking at the directory structure. devicetemplates only exists on the primary host)

However, is there a limit? We have 2 print servers. Looking at the xml that was generated it appears to have stopped at the 250th entry and missed everything else. Is there a way to extend this limitation?

Created on Sep 19, 2018 3:17:42 PM by  Ron Sharcott (1) 2

Last change on Sep 19, 2018 7:22:36 PM by  Dariusz Gorka [Paessler Support]



Votes:

0

Your Vote:

Up

Down

Hello Ron,

To which .xml file do you refer precisely? Where is this file being generated?

Best regards,
Sebastian

Created on Sep 21, 2018 8:48:49 AM by  Sebastian Kniege [Paessler Support]



Please log in or register to enter your reply.


Disclaimer: The information in the Paessler Knowledge Base comes without warranty of any kind. Use at your own risk. Before applying any instructions please exercise proper system administrator housekeeping. You must make sure that a proper backup of all your data is available.