Troubleshooting — Monitoring

KRI shows "No Data"

• Check that the query_definition is valid SQL/logic
• Verify the data source exists and has records
• Test the query in the KRI Playground preview
• Ensure the KRI is in PUBLISHED status and is_active = true

KRI isn't running on schedule

• Check is_active is true
• Verify frequency or cron_expression is correctly set
• Check next_run_at to see when it's scheduled
• Ensure the background worker service is running

Alerts not being generated

Check	Solution
KRI has threshold?	Set threshold_value on the KRI
KRI is published?	Only PUBLISHED KRIs generate alerts
Value exceeds threshold?	Review current_value vs threshold_value
Worker running?	Check the monitoring worker service logs

AI KRI Wizard generates invalid queries

1. Be more specific in your natural language description
2. Specify the data source explicitly
3. Check that the AI model is properly configured
4. Review and edit the generated query before saving

Alert notifications not arriving

1. Check Administration → Notifications — ensure monitoring alerts are enabled
2. Verify email/notification settings for the KRI owner
3. Check the notification service logs
4. Ensure the user has correct email configured

Dashboard metrics show stale data

• Check computed_at on the DashboardMetric — it shows when last calculated
• Metrics are computed by background jobs — check the job schedule
• Click Refresh on the dashboard to trigger an immediate recalculation

Related

• KRI Playground — test and debug KRI queries
• Alert Management — manage alerts
• FAQ