Alert Management

When a KRI breaches its threshold, AIIA generates an alert. Alerts provide real-time notification of risk events and track the investigation and resolution workflow.

How Alerts Work

When a KRI runs and the computed current_value exceeds the threshold_value:

1. An Alert record is created automatically
2. The alert is assigned a severity (High, Medium, Low) based on threshold breach magnitude
3. The alert is visible on the Monitoring Dashboard and in the Alerts list
4. Notifications are sent to the KRI owner and relevant stakeholders

Alert Lifecycle

Alert Fields

Field	Type	Description
id	Integer	Unique identifier
kri_id	Integer	KRI that triggered the alert
severity	String	High, Medium, Low
message	String	Alert description
status	String	OPEN, ACKNOWLEDGED, RESOLVED
owner_id	String	Assigned user
created_at	DateTime	When the alert was triggered
resolved_at	DateTime	When the alert was resolved

Managing Alerts

Viewing Alerts

Navigate to Monitoring → Alerts or view alerts inline on the Monitoring Dashboard. Alerts are displayed with:

• Color-coded severity badges
• KRI name and current value
• Time since alert was raised
• Assignment status

Acknowledging an Alert

1. Click on an alert
2. Click Acknowledge
3. The alert moves from OPEN to ACKNOWLEDGED
4. This signals that someone is investigating

Resolving an Alert

1. Investigate the root cause of the threshold breach
2. Document the investigation findings
3. Take corrective action (if needed)
4. Click Resolve with a resolution note
5. The resolved_at timestamp is set

Assigning Alerts

• Alerts are initially assigned to the KRI owner_id
• Managers can reassign alerts to other team members
• Assignment changes are logged in the audit trail

Alert Notifications

Channel	When
In-app notification	Every new alert
Email	Based on notification preferences
Dashboard widget	Real-time count of open alerts
Executive dashboard	Aggregated alert statistics

Filtering Alerts

Filter	Options
Status	Open, Acknowledged, Resolved
Severity	High, Medium, Low
KRI	Specific KRI
Date Range	Alert creation date
Owner	Assigned user

Permissions

Action	QA/CA	Manager	CAE	Admin
View alerts	✅	✅	✅	✅
Acknowledge alerts	✅	✅	✅	✅
Resolve alerts	✅	✅	✅	✅
Reassign alerts	❌	✅	✅	✅