User Tools

Site Tools


products:promonitor:6.8:monitorsguide:netweaver:spools

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

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

ParameterDescription
ActiveUse this field to activate or deactivate a line of configuration.
DescriptionRead only field, defines the metric being configured (used number or size)
ThresholdThe threshold of the corresponding metric, expected percent for used number and size in bytes/kilobytes (KB)/ megabytes (MB).
SeverityThe level of severity of the alarm generated by this line of surveillance.
AggregateIf 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 clearIf checked, the alarm will be cleared as soon as the alarm condition is not met anymore.
Alarm tagThis 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.
AlarmIf checked, this line of surveillance will be used for alarm generation.
MetricIf checked, this line of surveillance will be used for metric generation.
ReportIf checked, this line of surveillance will used for showing threshold and severity in the daily report

Examples

ActiveDescriptionThresholdSeverityAggregateAuto clearAlarm tagAlarmMetricReport
trueMax spool number utilization (%)30MAJORtruetrue truefalsefalse

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

ActiveDescriptionThresholdSeverityAggregateAuto clearAlarm tagAlarmMetricReport
trueMax spool size (MB)50WARNINGfalsetrue truefalsefalse

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

Spool requests monitoring:

ParameterDescription
ActiveUse this field to activate or deactivate a line of configuration.
Output deviceA filter to match a subset of printers. Use * to match all.
UserA filter to match only a subset of users. Use * to match all
Max completed w. errorsThe threshold for the maximum number of requests with “Completed with error” status.
Comp. w. error sevThe severity for the “max completed with error” alarm.
Max errorsThe threshold for the maximum number of requests with “error” status.
Error severityThe 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 severityThe severity for the “waiting requests” alarm.
AggregateIf checked, generated alarm will report the number of requests breaching a threshold. If not checked, one alarm per request will be sent.
Auto clearIf checked, the alarm will be cleared as soon as the alarm condition is not met anymore.
Alarm tagThis 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.
AlarmIf checked, this line of surveillance will be used for alarm generation.
MetricIf checked, this line of surveillance will be used for metric generation.
ReportIf checked, this line of surveillance will used for showing threshold and severity in the daily report

Examples

ActiveOutput deviceUserMax completed w. errorsComp. w. error sevMax errorsError severityMax wait time (min)Max wait severityAggregateAuto clearAlarm tagAlarmMetricReport
true**10WARNING1MAJOR10WARNINGtruetrue truefalsefalse

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

ActiveOutput deviceUserMax completed w. errorsComp. w. error sevMax errorsError severityMax wait time (min)Max wait severityAggregateAuto clearAlarm tagAlarmMetricReport
trueLP123*0WARNING1CRITICAL5CRITICALtruetrue truefalsefalse

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

metricIdmetricUnitmetricTargetmetricDescription
SPOOL_REQUEST_ERRORSRequests[OUTPUT_DEVICE][USER]The number of spool requests in error
SPOOL_REQUEST_COMPLETED_WITH_ERRORSRequests[OUTPUT_DEVICE][USER]The number of spool requests completed in error
SPOOL_REQUEST_WAITINGRequests[OUTPUT_DEVICE][USER]The number of waiting spool requests
SPOOL_USED_NUMBERSPercent[OVERALL]The spool used number
SPOOL_BIG_SPOOL_COUNTSpool[THRESHOLD]The number of spool with a size greater then the threshold
/home/clients/8c48b436badcd3a0bdaaba8c59a54bf1/wiki-web/data/pages/products/promonitor/6.8/monitorsguide/netweaver/spools.txt · Last modified: 2024/05/01 18:35 (external edit)