You are here: Administration > Tools - database, server-command scripting, and APIs (Advanced) > Monitoring print system health > Advanced system information URLs

Advanced system URLs

PaperCut MF provides a number of URLs for advanced system health monitoring. These URLs contain JSON attributes so can be used only by monitoring tools that support JSON.

The following types of advanced URLs are provided:

Component summary URLs
Base system health URL

Component summary URLs

You can monitor each type of physical component (such as, printers or devices) in your PaperCut MF implementation. The following summary URLs are provided:

Printers URL
Devices URL
Print Providers URL
Web Print URL
Site Servers URL

Printers URL

The printers URL is:

http:\\[primary_server]:[port]\api\health\printers

Example:

For an example of this URL, click the image below:

This URL provides the following JSON attributes:

Object	Attribute	Description
printers	name	The name of the printer.
	status	The status of the printer.
	heldJobsCount	The number of jobs currently held in the printer queue. This value is updated every 10 seconds.

Devices URL

The devices URL is:

http:\\[primary_server]:[port]\api\health\devices

Example:

For an example of this URL, click the image below:

This URL provides the following JSON attributes:

Object

Attribute

Description

devices

name

The name of the device in error.

type

The brand of device in error.

state

\ status

The status of the device. Valid values are.

\ statusDescription

A description of the status.

\ lastJobSeconds

The number of seconds since the last job was processed by the device.

hostingServer

Available only if the device is hosted by a Site ServerSite Servers take over the role of a Primary Application Server in the event of network outages. Key roles taken over include authentication, copy and print tracking and Find-Me printing. Site Servers ensure continuous availability of printing resources to support key business functions over unreliable network links or during unplanned network disruptions.. The name of the server hosting the device.

Print Providers URL

The Print Providers (secondary print serverA print server is a system responsible for hosting print queues and sharing printer resources to desktops. Users submit print jobs to a print server rather then directly to the printer itself. A print server can be a dedicated server but on many networks this server also performs other tasks, such as, file serving) URL is:

http:\\[primary_server]:[port]\api\health\print-providers

Example:

For an example of this URL, click the image below:

This URL provides the following JSON attributes:

Object	Attribute	Description
printProviders	host	Details of the Print Providers that are offline.
	lastContactSeconds	The number of seconds since the Print ProviderA Print Provider is a monitoring service installed on a secondary print server to allow PaperCut to control and track printers. This monitoring component intercepts the local printing and reports the use back to the primary Application Server. was last contacted by the Application ServerAn Application Server is the primary server program responsible for providing the PaperCut user interface, storing data, and providing services to users. PaperCut uses the Application Server to manage user and account information, manage printers, calculate print costs, provide a web browser interface to administrators and end users, and much more..

Web Print URL

The Web Print server URL is:

http:\\[primary_server]:[port]\api\health\web-print

Example:

For an example of this URL, click the image below:

This URL provides the following JSON attributes:

Object	Attribute	Description
servers	host	The host name of the Site Server.
	status	The status of the Web Print server.
	upTimeHours	The number of hours since the Web Print server was started.
	lastActivitySeconds	The number of seconds since the Web Print server was last contacted by the Application Server.
	version	The version and build number of the Web Print server application.
	supportedFileTypes	The file types supported by the server: image pdf ms-pwerpoint ms-word ms-excel xps

Site Servers URL

The Site Servers URL is:

http:\\[primary_server]:[port]\api\health\site-servers

Example:

For an example of this URL, click the image below:

This URL provides the following JSON attributes:

Object	Attribute	Description
siteServers	serverName	The server name of the Site Server.
	host	The host name of the Site Server.
	online	Whether the Site Server is online (true) or offline (false).
	lastContactSeconds	The number of seconds since the Site Server was last contacted by the Application server.
	devicesHosted	The number of devices hosted by the Site Server.
	version	The version of the Site Server application.

Base system health URL

The base system health URL is:

http:\\[primary_server]:[port]\api\health\

This URL provides JSON attributes for the following components in your PaperCut MF implementation:

Application Server
Database
Devices
Printers
License
Print Providers
Site Servers
Web Print servers

Example:

For an example of this URL, click the image below:

This URL provides the following JSON attributes:

Object	Attribute	Description
applicationServer	systemInfo
	\ version	The PaperCut MF release number, build number, and the date on which the build was created.
	\ operatingSystem	The full name and version number of the operating system on the Application Server.
	\ processors	The number of servers on the Application Server.
	\ architecture	The type of Application Server processor.
	systemMetrics
	\ diskSpaceFreeMB	The number of Megabytes (MB) of available disk space on the Application Server.
	\ diskSpaceTotalMB	The total number of Megabytes (MB) on the Application Server.
	\ diskSpaceUsedPercentage	The percentage of the Application Server disk space that has been used.
	\ jvmMemoryMaxMB	The number of Megabytes (MB) of Java Virtual Machine (JVM) memory on the Application Server.
	\ jvmMemoryUsedMB	The number of Megabytes (MB) of Java Virtual Machine (JVM) memory on the Application Server that is currently in use.
	\ jvmMemoryUsedPercentage	The percentage of the available Megabytes (MB) of Java Virtual Machine (JVM) memory on the Application Server that is currently in use.
	\ uptimeHours	The number of hours since the Application Server was started.
	\ processCpuLoadPercentage	The percentage of the Application CPU load used to run processes.
	\ systemCpuLoadPercentage	The current Application Server CPU load as a percentage.
	\ gcTimeMilliseconds	The number of milliseconds spent performing Java garbage collection since the Application Server was started.
	\ gcExecutions	The number of Java garbage collections since the Application Server was started.
	\ threadCount	The maximum number of simultaneous requests the Application Server can handle.
database	totalConnections	The total number of available connections to the Application Server database.
	activeConnections	The number of connections to the Application Server database currently being used.
	timeToConnectMilliseconds	The average time (in milliseconds) to connect to the Application Server database.
	timeToQueryMilliseconds	The average time (in milliseconds) to query the Application Server database.
	status	The status of the database connection.
devices	count	The total number of devices in the fleet.
	inErrorCount	The number of devices in error.
	inErrorPercentage	The percentage of devices in error.
	inError
	\ name	The name of the device in error.
	\ status	The status of the device in error. The Per device URLs provide more detail about each device.
	\ hostingServer	Available only if the device is hosted by a Site Server. The name of the server hosting the device in error.
printers	inErrorCount	The number of printers in error.
	inErrorPercentage	The percentage of printers in error.
	count	The total number of printers in the fleet.
	inError
	\ name	The name of the printer in error.
	\ status	The status of the printer in error. The Advanced system URLs provides more detail about each device.
	\ hostingServer	Available only if the printer is hosted by a Site Server. The name of the server hosting the device.
	maxHeldJobs	The maximum number of jobs currently held in any printer queue.
	averageHeldJobs	The average number of jobs that are currently held in print queues.
license	valid	Whether or not the Application Server license is valid.
	licenseRemainingDays	The number of days remaining before the current Application Server license expires.
	users
	\ used	The number of user licenses currently in use.
	\ licensed	The total number of user licenses purchased.
	\ remaining	The number of user licenses currently available. This is equal to the licensed value less the used value.
	siteServers
	\ used	The number of Site Server licenses currently in use.
	\ licensed	The total number of Site Server licenses purchased.
	\ remaining	The number of Site Server licenses currently available. This is equal to the licensed value less the used value.
	advancedClient
	\ used	The number of advanced client licenses currently in use.
	\ licensed	The total number of advanced client licenses purchased.
	\ remaining	The number of advanced client licenses currently available. This is equal to the licensed value less the used value.
	devices
	\ used	The number of device licenses currently in use.
	\ licensed	The total number of device licenses purchased.
	\ remaining	The number of device licenses currently available. This is equal to the licensed value less the used value.
	paymentGateway
	\ used	The number of Payment Gateway licenses currently in use.
	\ licensed	The total number of Payment Gateway licenses purchased.
	\ remaining	The number of Payment Gateway licenses currently available. This is equal to the licensed value less the used value.
printProviders	count	The total number of Print Providers installed. Note: Print Provider monitoring is not available for Print Providers installed on Windows desktops.
	offlineCount	The number of Print Providers that are currently offline. A Print Provider is considered offline when it has been offline for 2 minutes or more. Note: Print Provider monitoring is not available for Print Providers installed on Windows desktops.
	offlinePercentage	The percent of Print Providers that are currently offline. Note: Print Provider monitoring is not available for Print Providers installed on Windows desktops.
	offline
	\ host	Details of the Print Providers that are offline. Note: Print Provider monitoring is not available for Print Providers installed on Windows desktops.
	\ lastContactSeconds	The number of seconds since the Print Provider was last contacted by the Application Server. Note: Print Provider monitoring is not available for Print Providers installed on Windows desktops.
siteServers	count	The total number of Print Providers installed.
	offlineCount	The number of Print Providers that are currently offline.
	offlinePercentage	The percent of Print Providers that are currently offline.
	offline
	\ serverName	The server name of the offline Print Providers.
	\ host	The host name of the offline Print Providers.
	\ lastContactSeconds	The number of seconds since the Print Provider was last contacted by the Application server.
webPrint	count	The total number of Web Print servers.
	offlineCount	The number of Web Print servers that are currently offline.
	offlinePercentage	The percent of Web Print servers that are currently offline.
	offline
	\ host	The host name of the offline Web Print server.
	\ status	The status of the Web Print server. Valid statuses are: OK—the Web Print server is functioning as expected. ERROR—the Web Print server is in error. STOPPED—the Web Print server has been stopped by a SysAdmin.
	\ uptimeHours	The number of hours since the Web Print server was started.
	\ version	The version and build number of the Web Print server application.
	\ supportedFileTypes	The file types supported by the server: image pdf ms-pwerpoint ms-word ms-excel xps
	jobsPending	The number of jobs currently in the Web Print queue.

PaperCut MF version 16.2

Advanced system URLs

Component summary URLs

Printers URL

Devices URL

Print Providers URL

Web Print URL

Site Servers URL

Base system health URL

We are here to help