UK KPI Alerting & Thresho
Watch any Odoo metric and alert on threshold or trend via email or BYOK webhook
Numbers drift quietly: a conversion rate slips, stock value creeps up, overdue invoices pile on, and nobody notices until month-end when it is expensive to fix. This module lets operations, finance and management teams watch any metric in their Odoo database (any model, domain and aggregate) and alert the instant it crosses a threshold or trends the wrong way. Notifications go by email or by posting a JSON payload to a webhook you own, so Slack or Teams integration is BYOK with no bundled external service. Readings are stored for history, alerts de-duplicate while a breach persists, and dashboards roll KPIs into a health score with scheduled digest emails.
Key Features
Watch any model with an aggregate
kpi.definition points at any ir.model with a filter domain and an aggregate: count, or sum/avg/min/max of a chosen numeric field. compute_value runs the aggregate against live data via sudo search, and a display unit (GBP, %, orders) labels the reading.
Threshold and trend rules
The operator field supports greater/less/equal comparisons against the threshold, plus pct_up and pct_down trend rules. _is_breach computes the percentage change versus the last reading, so you catch both hard limits and sudden movements in one definition.
Stored measurement history
Every evaluation writes a kpi.measurement with the value and previous_value; _compute_delta derives the absolute delta and delta_pct against the prior reading. The full series builds a chartable history so you can see how a metric moves over time.
Email and BYOK webhook alerts
When a rule trips, kpi.alert.dispatch notifies via mail.thread to the recipient_ids and, when notify_webhook is on, POSTs the webhook_payload JSON to your own webhook_url (Slack, Teams or any endpoint). No external service is bundled; you bring the URL and stay in control of where alerts go.
De-duplicated breach lifecycle
evaluate raises an alert only on a new breach and sets in_breach, so you are not spammed while a breach persists; when the value recovers it clears in_breach and posts a recovery note. Alerts move through new, notified, acknowledged and failed states with action_acknowledge and action_retry.
Scheduled hands-free evaluation
cron_evaluate_all measures every active KPI on the cadence you set in the cron, recording readings and firing alerts unattended. action_evaluate_now lets you trigger an on-demand evaluation of selected KPIs at any time.
Dashboards with health score
kpi.dashboard groups several KPIs and _compute_health derives a health_score (share not in breach) and a green/amber/red health_band. action_evaluate_all refreshes every member KPI, giving leadership a single rolled-up view of metric health.
Leadership digest emails
build_digest_text composes a plain-text summary of each KPI's value and breach status, and action_send_digest posts it to the digest_recipient_ids. cron_send_digests evaluates the board and sends the digest on schedule for a daily health update.
Use Cases
Screenshots
Alerts
Dashboards
Kpis
Measurements
Why Choose This Module
Numbers drift. A conversion rate slips, stock value creeps up, overdue invoices pile on — and nobody notices until month-end. This module lets you watch any metric in your Odoo database and alert your team the instant it crosses a threshold or trends the wrong way, by email or by posting to a webhook you own. No external service is bundled — bring your own webhook URL and stay in control.
Specifications
- Compatible: Odoo 18.0 / 19.0
- License: OPL-1
- Languages: English
- Author: Pokutsoft
- Dependencies: base, mail
- Support: support@pokutsoft.com
Update date: 2026-07-02