# Alerts

> psLens real-time alerts for PeopleSoft: monitor long-running processes, process errors, stalled Integration Broker messages, failed logins, and more.

---

LLMS index: [llms.txt](/llms.txt)

---

## Alerts

Alert checks run on a 5-minute timer against every connected database. Findings appear on the dashboard with severity, and clear automatically when the underlying condition resolves. There is no acknowledge or dismiss.

## How the Alert System Works

1. psLens runs a set of alert checks on a timer (default: every 5 minutes)
2. Each check queries one or more connected databases
3. If a check finds something worth noting, it creates alert items with a severity level
4. Alert results appear on the dashboard immediately
5. When the underlying issue resolves, the alert clears automatically on the next check cycle

Alerts always reflect the current state of the system.

## Alert Severity Levels

| Severity | Color  |                          Meaning                           |
| -------- | ------ | ---------------------------------------------------------- |
| Critical | Red    | Something is actively wrong and needs immediate attention  |
| Warning  | Yellow | Something should be investigated. It may become a problem. |
| Info     | Blue   | Low-priority finding; worth noting but not urgent          |

## Alert Data Retention

Alert results are stored for **15 minutes**. This means the dashboard shows findings from the most recent check cycle. Once an issue is resolved and the next check runs cleanly, the alert data expires.

## Configuring Alerts

Alerts are configured in `config.yaml`. You can:

- Enable or disable the entire alert system (`alerts.enabled`)
- Set how often checks run (`alerts.intervalMinutes`)
- Enable or disable individual checks
- Set thresholds for stalled/long-running checks
- Set lookback windows for error checks
- Exclude specific process names or IB operation names from checks

See [Configuration](/docs/getting-started/configuration/) for the full configuration reference.

---

## Alert Categories

Browse alerts by category:

- [Process Scheduler](/docs/alerts/process-scheduler/): Long-running processes, errors, backlogged jobs, locked operators, critical process monitoring
- [Integration Broker](/docs/alerts/integration-broker/): Operation errors, contract errors, stalled messages, volume anomalies, sync exceptions
- [Web Server / WebLib](/docs/alerts/weblib-down/): Alerts when the PeopleSoft Web Server or WebLib endpoints fail to respond
- [Security](/docs/alerts/security/): Failed login detection and authentication monitoring
- [Generic SWS Alerts](/docs/alerts/generic-alerts/): Define custom, queryable alert rules using PsoftQL against any whitelisted tables

---

Section pages:

- [Process Scheduler](/docs/alerts/process-scheduler/): Process Scheduler alerts: long-running processes, process errors, backlogged processes, locked operators, and critical process monitoring.
- [Integration Broker](/docs/alerts/integration-broker/): Integration Broker alerts: operation errors, contract errors, stalled messages, abnormal volume detection, and sync exceptions.
- [Security](/docs/alerts/security/): Security alerts: failed login detection and authentication monitoring.
- [Web Server / WebLib Down](/docs/alerts/weblib-down/)
- [Generic SWS Alerts](/docs/alerts/generic-alerts/)