====== SAP ABAP Real-Time Data Acquisition Monitoring ======
  This monitor supervises ABAP Real-Time Data Acquisition (RDA) errors and failed RDA requests,
  with threshold-based alarms and optional time-series metrics.

===== What Can Be Monitored =====

You can detect and alert on:
  * RDA processing errors
  * Failed RDA requests
  * Error bursts over configurable time windows

This supports proactive detection of blocked or degraded RDA data loading flows.

===== Configuration Hints =====

  * One surveillance row defines one threshold rule and one evaluation window.
  * `Period (min) = 0` means "since last monitor execution".
  * `Max errors = 0` disables alarm checks for that row.
  * **Metric** sends only the "RDA errors" metric (not request-error count).
  * **Prefix** is applied to alarm text and used as alarm tag.
  * **Category** is available in configuration but not used as a filter by current evaluation logic.
  * **Report** is used only when monitor runs in report mode.

===== Configuration =====

==== Monitoring Parameters ====

This monitor has no global monitoring parameter. All settings are defined in the surveillance table.

==== Surveillance Table ====

^ Field ^ Required ^ Default ^ Description ^
| Active | Yes | 'true' | Enables/disables this surveillance row. |
| Category | Yes | `*` | Logical category label for the row. |
| Max errors | Yes | `INFO` | Threshold expression for alarms. Alarm when computed count is greater than or equal to threshold. |
| Severity | Yes | `MAJOR` | Alarm severity used when threshold is breached. |
| Period (min) | Yes | `0` | Evaluation window in minutes. `0` means since last monitor execution. |
| Auto clear | Yes | `true` | Alarms generated by this row are clearable when condition recovers. |
| Prefix | No | (empty) | Optional alarm prefix and alarm tag value. |
| Alarm | No | `true` | Enables/disables alarm generation for this row. |
| Metric | No | `false` | Enables/disables metric emission for RDA error count. |
| Report | No | `false` | Enables report flagging when monitor runs in report mode. |

===== Alarm Conditions =====

For each active surveillance row:
  * **RDA errors alarm**: triggered when `sum(COUNT_FAILS in window) >= Max errors`
  * **RDA request errors alarm**: triggered when `count(requests in error in window) >= Max errors`

Additional behavior:
  * If `Max errors = 0`, alarm checks are skipped for that row.
  * If **Alarm** is disabled, no alarms are generated.
  * Alarm message time window uses `Period (min)` or computed "since last check" duration when period is `0`.

===== Generated Metrics =====

If **Metric** is enabled, the monitor emits:

^ Metric ^ Unit ^ Description ^
| RDA errors count | Errors | Sum of `COUNT_FAILS` from `RSCRT_RDA_ERROR` over the evaluated window. |

===== Generated Alarms =====

Alarm messages include evaluated count and threshold, for example:
  * `X RDA errors in last P min (>=Y)`
  * `X RDA request(s) in error in last P min (>=Y)`

If **Prefix** is set, it is applied to alarm messages.

===== Example =====

^ Active ^ Category ^ Max errors ^ Severity ^ Period (min) ^ Auto clear ^ Prefix ^ Alarm ^ Metric ^ Report ^
| true | `*` | `1` | 4 | 15 | true | `RDA` | true | true | false |
| true | `FIN_*` | `G2W:5` | 3 | 0 | true | `BW,RDA` | true | false | false |