Spools

This monitor is dedicated for the monitoring of spools and spool requests
Range number usage and number of large spools can be monitorted, as well spool requests status

Configuration hints

Spool requests:

You can monitor the status of spool requests:

error

completed with error

waiting

Use the first table to define the monitoring filters

You can set various filters to target a particuar output device or user

Spool utilization:

You can monitor the number of spools currently used vs the total available.

This can be configured in the first row of the second table of filters

Set a threshold in percent to generate an alarm when spool utilization is too high

Spool utilization by status:

You can monitor the spool utilization percentage by dividing the status column in the report RSPO_SHOW_SPO_NUM.

This can be configured in the third row of the second table of filters

Set a threshold in percent to generate an alarm when spool utilization is too high

Max spool size:

You can monitor the spools bigger than a given size

This can be configured in the second row of the second table of filters

Set the maximum size for spools. Default unit is bytes, but you can specify units like KB for kilobytes and MB for bytes

An alarm will be generated if some spools are bigger than the threshold.

Note:

This monitor will fetch the spool requests that occurred since the last check (ie since last 15 min if it runs every 15 min)

An exception is made for the requests in waiting state, that are fetched to a maximum limit of one week in the past.

The configuration can be set via the two surveillance tables:

The first one has a fixed size and allows to define spool size and used number thresholds.

The second is dedicated to the requests and allows to create any number of surveillance rules for the requests based on:

Output device

User

Number of errors

Waiting time

Unused thresholds have to be set to 0.

Thresholds are independent from each others.

Surveillance table

Spools monitoring

Parameter	Description
Active	Use this field to activate or deactivate a line of configuration.
Description	Read only field, defines the metric being configured (used number or size)
Threshold	The threshold of the corresponding metric, expected percent for used number and size in bytes/kilobytes (KB)/ megabytes (MB).
Severity	The level of severity of the alarm generated by this line of surveillance.
Aggregate	If checked, the generated alarms will indicated the number of spools breaking the threshold. Otherwise, an alarm will be sent for each spool over the limit, indicating spool details.
Auto clear	If checked, the alarm will be cleared as soon as the alarm condition is not met anymore.
Alarm tag	This field allows to add custom text within the alarm message. %MSG% variable will contain the actual generated message and can be used such as: “my_prefix %MSG% my_suffix”. By default, tag will be used as prefix.
Alarm	If checked, this line of surveillance will be used for alarm generation.
Metric	If checked, this line of surveillance will be used for metric generation.
Report	If checked, this line of surveillance will used for showing threshold and severity in the daily report

Examples

Active	Description	Threshold	Severity	Aggregate	Auto clear	Alarm tag	Alarm	Metric	Report
true	Max spool number utilization (%)	30	MAJOR	true	true	true	false	false

Effect : Generates a MAJOR alarm if one or several spool used number reaches 30%. The alarm will indicates how many spools are breaking the threshold (aggregate = true)

Examples

Active	Description	Threshold	Severity	Aggregate	Auto clear	Alarm tag	Alarm	Metric	Report
true	Max spool size (MB)	50	WARNING	false	true	true	false	false

Effect : Generate a WARNING alarm for each spool with a size bigger than 50 Megabytes.

Spool requests monitoring:

Parameter	Description
Active	Use this field to activate or deactivate a line of configuration.
Output device	A filter to match a subset of printers. Use * to match all.
User	A filter to match only a subset of users. Use * to match all
Max completed w. errors	The threshold for the maximum number of requests with “Completed with error” status.
Comp. w. error sev	The severity for the “max completed with error” alarm.
Max errors	The threshold for the maximum number of requests with “error” status.
Error severity	The severity for the “error” alarm.
Max wait time (min)	The threshold for the time a requests can stay in “Waiting” status. Set in minutes.
Max wait severity	The severity for the “waiting requests” alarm.
Aggregate	If checked, generated alarm will report the number of requests breaching a threshold. If not checked, one alarm per request will be sent.
Auto clear	If checked, the alarm will be cleared as soon as the alarm condition is not met anymore.
Alarm tag	This field allows to add custom text within the alarm message. %MSG% variable will contain the actual generated message and can be used such as: “my_prefix %MSG% my_suffix”. By default, tag will be used as prefix.
Alarm	If checked, this line of surveillance will be used for alarm generation.
Metric	If checked, this line of surveillance will be used for metric generation.
Report	If checked, this line of surveillance will used for showing threshold and severity in the daily report

Examples

Active	Output device	User	Max completed w. errors	Comp. w. error sev	Max errors	Error severity	Max wait time (min)	Max wait severity	Aggregate	Auto clear	Alarm tag	Alarm	Metric	Report
true	*	*	10	WARNING	1	MAJOR	10	WARNING	true	true	true	false	false

Effect : Sends WARNING alarm if 10 or more “completed with error” requests are found. Sends Major alarm if one request error if found, and WARNING alarm if some requests are waiting since more than 10 minutes.

Examples

Active	Output device	User	Max completed w. errors	Comp. w. error sev	Max errors	Error severity	Max wait time (min)	Max wait severity	Aggregate	Auto clear	Alarm tag	Alarm	Metric	Report
true	LP123	*	WARNING	1	CRITICAL	5	CRITICAL	true	true	true	false	false

Effect : Sends a CRITICAL alarm if a request sent to printer LP123 has a failed status or requests waiting for more than 5 minutes.

Generated metrics

metricId	metricUnit	metricTarget	metricDescription
SPOOL_REQUEST_ERRORS	Requests	[OUTPUT_DEVICE][USER]	The number of spool requests in error
SPOOL_REQUEST_COMPLETED_WITH_ERRORS	Requests	[OUTPUT_DEVICE][USER]	The number of spool requests completed in error
SPOOL_REQUEST_WAITING	Requests	[OUTPUT_DEVICE][USER]	The number of waiting spool requests
SPOOL_USED_NUMBERS	Percent	[OVERALL]	The spool used number
SPOOL_STATUS_USED_NUMBERS	Percent	[OVERALL]	The spool used number by status
SPOOL_BIG_SPOOL_COUNT	Spool	[THRESHOLD]	The number of spool with a size greater then the threshold