====== Transactional RFC ====== This monitor is dedicated to the monitoring of TRFC. It will watch for the TRFC errors and old entries You can customize the monitoring for a specific direction, destination, function/program or user. ===== Configuration hints ===== Use the surveillance table to adjust the monitoring settings: Thresholds, severity, filters, etc... Unused threshold has to be set to 0. === Surveillance table === ^Parameter^Description^ ^Active|Use this field to activate or deactivate a line of configuration.| ^Period|To limit the period of time in the past (minutes) to look for TRFC entries. Set 0 for checking since the last execution of this monitor.| ^Direction|The direction of the TRFC entries to check.| ^Destination|The destination of the transaction| ^Function/Prog|A filter to match only a given function or program| ^User|A filter to match only a given user or subset of users.| ^status|Defines the status of the TRFC entries to check. If set to SYSFAIL, it will only look for entries with SYSFAIL status.| ^Max entries|Defines the maximum number of entries matching the filters and status.| ^Max Sev.|Defines the severity of the alarm sent if maximum number of entries is reached.| ^Max entry age (hours)|Defines the maximum age of a TRFC entry matching the filters. Specified in hours.| ^Age Sev.|The severity of the too old entries alarm.| ^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^Period^Direction^Destination^Function/Prog^User^status^Max entries^Max Sev.^Max entry age (hours)^Age Sev.^Auto clear^Alarm tag^Alarm^Metric^Report^ |true|15|OUTBOUND|*|*|*|SYSFAIL|10|MAJOR|WARNING|true| |true|false|false|false| **Effect** : Sends a MAJOR alarm if there are 10 or more OUTBOUND TRFC entries with SYSFAIL status in the last 15 minutes === Examples === ^Active^Period^Direction^Destination^Function/Prog^User^status^Max entries^Max Sev.^Max entry age (hours)^Age Sev.^Auto clear^Alarm tag^Alarm^Metric^Report^ |true|15|INBOUND|*|*|*|IN_PROCESS|1|MAJOR|WARNING|true| |true|false|false|false| **Effect** : Sends a WARNING alarm if any INBOUND TRFC entry not beeing in error state is older than one hour in the last 15 minutes === Generated metrics === ^metricId^metricUnit^metricTarget^metricDescription^ |TRFC_IN_ENTRIES|Entries|[STATUS][INSTANCE][FUNC][USER]|The number of INBOUND TRFC entries matching the filter| |TRFC_OUT_ENTRIES|Entries|[STATUS][INSTANCE][FUNC][USER]|The number of OUTBOUND TRFC entries matching the filter|