Choose your language

Choose your login


Configure PaperCut NG/MF system health monitoring

This page applies to:

There is an enormous range of open source and enterprise level monitoring tools available (such as PRTG , Zabbix and Nagios ). However, they all have a common purpose of keeping you informed of the state of your servers, applications, services, and infrastructure. You can use data collected by these tools in a variety of ways. For example, the data could be graphed to allow analysis of ongoing system performance and reliability, so that informed decisions can be made about resourcing. For more immediate feedback about PaperCut NG/MF, you can also configure alarms that are triggered by status changes. For example, a log entry could be recorded when a server’s CPU utilization passes a certain threshold, or an incident ticket could be opened when network bandwidth becomes saturated, or perhaps an email could be sent when a particular application becomes unavailable.

The PaperCut NG/MF System Health JSON REST API endpoint is accessible via HTTP. Your monitoring tool can retrieve the values collected by this interface and consume the data in a user friendly way.

The way in which you configure your monitoring system to use the PaperCut NG/MF System Health interface data is dependent on the tool you are using, however, the high-level steps are the same:

To configure a monitoring tool to perform a PaperCut NG/MF system health check:

  1. Discover the printer and device status URLs in the PaperCut NG/MF Application Server.

  2. If you want to monitor the status of individual printers or devices, export a list of printer and/or device status URLs .

  3. Install the monitoring tool on a server that can access the PaperCut NG/MF Application Server.

  4. In your monitoring tool, authorize access to the secure System Health interface: http://[primary_server]:[port]/api/health/ in one of the following ways. The way in which this is done is dependent on the monitoring tool.

    • send an HTTP GET request

      Send an HTTP GET request to the following URL:

          http://[primary_server]:[port]/api/health/application-server/status?disk-threshold-mb=1&Authorization=[authorization key
    • add the authorization key to the HTTP header

      For example, the HTTP header is Authorization:4hZiSw8S1dbWFQ8XFmizf7r76Xqwy1kE.

  5. In the monitoring tool, add the endpoints that you want to monitor. For more information about the available endpoints, see PaperCut NG/MF System Health interface reference .

  6. If required, configure alarm notifications in the monitoring tool.

  7. Test the PaperCut NG/MF System Health interface integration.

Check out the list of monitoring tools we’ve used with the Print System Health Interface—see Supported Third Party Monitoring Tools .