Pro.Monitor V6.8
- Install Promonitor
Trouble shooting
Monitors Guide
Sidebar
products:promonitor:6.8:monitorsguide:netweaver:spools
Book Creator
Add this page to your book
Add this page to your book Book Creator
Remove this page from your book
Remove this page from your book 
Manage book (
Help Table of Contents
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
| 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 | * | 0 | 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_BIG_SPOOL_COUNT | Spool | [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: 2023/04/05 11:05 by rbariou
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
