Products documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
==== SAPconnect (SCOT/SOST) ====

=== Purpose ===
SAPConnect handles message sending from SAP via different media like FAX, EMAIL and PAGING. Message sending can be very important for some processes and must be monitored accordingly. This monitor will watch for messages with ERROR or WAITING status and notify when problems are found.
=== Configuration hints ===

Start by creating a new rule in the table and set the available filters: 
- Client 
- Message type 
- Node 
- Receiver 
- Subject 
You can use regular expressions.


**Period** 
Use the period field to define how deep in the past we will look for messages


**Status** 
It gives the possibility to watch for ERROR or WAITING states of messages
=== Surveillance table ===

^Parameter^Description^
^Active|Use this field to activate or deactivate a line of configuration.|
^Status|Defines if the monitor will look for ERROR or WAITING states.|
^Client|A filter to match only a subset of clients.|
^Message type|INT for email, PAGE for paging messages and FAX for facsimile.|
^Node|A filter to match only a given node or subset of nodes.|
^Receiver|A filter to match only a given receiver or subset of receivers.|
^Subject|A filter to match only a given message subject.|
^Period (min)|Defines how far in the past we look for messages. If set to 15, it will look for the messages generated in the last 15 minutes.|
^Threshold|The maximum number of messages matching the status and filters.|
^Aggregate|If checked, the results will be aggregated by medium type and then compared to threshold. If not checked, the threshold will be compared to the messages matching the filter.|
^Severity|The level of severity of the alarm generated by this line of surveillance.|
^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||
=== Examples ===
 
^Active^Status^Client^Message type^Node^Receiver^Subject^Period (min)^Threshold^Aggregate^Severity^Auto clear^Alarm tag^Alarm^Metric^
|true|ERROR STATES|*|*|*|*|*|15|1|false|MAJOR|true| |true|false|

**Effect** : Sends one MAJOR alarm per type of message having 1 or more error status in the last 15 minutes
=== Examples ===
 
^Active^Status^Client^Message type^Node^Receiver^Subject^Period (min)^Threshold^Aggregate^Severity^Auto clear^Alarm tag^Alarm^Metric^
|true|WAITING STATES|800|INT|*|jdoe|*|15|10|false|WARNING|true| |true|false|

**Effect** : Sends a WARNING alarm if 10 or more emails addressed to jdoe are in waiting state on client 800, since the last 15 minutes.
=== Generated metrics ===
 
^metricId^metricUnit^metricTarget^metricDescription^
|MESSAGE_TRANSFER_ERROR|Error messages|[CLIENT][TYPE][NODE][RECEIVER][SUBJECT]|Sends the number of messages with error state|
|MESSAGE_TRANSFER_ERROR|Error messages|[CLIENT][TYPE][NODE][RECEIVER][SUBJECT]|Sends the number of messages with waiting state|